Event catalogue
Message error (value-level)
Meta reported an error on the messages field with no message or status to hang it on. data.error is Meta's error object verbatim.
Meta reported an error on the messages field with no message or status to hang it on. data.error is Meta's error object verbatim.
Event type: message.error. Fixture payloads are the WhaBuzz Demo tenant's real ids with a fictional customer number; id, tenant_id and created_at in envelopes are illustrative.
#Error with no message attached
What Meta POSTs to WhaBuzz (fixtures/meta/value_errors.json):
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "26059971920328384",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "14692311132",
"phone_number_id": "1013622581841046"
},
"errors": [
{
"code": 131000,
"title": "Something went wrong",
"message": "Something went wrong",
"error_data": {
"details": "Message failed to send because of an unknown error."
}
}
]
},
"field": "messages"
}
]
}
]
}What your endpoint receives, as the body of a signed POST. raw is abbreviated here; on the wire it is the full body above.
{
"id": "evt_01JAB3K9X2S8C4M7Q1V5R6T0YZ",
"type": "message.error",
"api_version": "2026-10-16",
"created_at": "2025-10-16T05:12:03.481Z",
"tenant_id": "a578246e-b97f-48e6-ae42-939ec3ccf917",
"waba_id": "26059971920328384",
"phone_number_id": "1013622581841046",
"display_phone_number": "14692311132",
"wamid": null,
"wa_id": null,
"user_id": null,
"dedupe_key": "err:<sha256 of the error object>",
"data": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "14692311132",
"phone_number_id": "1013622581841046"
},
"error": {
"code": 131000,
"title": "Something went wrong",
"message": "Something went wrong",
"error_data": {
"details": "Message failed to send because of an unknown error."
}
}
},
"raw": {
"…": "the complete Meta POST body, byte for byte, as shown above"
},
"raw_path": "entry[0].changes[0].value.errors[0]"
}This page as Markdown: /events/message-error.md. All docs in one file: /llms-full.txt.