Перейти к содержанию

Входящее текстовое сообщение, сообщение с URL или рекламное сообщение#

В данном разделе описывается формат входящего уведомления объекта messageData для отправленного текстового сообщения или сообщения с URL. Для получения описания общего формата входящих уведомлений обратитесь к разделу Отправленные сообщения.

Для получения входящих уведомлений данного вида требуется выполнение двух условий:

typeWebhook = outgoingMessageReceived || outgoingAPIMessageReceived

messageData.typeMessage = textMessage

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

Чтобы получать входящие уведомления об отправленных сообщениях, необходимо включить настройки одним из представленных вариантов:

  1. Через личный кабинет включить настройки Получать уведомления о сообщениях, отправленных с телефона и Получать уведомления о сообщениях, отправленных через API
    (дополнительно Получать уведомления о статусах отправленных сообщений для получения уведомлений о статусах отправленного сообщения)

  2. Через метод SetSettings включить настройки outgoingMessageWebhook и outgoingAPIMessageWebhook
    (дополнительно outgoingWebhook для получения уведомлений о статусах отправленного сообщения)

Уведомление#

Формат уведомления#

Поля объекта messageData

Параметр Тип Описание
typeMessage string Тип отправленного сообщения. Для сообщений данного типа поле принимает значение extendedTextMessage
extendedTextMessageData object Объект данных о текстовом сообщении или URL ссылки

Поля объекта extendedTextMessageData

Параметр Тип Описание
text string Текст ссылки или обычный текст
description string Описание ссылки, может быть пустым
title string Заголовок ссылки, может быть пустым
jpegThumbnail string Превью изображения в base64 кодировке, может отсутствовать
isForwarded boolean Является ли сообщение пересланным, принимает значения true/false
forwardingScore integer Количество пересылок сообщения
previewType string Тип превью (только для рекламных сообщений) Значение previewType:None устаревшее

Пример тела уведомления#

{
    "typeWebhook": "incomingMessageReceived",
    "instanceData": {
      "idInstance": 3100000000,
      "wid": "79991234567@c.us",
      "typeInstance": "v3"
    },
    "timestamp": 1588091580,
    "idMessage": "2755232962562",
    "senderData": {
      "chatId": "10000000",
      "sender": "10000000",
      "chatName": "Ходабрыш Пробешёлов",
      "senderName": "Ходабрыш Пробешёлов",
      "senderContactName": "Ходабрыш Пробешёлов"
    },
    "messageData": {
        "typeMessage": "extendedTextMessage",
        "extendedTextMessageData": {
            "text": "https://green-api.com/docs/video",
            "description": "Я использую GREEN-API для отправки этого сообщения!",
            "title": "How to develop WhatsApp Bot",
            "jpegThumbnail": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYG==",
            "forwardingScore": 0,
            "isForwarded": false
        }
    }
}