Quickstart - Zapfy Docs

1. Send a message

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": "Hello from Zapfy!"
  }'

The response confirms WhatsApp accepted the message (✓ sent). Delivery (✓✓) and read come asynchronously via the MESSAGE_STATUS webhook.

2. Register a webhook

In the dashboard, open the instance → Settings → Webhooks, enter the destination URL and pick the events you want. You can have up to 5 webhooks per instance, each subscribing to its own set of events.

3. Receive events

Zapfy sends a POST to your URL with the canonical envelope:

{
  "event": "MESSAGE_RECEIVED",
  "instanceId": "01J9Z...",
  "id": "evt_01J9Z...",
  "timestamp": "2026-06-09T12:34:56.789Z",
  "data": {
    "messageId": "3EB0C767D...",
    "fromMe": false,
    "chat": {
      "jid": "5511999998888@s.whatsapp.net",
      "phone": "5511999998888",
      "isGroup": false,
      "name": null
    },
    "sender": {
      "jid": "5511999998888@s.whatsapp.net",
      "phone": "5511999998888",
      "name": "John Doe"
    },
    "type": "TEXT",
    "text": "Hi!"
  }
}

Reply 2xx to acknowledge receipt. On failure, Zapfy retries the event — use the id field as an idempotency key so you don’t process duplicates.

​1. Send a message

​2. Register a webhook

​3. Receive events

1. Send a message

2. Register a webhook

3. Receive events