Message Status Webhooks

Receive updates when messages are delivered, read, or played.

When enabled, Waplix sends status updates to your webhook URL as WhatsApp delivery state changes are observed.

Payload Fields

  • event - One of message.delivered, message.read, or message.played
  • instance_id - Waplix instance id
  • message_id - WhatsApp message id
  • status - DELIVERY_ACK, READ, or PLAYED

Example Webhook Event Payload

Webhook Event Body (JSON)
Response · 200 OK
{
  "event": "message.read",
  "instance_id": "demo_instance",
  "message_id": "MSG_DEMO_001",
  "chat_id": "15551234567@s.whatsapp.net",
  "from": null,
  "to": "15551234567@s.whatsapp.net",
  "message_type": "text",
  "status": "READ",
  "receipts": [],
  "timestamp": 1782582363
}
Was this page helpful?