Входящие сообщения
В данном разделе приводится описание общего формата входящих уведомлений с типом incomingMessageReceived
. Описание всех типов входящих уведомлений представлено в разделе Типы входящих уведомлений.
Система предусматривает получение уведомлений о входящих сообщениях следующих видов:
- Входящее текстовое сообщение
- Входящее сообщение с кнопками
- Входящее сообщение с шаблонным кнопками
- Входящее сообщение со списком выбора
- Входящее текстовое сообщение с URL
- Входящее сообщение с изображением, видео, аудио, документом
- Входящее сообщение с геолокацией
- Входящее сообщение с контактом
- Входящее сообщение с массивом контактов
- Входящее сообщение с цитированием
- Входящее сообщение со стикером
- Входящее сообщение-реакция
- Входящее сообщение с приглашением в группу
- Входящее сообщение с опросом
- Входящее сообщение с обновлением опроса
Поля уведомления incomingMessageReceived
Параметр | Тип | Описание |
---|---|---|
typeWebhook | string | Тип входящего уведомления. Для уведомления данного типа поле принимает значение incomingMessageReceived |
instanceData | object | Данные об инстансе |
timestamp | integer | Время наступления события в UNIX-формате |
idMessage | string | Идентификатор входящего сообщения |
senderData | object | Данные об отправителе сообщения или файла |
messageData | object | Данные о принятом сообщении или файле |
Поля объекта instanceData
Параметр | Тип | Описание |
---|---|---|
idInstance | integer | Идентификатор инстанса. Размер integer равен int64. Значения лежат в диапазоне от 1 до 10 разрядов |
wid | string | Идентификатор аккаунта в формате WhatsApp |
typeInstance | string | Тип мессенджера для инстанса |
Поля объекта senderData
Параметр | Тип | Описание |
---|---|---|
chatId | string | Идентификатор чата, в котором получено сообщение или файл |
sender | string | Идентификатор отправителя сообщения или файла |
chatName | string | Имя чата |
senderName | string | Имя отправителя |
senderContactName | string | Имя отправителя из списка контактов текущего аккаунта |
Поля объекта messageData
Объект messageData
имеет разные поля в зависимости от типа входящего сообщения:
- Входящее текстовое сообщение
- Входящее текстовое сообщение с URL
- Входящее сообщение с изображением, видео, аудио, документом
- Входящее сообщение с геолокацией
- Входящее сообщение с контактом
- Входящее сообщение с массивом контактов
- Входящее сообщение с цитированием
- Входящее сообщение со стикером
- Входящее сообщение-реакция
- Входящее сообщение с приглашением в группу
- Входящее сообщение с опросом
- Входящее сообщение с обновлением опроса
Пример тела уведомления
{
"typeWebhook": "incomingMessageReceived",
"instanceData": {
"idInstance": 1234,
"wid": "11001234567@c.us",
"typeInstance": "whatsapp"
},
"timestamp": 1588091580,
"idMessage": "F7AEC1B7086ECDC7E6E45923F5EDB825",
"senderData": {
"chatId": "79001234568@c.us",
"sender": "79001234568@c.us",
"chatName": "Иван",
"senderName": "Иван",
"senderContactName": "Иван Васильевич"
},
"messageData":{
// В зависимости от typeMessage = textMessage || imageMessage || videoMessage || documentMessage || audioMessage || locationMessage || contactMessage || extendedTextMessage || quotedMessage || pollMessage || pollUpdateMessage
...
...
...
}
}
}