O Que São Automações (Flows)
As automações do Adonix são fluxos visuais — um editor estilo arrastar-e-soltar onde você desenha o caminho que cada conversa vai percorrer. Em vez de regras simples ("se X, faça Y"), você monta diagramas com nodes (caixas) ligadas por setas, e cada node faz uma coisa específica: enviar mensagem, esperar resposta, classificar intenção com IA, transferir pra fila, atualizar contato, chamar uma API, etc.
Conceito básico
Um fluxo é formado por:
- Ativador — o evento que dispara o fluxo (mensagem recebida, conversa iniciada, agendamento, etc.)
- Nodes — as caixas que executam cada passo (enviar mensagem, condicional, esperar resposta, IA, ação)
- Conexões — as setas que ligam um node ao próximo, criando o caminho da execução
Cada node tem suas próprias configurações que aparecem no painel direito quando você clica nele.
Onde acessar
- Na barra lateral, clique em Automações (ícone de raio).
- Você verá a lista de fluxos do workspace, com colunas de nome, ativador, status (publicado/rascunho), última execução e ações.
- Para criar um novo, clique em Novo Fluxo.
- Para editar um existente, clique no nome do fluxo.
A paleta de nodes
O editor tem 5 categorias de nodes na barra lateral esquerda:
🔵 Ativadores
São os eventos que iniciam o fluxo. Cada fluxo precisa começar com um ativador.
| Ativador | Quando dispara |
|---|---|
| Mensagem Recebida | Toda vez que o cliente envia uma mensagem nova |
| Conversa Iniciada | Primeira mensagem de uma conversa nova |
| Conversa Reaberta | Quando uma conversa resolvida volta a ser aberta |
| Conversa Encerrada | Quando o agente marca a conversa como resolvida |
| Conversa Atribuída | Quando um agente assume ou recebe a conversa |
| Conversa Transferida | Quando a conversa muda de fila ou agente |
| Agendamento (Cron) | Em horários programados (ex: todo dia às 9h) |
| Webhook | Quando uma URL externa chama o webhook do fluxo |
| Manual | Disparado manualmente por um agente |
🟡 Fluxo
Controlam o caminho da execução.
| Node | O que faz |
|---|---|
| IF (Condição) | Bifurca em "verdadeiro" ou "falso" baseado em uma expressão |
| Switch (Roteador) | Múltiplas saídas baseadas no valor de uma variável |
| Filtro | Para o fluxo se uma condição não for atendida |
| Aguardar (Delay) | Espera X segundos/minutos/horas antes de continuar |
| Aguardar Resposta | Pausa o fluxo até o cliente responder (com timeout configurável) |
| Fim | Encerra o fluxo explicitamente |
💬 Mensagens
Enviam ou capturam mensagens.
| Node | O que faz |
|---|---|
| Enviar Mensagem | Envia texto, mídia ou template para o cliente |
| Enviar Menu (Lista) | Envia uma lista interativa do WhatsApp com seções e opções |
| Capturar Input | Solicita um dado específico (nome, e-mail, CPF) e salva em variável |
🟣 Ações
Agem na conversa, contato ou sistemas externos.
| Node | O que faz |
|---|---|
| Atribuir Agente | Atribui a conversa a um agente específico |
| Transferir Fila | Move a conversa para outra fila |
| Mudar Status | Marca a conversa como resolvida, pendente, etc. |
| Adicionar / Remover Etiquetas | Marca a conversa com tags |
| Atualizar Contato | Edita campos do contato (nome, e-mail, custom fields) |
| Nota Interna | Adiciona uma nota visível só para a equipe |
| Definir Variável | Salva um valor para usar nos próximos nodes |
| Requisição HTTP | Chama uma API externa (GET/POST/PUT/DELETE) e usa a resposta |
🤖 Inteligência Artificial
Nodes que usam o Albert IA dentro do fluxo.
| Node | O que faz |
|---|---|
| Agente IA | Conversa com o cliente usando IA, com instruções e ferramentas configuráveis |
| Classificar Intenção | Lê a mensagem do cliente e roteia pra saída correspondente (ex: "vendas", "suporte", "boleto") |
Variáveis e expressões
Os fluxos têm um sistema de variáveis que você pode usar em qualquer campo de texto:
{{contact.name}}— nome do contato{{contact.phone}}— telefone{{contact.customFields.cpf}}— campo personalizado{{conversation.id}}— ID da conversa atual{{vars.minha_variavel}}— variáveis criadas no fluxo (com Definir Variável ou Capturar Input){{response.body.email}}— resposta de uma Requisição HTTP
Ao digitar {{ em qualquer campo, abre um autocomplete inline mostrando todas as variáveis disponíveis com valores de exemplo — você não precisa decorar a sintaxe.
ExpressionField Esse autocomplete é o ExpressionField. Ele aparece sempre que o campo aceita variáveis. Mostra também o tipo (texto, número, lista) e um exemplo do valor real, baseado em mensagens recentes do workspace.
Validação e publicação
Antes de salvar um fluxo, o sistema valida automaticamente:
- Todos os nodes têm pelo menos uma conexão de entrada (exceto Ativador).
- Não há nodes desconectados (orphan).
- Campos obrigatórios estão preenchidos.
- Variáveis referenciadas existem.
Se houver erro, o fluxo fica em rascunho — não dispara em produção. Quando estiver tudo OK, clique em Publicar e o fluxo passa a rodar nos eventos configurados.
Automações vs. Albert IA — qual usar?
| Caso | Use |
|---|---|
| Resposta sempre igual (mensagem de boas-vindas, horário) | Fluxo com node "Enviar Mensagem" |
| Roteamento por palavra-chave ("vendas", "suporte") | Fluxo com "Switch" ou "Classificar Intenção" |
| Conversa contextual com memória | Fluxo com node "Agente IA" |
| Sugestão de resposta para o agente humano | Albert IA inline (botão dentro da conversa) |
| Análise de sentimento, resumo de longa conversa | Albert IA (recursos avulsos) |
Os dois trabalham bem juntos: o fluxo cuida do roteamento e estrutura, e o Albert IA entra para conversa livre e análise.
No próximo guia, você vai aprender a criar seu primeiro fluxo passo a passo.