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
        }
      }
    ]
  }
}

Примечания

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