← API Reference
Receiving Events

message.read

A read receipt — the recipient read a message.

Event payload

{
  "id": "evt_2f9c1a4b7e",
  "type": "message.read",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T12:35:10Z",
  "data": {
    "conversation": { "id": "8613912345678", "type": "user" },
    "sender": { "id": "8613912345678", "type": "user" },
    "message": {
      "id": "wamid.HBgM",
      "ids": ["wamid.HBgM", "wamid.HBgN"],
      "read_at": "2026-06-08T12:35:10Z"
    },
    "read_at": "2026-06-08T12:35:10Z",
    "event": { "kind": "message_read", "receipt_type": "read" }
  }
}

Notes

  • A read receipt. data.message.id is the message read; data.message.ids lists every message when a batch is acknowledged at once. read_at is the provider-reported time, also mirrored at data.read_at.