messenger.inbound_message.received

Используйте messenger.inbound_message.received для обработки этого события на вашей конечной точке Webhook.

Триггеры

Происходит при получении обычного текстового сообщения Messenger от клиента. Подпишитесь на messenger.inbound_message.received, когда будете настраивать конечную точку Webhook. from — это идентификатор клиента в рамках Страницы (PSID), а to — идентификатор Facebook Page. Эти идентификаторы не являются номерами телефонов. Сохраняйте начальные и конечные пробелы в text.body.

Синтаксис

YCloud отправляет HTTP-запрос POST на настроенный вами Webhook URL. Ниже приведена одна из структур полезной нагрузки. Значения в угловых скобках являются заполнителями; их типы перечислены в разделе Параметры. Необязательные поля и другие варианты описаны ниже.

{
  "id": "<ID>",
  "type": "messenger.inbound_message.received",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "messengerInboundMessage": {
    "id": "<ID>",
    "metaMessageId": "<META_MESSAGE_ID>",
    "from": "<FROM>",
    "to": "<TO>",
    "type": "<TYPE>",
    "text": {
      "body": "<BODY>"
    },
    "sendTime": "<SEND_TIME>",
    "createTime": "<CREATE_TIME>"
  }
}

Параметры

Проверяйте HTTP-заголовок YCloud-Signature перед обработкой тела JSON. См. раздел проверка подписи.

Конверт события

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Уникальный идентификатор события. Минимальная длина: `6`. Максимальная длина: `128`.
`type`	string	Да	Всегда `messenger.inbound_message.received`.
`apiVersion`	string	Да	Версия API, используемая для формирования этого события.
`createTime`	string (date-time)	Да	Время создания этого события в формате RFC 3339. Например, `2022-06-01T12:00:00.000Z`.

Полезная нагрузка события

Параметр	Тип	Обязательный	Описание
`messengerInboundMessage`	object	Нет	Полезная нагрузка `messengerInboundMessage`, специфичная для события.

Четыре общих поля конверта являются обязательными. Поля полезной нагрузки зависят от варианта события. В таблице каждого объекта пометка Обязательный применяется, если присутствует родительский объект. Необязательные поля могут быть опущены; их наличие в примере не делает их обязательными.

messengerInboundMessage

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Идентификатор входящего сообщения YCloud в виде десятичной строки.
`metaMessageId`	string	Да	Идентификатор сообщения Meta.
`from`	string	Да	PSID клиента в рамках страницы Facebook.
`to`	string	Да	Идентификатор Facebook Page.
`type`	string	Да	Значения: `text`.
`text`	object	Да	Поля объекта перечислены ниже.
`sendTime`	string (date-time)	Да	Сохраненное исходное время события в формате UTC RFC 3339 с точностью до миллисекунд.
`createTime`	string (date-time)	Да	Локальное время сохранения в формате UTC RFC 3339 с точностью до миллисекунд.
`editCount`	integer	Нет	Совокупное количество правок, предоставленное Meta. Опускается до первой правки.
`editTime`	string (date-time)	Нет	Сохраненное время правки на платформе в формате UTC RFC 3339 с точностью до миллисекунд. Опускается до первой правки.

messengerInboundMessage.text

Параметр	Тип	Обязательный	Описание
`body`	string	Да	Непустой текст. Начальные и конечные пробелы сохраняются и учитываются при сравнении повторного запроса. Минимальная длина: `1`.

Пример

Следующий JSON представляет собой тело, доставленное получателю. Идентификаторы, номера телефонов и другие значения учетной записи приведены для наглядности. Используйте messengerInboundMessage.id для сопоставления повторяющихся сообщений клиента; сохраняйте пробелы в тексте.

{
  "id": "evt_0123456789abcdef01234567",
  "type": "messenger.inbound_message.received",
  "apiVersion": "v2",
  "createTime": "2026-10-20T02:00:00.000Z",
  "messengerInboundMessage": {
    "id": "1308528868252065793",
    "metaMessageId": "m_EXAMPLE_IN_001",
    "from": "100800000000000",
    "to": "422500000000000",
    "type": "text",
    "text": {
      "body": "  Hello  "
    },
    "sendTime": "2026-10-20T02:00:00.000Z",
    "createTime": "2026-10-20T02:00:00.100Z"
  }
}

После проверки подписи и надежного принятия события верните ответ 2xx. Длительные операции обрабатывайте асинхронно.

HTTP/1.1 200 OK

Начало работы

Руководства

Конечные точки

Webhook reference

messenger.inbound_message.received

Триггеры

Синтаксис

Параметры

Конверт события

Полезная нагрузка события

messengerInboundMessage

Пример

​Триггеры

​Синтаксис

​Параметры

​Конверт события

​Полезная нагрузка события

​messengerInboundMessage

​Пример

Триггеры

Синтаксис

Параметры

Конверт события

Полезная нагрузка события

messengerInboundMessage

Пример