Esta página reúne, em forma de tabela, os eventos e comportamentos da tela Webhooks.
Você recebe estes eventos na sua URL. Os nomes seguem o padrão grupo.evento e aceitam curinga
(por exemplo, message.* cobre todos os eventos de mensagem).
| Evento | Descrição |
|---|
message.received | Mensagem recebida |
message.sent | Mensagem enviada (echo do celular ou do painel) |
message.status | Atualização de ticks (enviada, entregue, lida, reproduzida) |
message.deleted | Mensagem apagada |
message.reaction | Reação adicionada ou removida |
message.poll_vote | Voto em enquete |
| Evento | Descrição |
|---|
group.updated | Nome, descrição ou configurações do grupo |
group.participant.added | Participante adicionado |
group.participant.removed | Participante removido |
group.participant.promoted | Participante promovido a admin |
group.participant.demoted | Admin rebaixado |
| Evento | Descrição |
|---|
call.incoming | Chamada recebida (tocando) |
call.ended | Chamada encerrada (com status e duração) |
| Evento | Descrição |
|---|
session.connected | Dispositivo pareado pela primeira vez |
session.disconnected | Dispositivo desconectado / deslogado |
session.restricted | O WhatsApp aplicou restrição temporária |
| Característica | Comportamento |
|---|
| Assinatura | HMAC-SHA256 no cabeçalho Pragmaz-Signature (mais Pragmaz-Timestamp em segundos) |
| Proteção contra replay | Valide o Pragmaz-Timestamp dentro de uma janela curta (recomendado 5 minutos); use o id do evento (no corpo) para descartar duplicatas |
| Retry automático | Até 12 tentativas, com espera crescente (30 segundos até 24 horas) |
| Auto-desativação | Após 30 falhas seguidas, o endpoint é desativado automaticamente |
| Status | Significado |
|---|
| Ativo | Recebendo eventos normalmente |
| Desativado | Desligado manualmente |
| Auto-desativado | Desligado pelo sistema após falhas seguidas (re-habilite no detalhe) |
Quando um sistema externo chama a sua URL única (https://pragmaz.ai/webhooks/in/<token>), o
inbound executa a ação configurada.
| Ação | O que faz |
|---|
| Apenas registrar | Recebe e registra o conteúdo (útil para depurar e capturar webhooks de terceiros) |
| Enviar mensagem no WhatsApp | Dispara uma mensagem a partir do conteúdo recebido |
Para a ação de enviar mensagem, há dois modos de montar a mensagem:
| Modo | Quando usar |
|---|
| Direto | Você controla o conteúdo (telefone e texto no formato esperado) |
| Mapping | O serviço externo tem formato fixo e você extrai os campos do conteúdo recebido (configurado na aba Mapeamento) |
