Integrações: automações, eventos e webhooks de follow-up

Abrir em

Ver como Markdown

Abrir no ChatGPT Abrir no Claude

Conversa Labs

Última atualização em Jul 19, 2026

Visão geral

Follow-ups não vivem isolados: eles se conectam nativamente ao resto da plataforma. Uma cadência pode ser iniciada, pausada, retomada, pulada ou cancelada por uma regra de Automação, por uma Macro que o agente roda na conversa ou por um nó do Flow Builder. À medida que a cadência avança, a plataforma emite eventos que disparam outras automações e são entregues aos seus webhooks de integração. E, quando o Maestro está ativo, ele pode ler e operar follow-ups por ferramentas próprias.

Em resumo: o follow-up é, ao mesmo tempo, ação (algo que outras regras executam) e fonte de eventos (algo a que outras regras e sistemas reagem).

Pré-requisitos

Módulo de Follow-ups disponível na conta (recurso follow_ups habilitado).
Para inscrever/operar via automação, macro ou fluxo: o módulo de Automação/Flow disponível.
Para receber notificações em sistemas externos: um endpoint de webhook configurado na conta, já assinando os eventos desejados.
Para as ferramentas de IA: o Maestro ativo na conta.

Passo a passo

Crie uma regra de automação (ou edite uma existente).
Defina o evento gatilho da regra (por exemplo, uma cobrança que venceu ou um negócio que parou).
Em ações, escolha Inscrever em follow-up (enroll_in_follow_up) e selecione a sequência.
Opcionalmente, adicione condições por follow_up_status para agir só sobre quem já está (ou ainda não está) em cadência.
Salve e ative a regra. A partir daí, cada vez que o evento ocorre, a ação roda automaticamente.

Configurações & opções

As cinco ações de follow-up (automação, macro e fluxo)

As mesmas cinco ações estão disponíveis em Automação, Macros e Flow Builder e executam de forma idêntica nos três lugares:

Ação	O que faz
`enroll_in_follow_up`	Inscreve o alvo (contato/conversa) em uma sequência.
`cancel_follow_up`	Cancela a inscrição ativa.
`pause_follow_up`	Pausa a inscrição (sem enviar os próximos passos).
`resume_follow_up`	Retoma uma inscrição pausada.
`skip_follow_up_step`	Pula o passo atual e segue para o próximo.

Essas ações são adicionadas ao conjunto que a automação já tinha — nenhuma regra existente é afetada por elas.

Os três campos de condição

Em uma regra disparada por evento de follow-up, você pode condicionar pelos campos:

Campo	Para que serve
`follow_up_status`	Estado da inscrição (ativa, pausada, concluída, saída, falha).
`follow_up_sequence_id`	A sequência específica em que o contato está inscrito.
`follow_up_enrolled_via`	Como o contato foi inscrito (manual, automação, evento, inatividade, IA, API).

Eventos e webhooks

Conforme a cadência roda, a plataforma emite eventos que servem tanto para disparar automações quanto para alimentar webhooks da conta:

Evento	Quando ocorre
`follow_up_enrollment.created`	Uma inscrição foi criada.
`follow_up_enrollment.paused`	A inscrição foi pausada.
`follow_up_enrollment.resumed`	A inscrição foi retomada.
`follow_up_enrollment.exited`	A inscrição saiu por uma regra de saída (ex.: o contato respondeu).
`follow_up_enrollment.completed`	A inscrição chegou ao fim da sequência.
`follow_up_enrollment.failed`	A inscrição falhou.
`follow_up_step.sent`	Um passo foi enviado.
`follow_up_step.replied`	O contato respondeu a um passo.
`follow_up_step.skipped`	Um passo foi pulado.
`follow_up_step.failed`	O envio de um passo falhou.

Os payloads desses webhooks carregam o mínimo de dados pessoais (identificadores de conta, inscrição, sequência e passo, e o estado) — eles servem para sincronizar painéis e sistemas, não para transportar o conteúdo das mensagens. Quando uma etapa de IA aguarda aprovação humana, há ainda uma notificação interna de rascunho pendente.

Ferramentas de follow-up do Maestro

Com o Maestro ativo, o assistente pode ler e operar follow-ups por ferramentas próprias, sempre com um token do usuário e respeitando o recurso habilitado e as permissões:

Listar sequências e inscrições.
Inscrever um contato em uma sequência.
Pausar e retomar uma inscrição.
Pular o passo atual.
Aprovar um rascunho de IA (HITL).
Cancelar uma inscrição.

Casos de uso

Negócio ganho no CRM → uma automação roda cancel_follow_up para encerrar qualquer cadência ativa daquele contato (ninguém quer ser cobrado depois de fechar).
Cobrança vencida → uma automação roda enroll_in_follow_up na sequência de "Cobrança".
Dashboards de integrador → um sistema externo assina follow_up_enrollment.* e follow_up_step.* por webhook e monta seus próprios relatórios em tempo quase real.

Dicas, limites e boas práticas

Combine ações de follow-up com o evento certo: cancel_follow_up em eventos de conversão, e enroll_in_follow_up em eventos de risco (cobrança vencida, negócio parado, falta em agendamento).
Use follow_up_status como condição para evitar inscrever duas vezes ou agir sobre quem já saiu.
Trate os webhooks como somente leitura de estado: o conteúdo das mensagens não vem no payload.
A mesma ação roda igual em automação, macro e fluxo — escolha o ponto de partida pela jornada, não pela capacidade.

Solução de problemas

A ação não disparou: confirme que a regra está ativa, que o evento gatilho realmente ocorreu e que as condições (inclusive follow_up_status) batem; verifique também se o recurso de follow-ups está habilitado na conta.
O webhook não chegou: confira se o endpoint está configurado e acessível e se os eventos de follow-up estão de fato assinados naquele webhook.
A ferramenta do Maestro foi negada: verifique se o recurso está habilitado, se o token do usuário é válido e se ele tem permissão para operar follow-ups.