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

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

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

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

typeWebhook = incomingMessageReceived

messageData.typeMessage = extendedTextMessage

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

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

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

  2. Через метод SetSettings включить настройку incomingWebhook

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

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

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

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

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

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

Остальные поля заполняются в зависимости от типа цитируемого сообщения и идентичны полям входящих сообщений описанных в разделе Входящие сообщения

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

{

    "typeWebhook": "incomingMessageReceived",
    "instanceData": {
        "idInstance": 4100000000,
        "wid": "79876543210@c.us",
        "typeInstance": "telegram"
    },
    "timestamp": 1770351383,
    "idMessage": "1763115112345",
    "senderData": {
        "chatId": "10000000",
        "sender": "10000000",
        "chatName": "Тридесятое царство",
        "senderName": "Василиса Премудрая",
        "senderContactName": "Василиса Премудрая",
        "senderPhoneNumber": 79998887766
    },
    "messageData": {
        "typeMessage": "extendedTextMessage",
        "extendedTextMessageData": {
            "text": "Я использую GREEN-API для отправки этого сообщения! Документация на сайте https://green-api.com/",
            "description": "GREEN-API docs shows how you can develop the Telegram Bot",
            "title": "How to develop Telegram Bot",
            "jpegThumbnail": "UklGRjoAAABXRUJQVlA4IC4AAACwAwCdASoyADIAPm0skkYkIqGhLggAgA2JaQAAZAEm0xUUDzF5wAD++yGAAAAA"
        }
    }
}