Configuração de Webhooks
Enviamos notificações HTTP POST em tempo real para sua URL quando eventos ocorrem.
Criando um Webhook
1. Abra a parte de Webhooks
No painel, vá em Configurações → Webhooks.
[COLOCAR IMAGEM]
2. Crie um novo Webhook
Clique em Novo Webhook e preencha os campos:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome | Sim | Nome identificável |
| URL | Sim | Endpoint HTTPS que receberá os webhooks |
| Canais | Não | Filtrar por canais específicos |
| Secret Key | Não | Chave para validar origem |
[COLOCAR IMAGEM]
3. Escolha os eventos
Marque os eventos que quer receber e clique em Salvar.
Eventos Disponíveis
| Evento | Descrição |
|---|---|
MESSAGE_SENT | Mensagem enviada pela equipe |
MESSAGE_RECEIVED | Mensagem recebida do contato |
CHAT_CREATED | Nova conversa criada |
CHAT_ENDED | Conversa finalizada |
CHAT_TRANSFERRED | Conversa transferida |
CHANNEL_CONNECTED | Canal conectado |
CHANNEL_DISCONNECTED | Canal desconectado |
Veja a lista detalhada e exemplos de payload em Eventos.
Requisitos da URL
- Usar HTTPS
- Ser publicamente acessível
- Aceitar requisições POST
- Responder com status 200
Tentativas
Se a URL não responder com sucesso, fazemos novas tentativas:
| Config | Valor |
|---|---|
| Timeout | 30 segundos |
| Tentativas | 3 |
| Intervalos | 1 min, 5 min, 15 min |
Validando a Origem
Se você definiu uma Secret Key, use-a para validar que a requisição veio de nós. Enviamos a chave no header X-Webhook-Secret.
Próximos Passos
- Eventos - Lista de eventos e exemplos de payload
- Práticas Recomendadas - Dicas para implementação