Создано эхо-сообщение WhatsApp

​

Что это такое

​

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

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
• Примеры эхо-сообщений и передачи управления агенту
• Полный каталог полезных нагрузок