{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with WhatsApp.",
  "vendor": "whatsapp",
  "event": "history",
  "resource": "business_app",
  "url": "https://hookdeck.com/webhooks/whatsapp/events#history",
  "description": "Partner syncs a WhatsApp Business app customer's chat history",
  "trigger": null,
  "listed_in": "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/history",
  "confidence": "documented",
  "schema_source": "from WhatsApp docs (example)",
  "identified_by": "entry[].changes[].field field in the body",
  "payload": {
    "provenance": "doc-example",
    "value_realism": "doc-example-values",
    "field_count": 31,
    "key_fields": [],
    "delivery": null,
    "body": {
      "object": "whatsapp_business_account",
      "entry": [
        {
          "id": "102290129340398",
          "changes": [
            {
              "value": {
                "messaging_product": "whatsapp",
                "metadata": {
                  "display_phone_number": "15550783881",
                  "phone_number_id": "106540352242922"
                },
                "history": [
                  {
                    "metadata": {
                      "phase": 0,
                      "chunk_order": 1,
                      "progress": 55
                    },
                    "threads": [
                      {
                        "id": "16505551234",
                        "messages": [
                          {
                            "from": "15550783881",
                            "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBIyNDlBOEI5QUQ4NDc0N0FCNjMA",
                            "timestamp": "1739230955",
                            "type": "text",
                            "text": {
                              "body": "Here's the info you requested! https://www.meta.com/quest/quest-3/"
                            },
                            "history_context": {
                              "status": "READ"
                            }
                          },
                          {
                            "from": "15550783881",
                            "id": "wamid.QyNUEHBgLMTY0NjcwNDM1OTUVAgARGBI1Rj3NEYxMzAzMzQ5MkEA",
                            "timestamp": "1739230970",
                            "type": "media_placeholder",
                            "history_context": {
                              "status": "PLAYED"
                            }
                          },
                          {
                            "from": "16505551234",
                            "id": "wamid.N0FCNjMAHBgLMTY0NjcwNDM1OTUVAgARGBIyNDlBOEI5QUQ4NDc0",
                            "timestamp": "1739230970",
                            "type": "text",
                            "text": {
                              "body": "Thanks!"
                            },
                            "history_context": {
                              "status": "READ"
                            }
                          }
                        ]
                      },
                      {
                        "id": "12125557890",
                        "messages": [
                          {
                            "from": "15550783881",
                            "id": "wamid.BIyNDlBOEI5N0FCNjMAHBgLMTY0NjcwNDM1OTUVAgARGQUQ4NDc0",
                            "timestamp": "1739230970",
                            "type": "text",
                            "text": {
                              "body": "Thanks for your order! As a thank you, use code THANKS30 to get 30% of your next order."
                            },
                            "history_context": {
                              "status": "DELIVERED"
                            }
                          }
                        ]
                      }
                    ]
                  }
                ]
              },
              "field": "history"
            }
          ]
        }
      ]
    }
  }
}