POST /automations/trigger faz para um lead o mesmo que uma interação concluída:
agenda os follow-ups, o reengajamento e os webhooks por inatividade que casam com ele. É a
mesma rota que o CRM usa quando você move um lead para uma coluna com Disparar
automações.
Use depois de mudar o lead pela API (mover de coluna, pôr tag), já que essas mudanças não
agendam automações sozinhas.
Para os fluxos do Trigger Flow, a rota é outra: Fluxos e webhook de entrada.
Corpo
O que é agendado
Os agendamentos anteriores do lead são refeitos do zero, como em qualquer interação
concluída. Na hora marcada, cada automação confere tudo de novo antes de agir. Detalhes em
Quando as automações disparam.
Resposta: 200
Erros
Exemplo
Armadilhas
- Usa o id, não o número. Chame
GET /leads/{numero}antes. - Só na conexão oficial. Na conexão não oficial a rota responde 400 e nada é agendado.
- 200 não quer dizer que algo foi agendado. Se nenhum follow-up casa com as tags e a coluna do lead, nada acontece. Confira os filtros.
- Ordem importa. Mova o lead ou ponha a tag antes de disparar: o filtro usa a coluna e as tags do momento da chamada.
- Disparar de novo reinicia a contagem. Chamar a rota a cada evento empurra o follow-up para frente e ele pode nunca sair.
- Transbordo por inatividade não é agendado por esta rota.
Para saber mais
- Quando as automações disparam
- Automações: visão geral
- Leads, Fluxos e webhook de entrada
- Termos para buscar: “follow-up automático WhatsApp”, “drip schedule”.