Início rápido - Zapfy Docs

1. Enviar uma mensagem

curl -X POST https://api.zapfy.io/v1/messages/send-text \
  -H "Authorization: Bearer zpfy_inst_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999998888",
    "text": "Olá da Zapfy!"
  }'

A API responde 202 na hora com { "data": { "messageId": "3EB0…" } } — o id que a mensagem terá no WhatsApp — e envia em seguida, na ordem em que você pediu. O resultado chega pelos webhooks: MESSAGE.SENT quando o WhatsApp aceitou (✓ enviado); entrega (✓✓), leitura ou falha de envio em MESSAGE.STATUS_UPDATED. Também dá para consultar em GET /v1/messages/{messageId}.

2. Cadastrar um webhook

No painel, abra a instância → aba Webhooks & config → Adicionar webhook, informe a URL de destino e marque os eventos que quer receber. Você pode ter até 5 webhooks por instância, cada um assinando o seu próprio conjunto de eventos.

3. Receber eventos

A Zapfy faz um POST na sua URL com o envelope canônico:

{
  "type": "MESSAGE.RECEIVED",
  "id": "wh_286b29b031204ca07cfb0a068a89f526",
  "instanceId": "01J9Z...",
  "timestamp": "2026-09-28T12:34:56Z",
  "data": {
    "messageId": "3EB0C767D26A1D8E4F2B",
    "fromMe": false,
    "chat": { "type": "DIRECT", "id": "5511999998888@s.whatsapp.net", "phone": "5511999998888" },
    "sender": { "id": "5511999998888@s.whatsapp.net", "phone": "5511999998888", "name": "João Silva" },
    "messageType": "TEXT",
    "text": "Olá!"
  }
}

Responda 2xx em até 10 segundos para confirmar o recebimento. Em caso de falha, a Zapfy reentrega o evento, então o mesmo evento pode chegar mais de uma vez — veja em Tratando eventos como deduplicar.

​1. Enviar uma mensagem

​2. Cadastrar um webhook

​3. Receber eventos

1. Enviar uma mensagem

2. Cadastrar um webhook

3. Receber eventos