Como usar eventos de conversão pra disparar automações
Nível: Intermediário Tempo de leitura: 5 min Plano necessário: Pro ou Ultra
A conexão entre agente e automação
Seus agentes de IA já podem emitir eventos de conversão durante uma conversa (ex: lead_qualificado, agendou_demo, comprou). Esses eventos servem pra você medir performance e, agora, também servem pra entrar ou sair de automações.
A combinação é poderosa: o agente conversa com o cliente, detecta o momento certo, dispara o evento, e a automação certa começa a rodar em background.
Configurando o evento no agente
Antes de usar como gatilho, o evento precisa existir no seu agente:
- Acesse o agente em Agentes
- Aba Inteligência > seção Eventos de conversão
- Adicione um evento: nome (ex:
lead_qualificado) e descrição (ex: "Quando o cliente confirma que tem orçamento e prazo definidos") - O agente passa a observar a conversa e emite o evento no momento adequado
Use nomes curtos, em snake_case (sem espaço, sem acento, minúsculo). Eles aparecem em vários lugares do produto.
Configurando o gatilho de evento na automação
- No editor da automação, clique no nó Gatilho
- Ative Evento de conversão
- No campo que aparece, liste os nomes dos eventos separados por vírgula:
lead_qualificado, agendou_demo
Quando QUALQUER um desses eventos for detectado em uma conversa, o contato entra no fluxo automaticamente. Os metadados do evento (se houver) ficam disponíveis como variáveis nas mensagens.
Quando o gatilho dispara
Disparou quando:
- A conversa tem
phonedo contato (chat público sem identificação não aciona) - A organização do agente bate com a organização do fluxo
- O contato não está em opt-out
- Não há run ativa do mesmo fluxo pro mesmo phone (anti re-entrada, salvo se cooldown configurado)
Se o disparo for bloqueado, fica registrado no log da edge function mas o usuário não vê erro (best-effort, não bloqueia o agente).
Caso de uso clássico: lead qualificado
Cenário: seu agente comercial conversa com leads via WhatsApp. Quando o lead confirma que tem interesse + orçamento + decisão pra comprar, o agente emite lead_qualificado.
Automação: dispara fluxo "Onboarding pré-venda":
- Imediato: agradecimento + link pra agendar call (template)
- 4 horas depois: lembrete pra agendar
- 1 dia depois: case de sucesso de cliente parecido
- 3 dias depois: oferta de proposta personalizada
Se em qualquer momento o lead responder (sair se responder = sim), volta pro fluxo manual com o atendente.
Usando eventos pra SAIR de um fluxo
O mesmo evento que dispara pode também servir pra parar OUTRO fluxo. Caso clássico de carrinho abandonado:
- Trigger por webhook do e-commerce quando carrinho fica parado por 30 min
- 3 mensagens em sequência tentando recuperar
- Saída global por evento:
comprou
Se o cliente finalmente comprar, o agente emite comprou, a automação cancela na hora e não manda mais mensagens.
Configure em "Saídas globais" > "Sair em evento específico".
Cuidado com loops
Evite usar o mesmo evento pra entrar E sair do mesmo fluxo. Exemplo do que NÃO fazer:
- Fluxo "Recuperação de inativos"
- Trigger: evento
lead_voltou_a_responder - Saída: evento
lead_voltou_a_responder
Nesse caso, o lead entra e sai no mesmo segundo. Mais útil é usar eventos diferentes pra entrada e saída.
Diferença entre trigger e saída
| Trigger | Saída | |
|---|---|---|
| Quando aciona | Cria nova run pro contato | Marca run ativa como "exited" |
| Configurado em | Nó Gatilho > "Evento de conversão" | Saídas globais > "Sair em evento específico" |
| Limite | Pode ser bloqueado por cooldown / opt-out | Sempre tem efeito |
| Caso de uso | Iniciar fluxo automaticamente | Cancelar fluxo quando objetivo foi atingido |
Quando usar evento vs segmentação como gatilho
Evento de conversão dispara em segundos, na hora que o agente detecta. É o gatilho mais rápido da Wevi. Use quando o tempo é crítico (lead acabou de pedir orçamento, cliente abandonou carrinho, etc).
Segmentação como gatilho cobre tudo que depende de critérios combinados (ex: "tem tag X E é do DDD 11 E nunca recebeu campanha Y"). Latência típica de 30 segundos no caminho rápido, 15 minutos pra critérios temporais. Use quando o gatilho é uma combinação de atributos do contato, não um momento específico da conversa.
Os dois podem coexistir no mesmo fluxo.
Veja também: Segmentação de contatos.
Eventos em conversas tocadas por um atendente humano
Por padrão, eventos de conversão só são emitidos quando o agente de IA está respondendo. Quando um atendente humano assume a conversa, o agente para de rodar, e nenhum evento é detectado.
Para capturar eventos mesmo durante o atendimento humano, use o Agente Observador. Ele fica de olho na conversa em paralelo e dispara os eventos pelas regras que você definiu, sem interferir no atendimento.