WhaBuzzdocs
Event catalogue

Business app echo

A message the business sent from the WhatsApp Business app on a coexistence number. It is outbound (direction: "out") and wa_id is the recipient. It is not a customer message and never produces messag

A message the business sent from the WhatsApp Business app on a coexistence number. It is outbound (direction: "out") and wa_id is the recipient. It is not a customer message and never produces message.inbound. This sample is Meta's documented payload, not a capture from a live number.

Event type: message.echo. 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.

#Text sent from the Business app

What Meta POSTs to WhaBuzz (fixtures/meta/smb_message_echo.json):

json
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "26059971920328384",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "14692311132",
              "phone_number_id": "1013622581841046"
            },
            "message_echoes": [
              {
                "from": "14692311132",
                "to": "16505551234",
                "id": "wamid.HBgLMTY1MDU1NTEyMzQVAgASGBQzQUY5QTdGNkU0RTFGMkI3QzFBE1AA=",
                "timestamp": "1760592011",
                "type": "text",
                "text": {
                  "body": "Yes, the 7am batch is open. See you there!"
                }
              }
            ]
          },
          "field": "smb_message_echoes"
        }
      ]
    }
  ]
}

What your endpoint receives, as the body of a signed POST. raw is abbreviated here; on the wire it is the full body above.

json
{
  "id": "evt_01JAB3K9X2S8C4M7Q1V5R6T0YZ",
  "type": "message.echo",
  "api_version": "2026-10-16",
  "created_at": "2025-10-16T05:20:11.481Z",
  "tenant_id": "a578246e-b97f-48e6-ae42-939ec3ccf917",
  "waba_id": "26059971920328384",
  "phone_number_id": "1013622581841046",
  "display_phone_number": "14692311132",
  "wamid": "wamid.HBgLMTY1MDU1NTEyMzQVAgASGBQzQUY5QTdGNkU0RTFGMkI3QzFBE1AA=",
  "wa_id": "16505551234",
  "user_id": null,
  "dedupe_key": "echo:wamid.HBgLMTY1MDU1NTEyMzQVAgASGBQzQUY5QTdGNkU0RTFGMkI3QzFBE1AA=",
  "data": {
    "messaging_product": "whatsapp",
    "metadata": {
      "display_phone_number": "14692311132",
      "phone_number_id": "1013622581841046"
    },
    "field": "smb_message_echoes",
    "message": {
      "from": "14692311132",
      "to": "16505551234",
      "id": "wamid.HBgLMTY1MDU1NTEyMzQVAgASGBQzQUY5QTdGNkU0RTFGMkI3QzFBE1AA=",
      "timestamp": "1760592011",
      "type": "text",
      "text": {
        "body": "Yes, the 7am batch is open. See you there!"
      }
    }
  },
  "raw": {
    "…": "the complete Meta POST body, byte for byte, as shown above"
  },
  "raw_path": "entry[0].changes[0].value.message_echoes[0]"
}

This page as Markdown: /events/message-echo.md. All docs in one file: /llms-full.txt. Status.