Complementos
Webhooks de saída
Configure o segredo de assinatura, os webhooks e as entregas em Administración → Configuración de la empresa.
Onde configurar
Acesse Administración → Configuración de la empresa (/company-settings) e abra a aba Webhooks.
(Disponível para administradores da empresa.)
O que a aba inclui
- Secreto de firma (segredo de assinatura): crie ou regenere. Cada entrega é assinada para que seu sistema verifique que vem do whapi.chat. Ao regenerá-lo, o anterior deixa de valer na hora.
- Webhooks: em Agregar webhook você informa uma URL (ex.
https://seu-sistema.com/webhooks/whapi) e um evento. Cada webhook escuta um único evento e cada evento só pode ter um webhook. - Entregas: consulte as tentativas e o payload enviado, teste um webhook com Probar e reenvie as entregas com falha com Reintentar.
Eventos disponíveis
| Evento | Quando é enviado |
|---|---|
| Lead creado | Um lead foi criado, manual ou automaticamente. |
| Lead actualizado | Mudou um lead, seus contatos, canais ou campos personalizados. |
| Estado de plantilla WABA | A Meta aprovou, rejeitou ou pausou um template. |
| Mensaje WABA recibido | Um cliente escreveu para um dos seus números do WhatsApp Business API. |
| Estado de mensaje WABA (Waba API) | Mudou o status de uma mensagem enviada pela WABA API. |
Fluxo recomendado
- Copie o segredo de assinatura e guarde-o no seu servidor.
- Implemente a verificação de assinatura no seu receptor. O guia técnico, com exemplos em Node.js e Python, está em whapi.chat/desarrolladores/webhooks (por enquanto só em espanhol).
- Adicione um webhook para cada evento de que precisar.
- Clique em Probar e revise as entregas.
Os webhooks notificam mudanças para fora. Se você precisa consultar ou atualizar dados a partir de um sistema externo, use a API pública.