Automacoes — visao geral
O que sao as automacoes do UltronChat, quando acionam, e como elas se combinam com o agente de IA para responder comentarios e coletar leads.
Automacoes sao regras deterministicas que acionam em resposta a eventos na sua rede social — como um comentario em post, uma mencao em story, ou uma DM recebida. Diferente do agente de IA (que gera texto em linguagem natural), as automacoes sao baseadas em palavras-chave e executam acoes pre-definidas.
O que uma automacao pode fazer
Quando o gatilho bate:
- Responder o comentario publicamente — com uma das 1 a 3 variacoes de texto que voce definir.
- Enviar DM privada — texto + link opcional para o usuario que comentou.
- Iniciar coleta de lead — peca email, telefone e follow antes de entregar o link.
Voce pode ativar qualquer combinacao das tres.
Quando uma automacao aciona
A automacao e avaliada sempre que chega um dos eventos:
- Comentario em post — Instagram ou Facebook.
- Mencao em story — Instagram.
- Resposta a story — Instagram.
- DM recebida (se
trigger_sourceincluirdm) — Instagram, Messenger ou WhatsApp.
O UltronChat:
- Normaliza o texto (lowercase, remove acentos).
- Procura automacoes ativas da conexao que tem o tipo de gatilho configurado.
- Filtra por escopo (apply to all posts vs post especifico, apply to all stories, etc.).
- Faz match das palavras-chave (exact ou contains) e verifica negative keywords.
- Se houve match: cria um
automation_logcom statuspendinge enfileira a acao. - Se a automacao tem coleta de lead: delega para
lead-collector. Senao: envia viamessaging-service.
Deduplicacao
O UltronChat mantem um UNIQUE(automation_id, platform_comment_id) — se o mesmo comentario dispara a mesma automacao duas vezes (por webhook duplicado), so a primeira execucao e registrada. Evita enviar DM repetida.
Status de uma execucao
Em automation_logs cada tentativa tem um status:
| Status | Significado |
|---|---|
pending | Enfileirada, aguardando processamento |
processing | Em execucao |
success | DM enviada + comentario respondido (se configurado) |
partial | Parte deu certo (ex.: DM enviada mas comentario falhou) |
collecting | Coleta de lead iniciada, aguardando resposta do usuario |
failed | Algo deu errado (token, HMAC, janela expirada, etc.) |
Hoje os logs sao acessiveis via banco/suporte; visualizacao na UI vai aparecer em releases futuras.
Automacoes vs agente de IA — fluxo combinado
Cenario tipico:
- Usuario comenta "ebook" no post.
- Automacao aciona: responde comentario com "Te enviei no direct! 💌" e envia DM "Aqui esta o link: ...".
- Usuario responde a DM com "qual o preco do curso depois do ebook?".
- Nao ha automacao que cubra essa pergunta, entao o agente de IA assume e responde com base no system instruction.
Voce nao precisa escolher entre os dois — use ambos.
Onde gerenciar
- Lista:
/dashboard/[connectionId]/automations - Criar:
/dashboard/[connectionId]/automations/new - Editar:
/dashboard/[connectionId]/automations/[id]
Screenshot: lista de automacoes em
/dashboard/[connectionId]/automations.