Создано эхо-сообщение Meta Business Agent

​

Что это такое

​

Перед началом работы

1. Подключите агента через Public REST API.
2. Подпишите активную конечную точку webhook в том же аккаунте на whatsapp.echo_message.created.
3. Проверяйте YCloud-Signature по исходному телу запроса, надежно принимайте каждое событие и обрабатывайте его идемпотентно.

​

Как это работает

• Используйте id или wamid для сопоставления последующих событий статуса.
• Читайте текст из text.body. Для медиа проверяйте type и соответствующий объект содержимого. Идентификаторы медиафайлов не являются публичными URL для скачивания.
• Номер телефона клиента и BSUID независимы. Если исходный обратный вызов содержит оба значения, событие включает to вместе с recipientUserId или parentRecipientUserId. Отсутствующие идентификаторы опускаются и не выводятся друг из друга.
• from представляет собой отображаемый номер телефона компании, если исходный обратный вызов передает корректный номер. Он не вычисляется из phoneNumberId.
• Контекст ответа нормализуется в соответствии со стандартным контрактом сообщений. Например, исходный context.id преобразуется в context.message_id.
• Поля агента, передачи управления, маршрутизации, тарификации и переписки не включаются.
• status — это сохраненный статус на момент обработки эхо-сообщения; он не обязательно равен sent.
• Для входящих сообщений клиентов используется whatsapp.inbound_message.received. Для эхо-сообщений Business App используется whatsapp.smb.message.echoes.

​

Запрос

​

Ответ

​

Исходящее текстовое эхо-сообщение

​

Запрос

{
  "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"
  }
}

​

Ответ

HTTP/1.1 200 OK

​

Пояснение

​

Исходящее эхо-сообщение с изображением

​

Запрос

{
  "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"
  }
}

​

Ответ

HTTP/1.1 200 OK

​

Пояснение

​

Похожие примеры

• Обновление эхо-сообщения WhatsApp
• Обновление передачи управления WhatsApp Agent
• Примеры эхо-сообщений и передачи управления агентом
• Полный каталог полезных нагрузок