Criar e configurar uma automação

Criar e configurar uma automação

Uma automação é um fluxo reutilizável que executa uma série de passos em cadeia. É criada uma única vez e pode ser conectada a múltiplos eventos, botões ou chamadas API.

Criar uma nova automação

Na janela de Automações, clique em + para criar uma nova. Você precisará preencher:
  • Nome: um nome descritivo que identifique o fluxo.
  • Descrição: um breve texto explicando o que a automação faz.

Configurar parâmetros de entrada

Os parâmetros de entrada definem quais dados a automação precisa para funcionar. Por exemplo, se sua automação altera o status de uma tarefa, precisa receber como parâmetro a tarefa sobre a qual operar.
Há duas opções:
  • Sem parâmetros: a automação é autocontida e não precisa de dados externos.
  • Com parâmetros: definem-se um ou mais parâmetros, cada um com nome e tipo.
Tipos de parâmetros disponíveis:
Categoria
Tipos
Primitivos
texto, número, booleano, data, hora, JSON, lista
Entidades
site, tarefa, formulário, projeto, cliente, fornecedor, workflow, elemento de rede, usuário, entre outros
Arquivos
arquivo, arquivo de resposta
Os parâmetros são configurados no painel direito do editor de automação, na seção Input.

Configurar passos (ações)

Os passos são as operações executadas em cadeia. Cada passo tem uma ação e campos de entrada que são preenchidos com valores provenientes de:
  • Valor constante: um valor fixo definido ao configurar o passo.
  • Parâmetro de entrada: dados recebidos pela automação (ex: Input → site → nome).
  • Resultado de um passo anterior: dados gerados por um passo prévio (ex: Passo 1 | Criar tarefa → id).
  • Contexto do trigger: quando disparada a partir de um evento, dados do objeto que o originou (ex: Trigger → tarefa → status).
  • Usuário executor: dados do usuário que disparou a automação.
Ações disponíveis — Os passos se agrupam em três categorias:
Buscar objetos (para usar em passos posteriores): cliente, workflow, tarefa em workflow, projeto, documento de referência (arquivo, formulário, engenharia, workflow, solicitação de acesso), resposta de campo personalizado (elemento de rede, workflow, tarefa), membro de solicitação de acesso, referência de integração.
Atualizar objetos: tarefa, formulário, site, elemento de rede, cliente, workflow (status), documento de referência, formulário de engenharia, resposta de campo personalizado (orçamento, elemento de rede, site, tarefa, workflow).
Criar objetos: tarefa, formulário, workflow, site, elemento de rede, cliente, projeto, referência de integração, documento de tarefa de formulário.
Outras ações: enviar email, executar outra automação, resposta HTTP, entre outras.

Rascunho e publicação

As automações possuem um sistema de rascunho (draft). Você pode editar uma automação sem afetar a versão em produção. Quando estiver satisfeito com as alterações, publique o rascunho e a nova versão substituirá a anterior.
Isso permite testar mudanças com tranquilidade antes de aplicá-las.

Ativar e desativar

Cada automação pode estar ativa ou inativa. Uma automação inativa não é executada, mas mantém sua configuração intacta para quando for necessária novamente.