Receiving Events

conversation.history

Recent WhatsApp history for one conversation was synced after bootstrap or reconnect.

Event payload

{
  "id": "evt_wa_history_10001_8613912345678@s.whatsapp.net",
  "type": "conversation.history",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T12:46:00Z",
  "data": {
    "conversation": { "id": "8613912345678@s.whatsapp.net", "type": "user" },
    "messages": [
      {
        "id": "3EB0A1",
        "type": "text",
        "text": "Previous order question",
        "direction": "inbound",
        "sent_at": "2026-06-08T11:58:12Z",
        "sender": { "id": "8613912345678@s.whatsapp.net" },
        "reply_to_message_id": "3EB09F",
        "mentions": [
          { "id": "8613900001111@lid" }
        ]
      },
      {
        "id": "3EB0A2",
        "type": "image",
        "direction": "inbound",
        "sent_at": "2026-06-08T11:59:20Z",
        "sender": { "id": "8613912345678@s.whatsapp.net" },
        "attachments": [
          {
            "type": "image",
            "mimetype": "image/jpeg",
            "expired": true
          }
        ]
      },
      {
        "id": "3EB0A3",
        "type": "location",
        "text": "Shibuya Scramble Square",
        "direction": "inbound",
        "sent_at": "2026-06-08T12:00:10Z",
        "sender": { "id": "8613912345678@s.whatsapp.net" },
        "location": {
          "longitude": 139.7020,
          "latitude": 35.6580
        }
      }
    ]
  }
}

Notes

A WhatsApp HistorySync batch for one conversation. data.messages[] is chronological and can include id, type, direction, sent_at, sender, text, attachments, location, mentions, and reply_to_message_id. History messages do not include reply_token.
This is best-effort recent continuity, not a full archive or guaranteed replay. One sync processes at most 100 recent conversations and 100 messages per conversation. Only media in the newest 20 retained messages is eligible for URL prefetch; older, unavailable, or expired media has attachments[].expired=true and no url.