Criar e configurar uma automatização

Criar e configurar uma automatização

Esta seção explica como criar uma automatização do zero: definir parâmetros de entrada, configurar os passos e publicá-la para que fique pronta para ser executada.


Gear Criar uma automatização

As automatizações são criadas na janela de Automatizações. Ao clicar em +, abre-se o editor onde você poderá configurar:
  • Nome: um nome descritivo para identificá-la.
  • Descrição: um breve texto com as ações ou objetos que serão gerados.


Wrench Parâmetros de entrada

Cada automatização pode definir parâmetros de entrada — os dados de que precisa para funcionar (por exemplo: um site, uma tarefa, um texto, uma data).
Ao conectá-la a um disparador ou botão, configura-se de onde vêm os valores desses parâmetros naquele contexto. Uma automatização só pode ser conectada se todos os seus parâmetros obrigatórios puderem ser fornecidos. Se algum ficar sem atribuição, o sistema exibirá um aviso.
Também é possível criar automatizações sem parâmetros, para fluxos que não precisam de dados de entrada.
Tipos de parâmetros disponíveis:
Categoria
Tipos
Texto e números
Texto, Número, Booleano (sim/não)
Datas
Data, Data e hora, Hora
Estruturas
JSON, Lista, Arquivo
Projetos
Tarefa, Projeto, Subprojeto, Workflow, Modelo de tarefa
Formulários
Formulário, Modelo de formulário
Geo / Sites
Site, Elemento de rede, Conteúdo de elemento de rede, Solicitação de acesso ao site
Empresas
Cliente, Fornecedor, Unidade operacional
Contabilidade
Cotação, Item de cotação
Estoque
Operação de materiais, Item de operação
Engenharia
Formulário de engenharia, Engenharia, Modelo de engenharia
Pessoas
Usuário, Perfil, Pessoal (staff), Contato
Outros
Campo personalizado, Atributo, Estado, Marco, País


Memo Configuração de passos

Os passos são as operações que se executam em cadeia depois que a automatização é iniciada. Cada passo tem:
  • Ação: qual operação vai realizar (criar um objeto, buscar, atualizar, enviar e-mail, etc.)
  • Nome personalizado (opcional): um nome que ajuda a identificar o que esse passo faz no fluxo.
  • Valores de entrada: os dados de que a ação precisa para ser executada.
Os passos são executados em ordem sequencial. Cada passo pode usar como entrada:
  • Os parâmetros de entrada da automatização
  • Os resultados de passos anteriores (por exemplo, o ID de um objeto criado em um passo anterior)


Bullseye Valores de entrada dos passos

Cada campo de um passo pode receber seu valor de diferentes formas:
Tipo de valor
Descrição
Valor constante
Um valor fixo definido na configuração (ex: sempre atribuir o estado "Em andamento")
Campo do objeto
Um dado do objeto que acionou o disparador (ex: o site da tarefa)
Contexto do disparador
Dados adicionais disponíveis no contexto de execução
Valor condicional
Um valor que depende de uma condição (ex: se o estado é X, usar valor A; caso contrário, valor B)
Erro do passo principal
A mensagem de erro do passo que falhou (disponível apenas em passos de contingência)

Valores condicionais

Permitem definir lógica if/then para os campos. Os operadores disponíveis são:
Operador
Descrição
Igual a
O valor é exatamente igual
Diferente de
O valor é diferente
Maior que
O valor é maior
Menor que
O valor é menor
Maior ou igual
O valor é maior ou igual
Menor ou igual
O valor é menor ou igual
Está contido em
O valor está dentro de uma lista
Contém
O valor contém outro valor


Clipboard Ações disponíveis

As ações organizam-se em categorias. A seguir, a lista completa:

Magnifying Glass Tilted Left Buscar objetos

Permitem buscar objetos existentes para usá-los em passos posteriores.
  • Buscar cliente
  • Buscar fornecedor
  • Buscar projeto
  • Buscar workflow
  • Buscar tarefa em workflow
  • Buscar e atualizar tarefas em workflow
  • Buscar formulário
  • Buscar formulários irmãos
  • Buscar site
  • Buscar elemento de rede
  • Buscar conteúdos de elemento de rede
  • Buscar atributo
  • Buscar usuários por perfil
  • Buscar operação de materiais
  • Buscar cotação
  • Buscar referência de integração
  • Buscar documento de referência (arquivo, formulário, workflow, engenharia, cotação, solicitação de acesso ao site)
  • Buscar resposta de campo personalizado (em tarefa, workflow, elemento de rede, site, cliente)
  • Buscar membro de solicitação de acesso ao site

Pencil Atualizar objetos

Permitem modificar objetos existentes.
  • Atualizar tarefa
  • Atualizar formulário
  • Atualizar conteúdo de formulário
  • Atualizar workflow (estado)
  • Atualizar site
  • Atualizar elemento de rede
  • Atualizar cliente
  • Atualizar formulário de engenharia
  • Atualizar cotação
  • Atualizar operação de materiais
  • Atualizar resposta de campo personalizado (em tarefa, workflow, site, elemento de rede, cotação, cliente)
  • Atualizar documento de referência (arquivo, formulário, workflow, engenharia, cotação)

Plus Criar objetos

Permitem criar novos objetos no sistema.
  • Criar tarefa
  • Criar formulário
  • Criar workflow
  • Criar projeto
  • Criar site
  • Criar elemento de rede
  • Criar cliente
  • Criar campo personalizado em tarefa
  • Criar item de cotação
  • Criar operação de materiais
  • Criar item de operação de materiais
  • Clonar itens de operação
  • Criar referência de integração
  • Criar documento de tarefa (formulário)
  • Criar documento de tarefa (workflow)

Envelope with Arrow Enviar

  • Enviar e-mail: envia um e-mail com destinatário, assunto, contexto e destinatários adicionais.

Robot Inteligência Artificial

  • Agente de IA: executa um prompt personalizado com contexto de entrada e retorna dados estruturados conforme um esquema definido.
  • Revisar estoque de site com IA: analisa fotos de formulários de site para revisar o equipamento.
  • Analisar entrada com IA: analisa uma entrada de formulário usando IA.

Link Integrações

  • Requisição HTTP: realiza uma chamada HTTP (GET/POST/PATCH/PUT) a um serviço externo com headers, body, credenciais e timeout configurável.
  • Executar script Python: executa código Python com variáveis de contexto e retorna resultados estruturados. Suporta saída de arquivos.
  • Webhook: envia dados a um endpoint remoto configurado, com suporte a objetos de contexto e notificação de erros por e-mail.

Shuffle Tracks Button Controle de fluxo

  • Executar outra automatização: executa uma automatização standalone como subpasso, passando parâmetros dinamicamente.
  • Parar automatização: interrompe a execução se uma condição for atendida (útil para validações prévias).
  • Resposta HTTP: retorna uma resposta HTTP personalizada (apenas para automatizações executadas via API). Permite definir status code (200, 201, 204, 400-500) e body JSON.


Outbox Tray Publicar e ativar

As automatizações têm um ciclo de vida de rascunho → publicação:
    Rascunho: ao criar ou modificar uma automatização, as alterações ficam em estado de rascunho. Você pode editar livremente sem afetar a versão ativa.
    Publicar: ao publicar, é gerado um snapshot (versão congelada) da configuração. Essa é a versão que se executa.
    Descartar rascunho: se você fez alterações que não quer manter, pode descartar o rascunho e voltar à última versão publicada.
Importante: Uma automatização não pode ser ativada se tiver parâmetros sem atribuição em seus disparadores ou ações. O sistema exibe um aviso nesses casos.