Os webhooks permitem-lhe receber notificações em tempo real sempre que alguém envia uma mensagem WhatsApp para o seu número ou quando o estado de entrega de uma mensagem de saída muda.
Como funciona
Quando ocorre um evento (por exemplo, uma mensagem recebida ou uma atualização de estado de entrega), a seven envia um pedido HTTP POST para o URL de webhook que configurou. O seu servidor processa o payload e responde com um código de estado 2xx para confirmar a receção.
Configurar o seu URL de webhook
- Inicie sessão em dashboard.seven.io.
- Navegue até Definições > Webhooks.
- Introduza o seu URL de webhook - este deve ser um endpoint HTTPS publicamente acessível no seu servidor.
- Selecione os tipos de evento que pretende receber.
- Guarde a configuração.
Certifique-se de que o seu endpoint está acessível e responde num período razoável (inferior a 10 segundos). Se o seu endpoint estiver inacessível ou devolver erros repetidamente, a entrega de webhooks poderá ser suspensa.
Tipos de evento
Mensagem recebida (wa_mo)
Acionado quando um utilizador envia uma mensagem WhatsApp para o seu número ligado. O payload inclui o número de telefone do remetente, o conteúdo da mensagem, o tipo de mensagem e o carimbo temporal.
Relatórios de entrega
Acionado quando o estado de uma mensagem de saída se altera. Os estados incluem:
- enviada - a mensagem foi enviada para os servidores do WhatsApp
- entregue - a mensagem foi entregue no dispositivo do destinatário
- lida - o destinatário leu a mensagem
- falhou - não foi possível entregar a mensagem
Formato do payload
Os payloads de webhook são enviados em JSON no corpo de um pedido POST. Um payload típico de mensagem recebida inclui:
{
"event": "wa_mo",
"from": "491701234567",
"to": "491709876543",
"timestamp": "2026-01-15T10:30:00Z",
"message": {
"type": "text",
"text": "Hello, I have a question about my order."
}
}A estrutura exata do payload pode variar consoante o tipo de mensagem e o evento. Consulte a documentação da API para obter o esquema completo.
Leitura adicional
Para informações detalhadas sobre autenticação, comportamento de retentativa e a especificação completa do payload, consulte a documentação da API seven.