Meta Business Agent echo message created

​

What it is

​

Before you begin

1. Onboard the Agent through the Public REST API.
2. Subscribe an active webhook endpoint in the same account to whatsapp.echo_message.created.
3. Verify YCloud-Signature against the raw request body, durably accept each event, and process it idempotently.

​

How it works

• Use id or wamid to correlate later status events.
• Read text from text.body. For media, inspect type and the corresponding content object. Media IDs are not public download URLs.
• The customer phone and BSUID are independent. When the source callback supplies both, the event includes to together with recipientUserId or parentRecipientUserId. Missing identities are omitted and are not inferred from each other.
• from is the business display phone number when the source callback supplies a valid phone number. It is not derived from phoneNumberId.
• Reply context is normalized to the standard message contract. For example, source context.id is exposed as context.message_id.
• Agent, handover, routing, pricing, and conversation fields are not included.
• status is the stored status when the echo is processed; it is not guaranteed to be sent.
• Customer inbound messages use whatsapp.inbound_message.received. Business App echoes use whatsapp.smb.message.echoes.

​

Request

​

Response

​

Outbound text echo

​

Request

{
  "id": "evt_example_echo_text",
  "type": "whatsapp.echo_message.created",
  "apiVersion": "v2",
  "createTime": "2026-09-09T02:00:00.000Z",
  "whatsappMessage": {
    "id": "MESSAGE_ID",
    "wamid": "wamid.EXAMPLE",
    "wabaId": "WABA_ID",
    "from": "+12025550123",
    "to": "+12025550124",
    "recipientUserId": "GB.898232076600896",
    "type": "text",
    "text": {
      "body": "Hello! How can I help you?"
    },
    "status": "sent",
    "createTime": "2026-09-09T02:00:00.000Z",
    "sendTime": "2026-09-09T02:00:00.000Z"
  }
}

​

Response

HTTP/1.1 200 OK

​

Explanation

​

Outbound image echo

​

Request

{
  "id": "evt_example_echo_image",
  "type": "whatsapp.echo_message.created",
  "apiVersion": "v2",
  "createTime": "2026-09-09T02:00:00.000Z",
  "whatsappMessage": {
    "id": "IMAGE_MESSAGE_ID",
    "wamid": "wamid.IMAGE_EXAMPLE",
    "wabaId": "WABA_ID",
    "from": "+12025550123",
    "to": "+12025550124",
    "recipientUserId": "GB.898232076600896",
    "type": "image",
    "image": {
      "id": "MEDIA_ID",
      "mime_type": "image/jpeg"
    },
    "status": "sent",
    "createTime": "2026-09-09T02:00:00.000Z",
    "sendTime": "2026-09-09T02:00:00.000Z"
  }
}

​

Response

HTTP/1.1 200 OK

​

Explanation

​

Related examples

• WhatsApp echo message updated
• WhatsApp Agent handover updated
• Echo and Agent handover examples
• Complete payload catalog