LastIncomingMessages#

Метод возвращает крайние входящие сообщения аккаунта.

Срок хранения входящих сообщений на сервере составляет 24 часа.

Запрос#

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

GET https://api.green-api.com/waInstance{{idInstance}}/LastIncomingMessages/{{apiTokenInstance}}

Для получения параметров запроса idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Ответ#

Поля ответа#

Массив объектов с полями:

Поле	Тип	Описание
`idMessage`	string	Идентификатор входящего сообщения
`timestamp`	integer	Время принятия сообщения в UNIX-формате
`typeMessage`	string	Тип сообщения, возможные значения:
		`textMessage` - текстовое сообщение
		`imageMessage` - сообщение с изображением
		`videoMessage` - видео сообщение
		`documentMessage` - сообщение с файлом документа
		`audioMessage` - аудио сообщение
		`locationMessage` - сообщение геолокации
		`contactMessage` - сообщение с контактом
		`extendedTextMessage` - сообщение со ссылкой и превью
`chatId`	string	Идентификатор чата, в котором получено сообщение
`senderId`	string	Идентификатор отправителя сообщения
`senderName`	string	Имя отправителя сообщения
`textMessage`	string	Текст сообщения, если `typeMessage`=`textMessage`
`downloadUrl`	string	Ссылка на скачивание файла, если `typeMessage` = `imageMessage`/`videoMessage`/`documentMessage`/`audioMessage`
`caption`	string	Описание файла
`location`	object	Объект о структуре локации
`contact`	object	Объект о структуре контакта
`extendedTextMessage`	object	Объект о структуре данных ссылки

Поля объекта location:

Поле	Тип	Описание
`nameLocation`	string	Название локации
`address`	string	Адрес локации
`latitude`	double	Широта локации
`longitude`	double	Долгота локации
`jpegThumbnail`	string	Превью изображения в `base64` кодировке

Поля объекта contact:

Поле	Тип	Описание
`displayName`	string	Отображаемое имя контакта
`vcard`	string	Структура VCard (визитной карточки контакта)

Поля объекта extendedTextMessage:

Поле	Тип	Описание
`text`	string	Текст ссылки
`description`	string	Описание ссылки
`title`	string	Заголовок ссылки
`previewType`	string	Тип превью ссылки
`jpegThumbnail`	string	Превью изображения в `base64` кодировке

Пример тела ответа#

[
    {
        "idMessage": "DE8CFFA93B95237B077F8FA08331A0B5",
        "timestamp": 1587129319,
        "typeMessage": "textMessage",
        "chatId": "79001234567@c.us",
        "senderId": "79001234567@c.us",
        "senderName": "Николай",
        "textMessage": "Привет"
    },
    {
        "idMessage": "EA0BD1AE042DC4F3609867126309D67C",
        "timestamp": 1587147598,
        "typeMessage": "imageMessage",
        "chatId": "79001234567@c.us",
        "senderId": "79001234567@c.us",
        "senderName": "Николай",
        "downloadUrl": "https://api.green-api.com/waInstance1234/downloadFile/EA1BD1AE042DC4F3609867126309D67C",
        "caption": "Как тебе?"
    }
]

Ошибки LastIncomingMessages#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки

Пример кода на Python#

import requests

url = "https://api.green-api.com/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}"

payload = {}
headers= {}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))