Configuração - Zapfy Docs

A Zapfy usa um modelo de subscription: em vez de uma única URL global que recebe tudo, você cadastra endpoints e cada um assina o conjunto de eventos que quer.

Quem quer tudo num lugar só → 1 endpoint com todos os eventos.
Quem quer separar (ex.: status de mensagem num serviço, conexão em outro) → endpoints distintos, cada um com o seu filtro.

Limite de 5 endpoints por instância. Cada endpoint é um alvo de entrega por evento; o teto evita amplificação acidental.

Pelo painel

Abra a instância → Configurações → Webhooks:

Adicionar webhook.
Informe a URL de destino (HTTPS).
Marque os eventos que esse endpoint deve receber.
Salve. Use o toggle Ativo para pausar a entrega sem apagar o endpoint.

Pela API

string

obrigatório

URL HTTPS de destino. Máximo de 2048 caracteres.

string[]

obrigatório

Lista de eventos assinados. Ao menos um. Valores válidos em Eventos.

boolean

padrão:"true"

Se o endpoint recebe entregas.

Criar

curl -X POST https://api.zapfy.io/v1/instances/{instanceId}/webhooks \
  -H "Authorization: Bearer zpfy_acct_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seu-app.com/webhooks",
    "events": ["MESSAGE_RECEIVED", "MESSAGE_STATUS"]
  }'

Listar, atualizar e remover

# listar
curl https://api.zapfy.io/v1/instances/{instanceId}/webhooks \
  -H "Authorization: Bearer zpfy_acct_xxxxxxxxxxxx"

# atualizar (parcial)
curl -X PATCH https://api.zapfy.io/v1/instances/{instanceId}/webhooks/{webhookId} \
  -H "Authorization: Bearer zpfy_acct_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'

# remover
curl -X DELETE https://api.zapfy.io/v1/instances/{instanceId}/webhooks/{webhookId} \
  -H "Authorization: Bearer zpfy_acct_xxxxxxxxxxxx"

Entrega

A Zapfy faz POST em cada endpoint assinante quando o evento ocorre.
Responda 2xx para confirmar. Sem 2xx, o evento é reentregue.
A entrega é at-least-once — deduplique pelo campo id do evento.

Início rápido Eventos

​Pelo painel

​Pela API

​Criar

​Listar, atualizar e remover

​Entrega

Pelo painel

Pela API

Criar

Listar, atualizar e remover

Entrega