Webhooks

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

🚀 Modo Simples (Recomendado)
⚙️ Modo Avançado

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

Simplifique

Não inclua action nem id no payload.

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.

Para usuários que precisam registrar múltiplos webhooks distintos para a mesma instância.Ações (action):

add: Registrar novo (não envie ID).
update: Atualizar existente (envie ID).
delete: Remover (envie apenas ID).

Exemplo de Payload

{
  "action": "add",
  "url": "https://api.crm.com/leads",
  "events": ["leads"],
  "excludeMessages": ["wasSentByApi"]
}

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

Eventos Disponíveis

Evento	Descrição
`messages`	Novas mensagens recebidas.
`messages_update`	Atualizações em mensagens (ex: deletadas).
`connection`	Alterações no estado da conexão.
`history`	Recebimento de histórico.
`call`	Eventos de chamadas VoIP.
`contacts`	Atualizações na agenda.
`presence`	Alterações no status (digitando…).
`groups`	Modificações em grupos.
`labels`	Gerenciamento de etiquetas.
`chats`	Eventos de conversas.
`blocks`	Bloqueios/desbloqueios.
`leads`	Atualizações de leads.
`sender`	Atualizações de campanhas.

Filtros (excludeMessages)

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 }

// URL: .../webhook/{tipo_mensagem}
{ "addUrlTypesMessages": true }

// URL: .../webhook/{evento}/{tipo_mensagem}
// Exemplo: .../webhook/message/conversation
{
  "addUrlEvents": true,
  "addUrlTypesMessages": true
}

Iniciar

Integrações

Ferramentas de Teste

Webhook.cool

Rbaskets.in

Webhook.site

Modos de Configuração

Prevenção de Loops

Referência Técnica

URL Dinâmica

​Ferramentas de Teste

Webhook.cool

Rbaskets.in

Webhook.site

​Modos de Configuração

​Prevenção de Loops

​Referência Técnica

​URL Dinâmica

Ferramentas de Teste

Modos de Configuração

Prevenção de Loops

Referência Técnica

URL Dinâmica