Pular para o conteúdo principal

​
Ferramentas de Teste

Para testar webhooks durante o desenvolvimento, recomendamos estas ferramentas:

Webhook.cool

Melhor opção. Sem rate limit e interface limpa.

Rbaskets.in

Boa alternativa. Confiável e baixo rate limit.

Webhook.site

Evitar. Rate limit agressivo pode bloquear testes.

​
Modos de Configuração

O modo simples gerencia automaticamente um único webhook por instância, criando ou atualizando conforme necessário.
1

Simplifique

Não inclua action nem id no payload.
2

Evite Loops

Sempre use excludeMessages com "wasSentByApi".
Exemplo de Payload
{
  "url": "https://meusite.com/webhook",
  "events": ["messages"],
  "excludeMessages": ["wasSentByApi"]
}
Dica: Mesmo no modo simples, você pode usar addUrlEvents (veja no final da página) para rotear eventos para URLs diferentes (ex: /webhook/messages) sem criar múltiplos webhooks manuais.

​
Prevenção de Loops

Importante: Evite Loops InfinitosSe sua automação envia mensagens via API, sua aplicação deve ignorar os eventos dessas mensagens para não responder a si mesma infinitamente.Sempre inclua: "excludeMessages": ["wasSentByApi"]

​
Referência Técnica

EventoDescrição
messagesNovas mensagens recebidas.
messages_updateAtualizações em mensagens (ex: deletadas).
connectionAlterações no estado da conexão.
historyRecebimento de histórico.
callEventos de chamadas VoIP.
contactsAtualizações na agenda.
presenceAlterações no status (digitando…).
groupsModificações em grupos.
labelsGerenciamento de etiquetas.
chatsEventos de conversas.
blocksBloqueios/desbloqueios.
leadsAtualizações de leads.
senderAtualizações de campanhas.
  • wasSentByApi: (Importante) Mensagens originadas pela API.
  • wasNotSentByApi: Mensagens não originadas pela API.
  • fromMeYes: Mensagens enviadas pelo usuário.
  • fromMeNo: Mensagens recebidas de terceiros.
  • isGroupYes: Mensagens em grupos.
  • isGroupNo: Mensagens em conversas individuais.

​
URL Dinâmica

Adicione parâmetros à URL do webhook para facilitar o roteamento no backend. 
// URL: .../webhook/{evento}
{ "addUrlEvents": true }