Filtros de webhook

Os filtros ficam no mesmo objeto das URLs (GET/PUT /webhooks) e no painel, em Webhooks e configurações gerais. Todos são booleanos e valem por instância.

curl -X PUT https://api.wabox.me/instances/{instance_id}/token/{token}/webhooks \
  -H "Content-Type: application/json" \
  -d '{ "notify_sent_by_me": true, "ignore_groups": true, "ignore_audio": true }'

O PUT é parcial: só os campos enviados mudam.

Filtros do `received`

Campo	Padrão	Efeito
`notify_sent_by_me`	`false`	Liga o envio de `received` para mensagens enviadas pelo número (celular ou API), com `from_me: true`
`ignore_groups`	`false`	Descarta mensagens de grupos
`ignore_private`	`false`	Descarta conversas individuais (mantém grupos e canais)
`ignore_text`	`false`	Descarta mensagens com bloco `text`
`ignore_image`	`false`	Descarta imagens
`ignore_video`	`false`	Descarta vídeos (inclui GIFs)
`ignore_audio`	`false`	Descarta áudios e voice notes
`ignore_document`	`false`	Descarta documentos

Os filtros de tipo olham o bloco de conteúdo: uma reação, um voto, uma localização ou um notification não são afetados por ignore_text. Para descartar tudo de um chat específico não há filtro — faça no seu lado por phone.

Desligar um tipo de evento

Cada tipo tem um ignore_*_callback: ignore_received_callback, ignore_delivery_callback, ignore_message_status_callback, ignore_connected_callback, ignore_disconnected_callback, ignore_chat_presence_callback. Com true, o evento não é entregue mesmo que a URL esteja configurada. É equivalente a deixar a URL como null, mas preserva a URL para religar depois.

Ordem de avaliação

Existe URL para o tipo? Senão, descarta (no_url).
ignore_<tipo>_callback ligado? Descarta.
Só para received: from_me sem notify_sent_by_me, depois ignore_groups/ignore_private, depois os tipos de mídia.

Eventos descartados por filtro não aparecem nos Logs de webhook — só o que foi efetivamente tentado.

Combinações úteis

Objetivo	Configuração
Bot de atendimento só no privado	`ignore_groups: true`
Espelhar toda a conversa num CRM	`notify_sent_by_me: true`
Só texto e botões, sem mídia	`ignore_image`, `ignore_video`, `ignore_audio`, `ignore_document` em `true`
Só monitorar conexão	`received_url`, `delivery_url`, `message_status_url` em `null`; `connected_url` e `disconnected_url` preenchidos

Começar

Autenticação e segurança

Webhooks

Guias

Migrando do z-api

Integrações

Partner

Referências

Filtros de webhook

Filtros do `received`

Desligar um tipo de evento

Ordem de avaliação

Combinações úteis

​Filtros do received

​Desligar um tipo de evento

​Ordem de avaliação

​Combinações úteis

Filtros do `received`

Desligar um tipo de evento

Ordem de avaliação

Combinações úteis