Входящие сообщения

Когда клиент отправляет сообщение в приватном диалоге с ботом компании, MassAccess отправляет нотификацию message.inbound на Webhook URL компании.

Пример данных события

json

{
  "event": "message.inbound",
  "event_version": 1,
  "event_id": "728b70f4-6cf3-5d85-9f39-0a2df2dbe01d",
  "timestamp": "2026-09-21T08:16:31Z",
  "data": {
    "service": "max",
    "bot_name": "support_max_bot",
    "phone_number": "12345678901",
    "text": "I need help with my order"
  }
}

Поля события

Имя	Тип	Обязателен	Описание
event	"message.inbound"	Да	Постоянное имя события message.inbound.
event_version	integer	Да	Версия формата события; для этой схемы всегда 1.
event_id	UUID	Да	Уникальный UUID события. Совпадает с заголовком Idempotency-Key при каждой попытке доставки.
timestamp	string (date-time)	Да	Время создания события в UTC, формат RFC 3339/ISO 8601.
data	object	Да	Данные входящего сообщения.
data.service	"telegram" \| "max"	Да	Канал сообщения: telegram или max.
data.bot_name	string	Да	Имя бота компании, которому написал клиент.
data.phone_number	string	Да	Подтверждённый номер телефона клиента.
data.text	string	Да	Исходный текст без обрезки и преобразования HTML/Markdown.

Все перечисленные поля обязательны и не могут быть null. Дополнительные поля не допускаются.

timestamp содержит время создания события MassAccess, а не время сообщения в мессенджере.

Максимальная длина текста — 4096 символов; в настройках компании можно задать меньшее значение.

Настройка компании

Приём входящих сообщений по умолчанию выключен.

Включите переключатель «Принимать текстовые сообщения».
При необходимости задайте максимальную длину одного сообщения и количество сообщений, принимаемых от одного клиента за выбранный период. Допустимые значения показаны в настройках.

Если текст длиннее установленного максимума, нотификация для него не создаётся. Если клиент превышает допустимое количество сообщений за выбранный период, нотификации для сообщений сверх лимита не создаются и позднее не отправляются. Новые сообщения снова принимаются, когда в текущем периоде их количество становится меньше лимита.