Все входящие сообщения от абонента будут переправлены вам на ваш URL, который вы установлили методом "Установить WebHook - setwebhook"Для входящих сообщений в отличии от статусов сообщений параметр typeRequest устанавливается в значение inboxmsg
"typeRequest": "inboxmsg"
Общая структура запроса выглядит следующий образом{
"typeRequest": "inboxmsg",
"id": "01912671-c5d7-7940-85ed-7a260390f7fd",
"receivedAt": "2024-08-06 12:19:15",
"channel": "7700999999",
"payload": {
"type": "text",
"payload": {
"text": "Привет"
},
"sender": {
"phone": "77771234567",
"name": "Abai"
},
"context": {
"id": "6de102aa-dde0-4115-87ca-e49b740c0b9f",
"forwarded": false,
"frequently_forwarded": false
}
}
}
корневая структура payload содержит общую информацию о типе сообщения
дочерняя структура payload содержит информацию о контенте сообщения в зависимости от его типа (текст, url изображение, код нажатой кнопки и т.п.)
За тип сообщния отпарвленное абонентом (изображение, текст, нажатие на кнопку и т.п.) отвечает поле type, которое может иметь следующие значения:text — Текстовое сообщение
image — Абонент отправил изображение (возможно с текстовой подписью)
sticker — Абонент отправил стикер
video — Абонент отправил видео (возможно с текстовой подписью)
audio - Абонент отправил аудио запись
document - Абонент отправил видео (возможно с текстовой подписью и названием файла)
location - Абонент отправил местоположение
quick_reply - Абонент нажал на кнопку быстрого ответа (ответ на ваше сообщение "Сообщение с кнопками ответа")
list_reply -Абонент нажал на кнопку элемент из списка (ответ на ваше сообщение "Сообщение с списками")
contacts - Абонент отпарвил контакт
структура sender содержит информацию о абоненте
структура context содержит информацию если абонент процитировал какое то Ваше сообщение или переслал сообщения вам от другого абонента, а так же если абонент нажал на кнопку в вашем сообщении
Пример отправки изображения абонентом: