Visão geral
Vários módulos da plataforma emitem eventos quando algo muda — uma conversa é criada, um pagamento é confirmado, um negócio muda de etapa, etc. Você pode reagir a esses eventos via webhooks ou pelas regras de automação internas.
Pré-requisitos
- Webhooks configurados (para consumo externo) ou acesso à Automação (para reações internas).
Passo a passo
- Identifique o evento do módulo que você quer consumir (ex.: conversa criada, pagamento pago).
- Para consumo externo: assine o evento no webhook e trate o payload no seu endpoint.
- Para reações internas: crie uma regra de automação com o gatilho correspondente.
- Valide e processe o payload de forma idempotente.
Configurações & opções
- Webhooks: assinatura por inbox/conta.
- Automação: gatilhos por evento, com condições e ações.
- Payload: contém o contexto do evento (ids e dados relevantes).
Casos de uso
- Atualizar um sistema externo quando um pagamento é confirmado.
- Disparar uma cadência de follow-up quando um negócio muda de etapa.
Dicas, limites e boas práticas
- Consulte sempre a fonte real do payload antes de mapear campos (não invente formato).
- Garanta idempotência por identificador do evento.
Solução de problemas
- Evento não chega: confirme a assinatura e o status do endpoint.
- Campos inesperados: revise o payload real recebido e ajuste o mapeamento.