## 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

1. Identifique o evento do módulo que você quer consumir (ex.: conversa criada, pagamento pago).
2. Para consumo externo: assine o evento no webhook e trate o payload no seu endpoint.
3. Para reações internas: crie uma regra de automação com o gatilho correspondente.
4. 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.

## Veja também

- [API REST, tokens e webhooks](/hc/ajuda/articles/api-developers-rest-tokens-webhooks-pt-br)
- [Regras de automação](/hc/ajuda/articles/automation-flows-regras-de-automacao-pt-br)