LastIncomingMessages#

Метод возвращает крайние входящие сообщения аккаунта. По умолчанию возвращаются последние сообщения за 24 часа.

Настройки

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

Полученные до включения настроек сообщения не попадут в журнал.

Применение настроек занимает до 5 минут.

Появление сообщений в журнале может занимать время до 2 минут, методы журналов необходимо использовать только для получения истории переписки. Для быстрого получения сообщений необходимо использовать систему уведомлений.

Метод возвращает только те сообщения, которые системе отдает WhatsApp.

Метод возвращает последние 10000 сообщений. Метод LastIncomingMessages возвращает только ту историю, которую системе отдает WhatsApp.

Запрос#

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

GET {{apiUrl}}/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}?minutes={{minutes_count}}

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

Параметры URL запроса#

Параметр	Тип	Обязательный	Описание
`minutes`	integer	нет	Время в минутах, за которое требуется показать сообщения (по умолчанию равно 1440 минут)

Ответ#

Поля ответа#

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

Поле	Тип	Описание
`type`	string	Вид сообщения, `incoming` - входящее сообщение
`idMessage`	string	Идентификатор входящего сообщения
`timestamp`	integer	Время принятия сообщения в UNIX-формате
`typeMessage`	string	Тип сообщения, возможные значения:
		`textMessage` - текстовое сообщение
		`imageMessage` - сообщение с изображением
		`videoMessage` - видео сообщение
		`documentMessage` - сообщение с файлом документа
		`audioMessage` - аудио сообщение
		`reactionMessage` - сообщение с реакцией
		`locationMessage` - сообщение геолокации
		`contactMessage` - сообщение с контактом
		`contactsArrayMessage` - сообщение с массивом контактов
		`extendedTextMessage` - сообщение со ссылкой и превью
		`templateMessage` - сообщение с шаблонными кнопками
		`templateButtonsReplyMessage` - ответ с фигурными кнопками
`chatId`	string	Идентификатор чата, в котором получено сообщение.
`senderId`	string	Идентификатор отправителя сообщения.
`senderName`	string	Имя отправителя сообщения
`senderContactName`	string	Имя отправителя из списка контактов текущего аккаунта
`isForwarded`	boolean	Флаг указывает является ли сообщение пересланным
`forwardingScore`	integer	Количество пересылок сообщения
`textMessage`	string	Текст сообщения, если `typeMessage`=`textMessage`
`downloadUrl`	string	Ссылка на скачивание файла, если `typeMessage` = `imageMessage` /`videoMessage`/`documentMessage`/`audioMessage`
`caption`	string	Описание файла, если `typeMessage` = `imageMessage`/`videoMessage` /`documentMessage`/`audioMessage`
`fileName`	string	Название файла, если `typeMessage` = `imageMessage`/`videoMessage` /`documentMessage`/`audioMessage`. Поле заполняется корректно только для `typeMessage` = `documentMessage`, в остальных случаях название файла генерируется автоматически
`jpegThumbnail`	string	Превью изображения в `base64` кодировке, если `typeMessage` = `imageMessage`/`videoMessage`/`documentMessage`/`audioMessage`
`mimeType`	string	Тип файла, согласно класификации Media Types, если `typeMessage` = `imageMessage`/`videoMessage`/`documentMessage`/`audioMessage`
`isAnimated`	boolean	Флаг указывает анимирован ли файл, если `typeMessage` = `imageMessage`/`videoMessage`/`documentMessage`/`audioMessage`
`location`	object	Объект о структуре локации, если `typeMessage` = `locationMessage`
`contact`	object	Объект о структуре контакта, если `typeMessage` = `contactMessage`
`contacts`	object	Объект о структуре контакта, если `typeMessage` = `contactsArrayMessage`

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

[
    {
        "type": "incoming",
        "idMessage": "9DB14F14A253D33F4A9CD84123456789",
        "timestamp": 1706522263,
        "typeMessage": "textMessage",
        "chatId": "120363153000000000@g.us",
        "textMessage": "Привет",
        "senderId": "70000000012@c.us",
        "senderName": "Николай",
        "senderContactName": "Коля"
    },
    {
        "type": "incoming",
        "idMessage": "EAAE5A5CD000000000",
        "timestamp": 1706601620,
        "typeMessage": "imageMessage",  //"videoMessage"/`documentMessage`/`audioMessage`
        "chatId": "120363153000000000@g.us",
        "downloadUrl": "https://api.greenwaba.com/waInstance1234/downloadFile/EA1BD1AE042DC4F3609867126309D67C.jpg",
        "caption": "Как тебе?",
        "fileName": "03963bac-6020-423c-80df-1aa123456789.jpg",
        "jpegThumbnail": "/9j/4AAQSkZJ/aAAgBAwEBPwCVYw//xAApEAACAx/2kOVh/VKAoAH/leFhX//+AAMA/9k=",
        "mimeType": "image/jpeg",
        "isAnimated": false,
        "isForwarded": true,
        "forwardingScore": 1,
        "senderId": "70000000012@c.us",
        "senderName": "Николай",
        "senderContactName": "Коля"
    },
    {
        "type": "incoming",
        "idMessage": "3A8427EF85F000000000",
        "timestamp": 1706674611,
        "typeMessage": "locationMessage",
        "chatId": "70000000012@c.us",
        "location": {
            "nameLocation": "Cafe",
            "address": "Астана",
            "jpegThumbnail": "/9j/4AAQSkZJRgABAQAASABIAAD/4QBYRX",
            "latitude": 51.1280000000000,
            "longitude": 71.4307620000000,
            "forwardingScore": 0,
            "isForwarded": false
        },
        "senderId": "70000000012@c.us",
        "senderName": "Николай",
        "senderContactName": "Коля"
    },
    {
        "type": "incoming",
        "idMessage": "3AA2C1D83560000000000",
        "timestamp": 1706675513,
        "typeMessage": "contactMessage",
        "chatId": "70000000012@c.us",
        "contact": {
            "displayName": "Виктор Петров",
            "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:;Виктор Петров;;;\nFN:Виктор Петров\nTEL;type=CELL;type=VOICE;waid=70000000013:+7 000 000-00-13\nEND:VCARD",
            "forwardingScore": 0,
            "isForwarded": false
        },
        "senderId": "70000000012@c.us",
        "senderName": "Николай",
        "senderContactName": "Коля"
    },
    {
        "type": "incoming",
        "idMessage": "3AA2C1D83560000000000",
        "timestamp": 1706675513,
        "typeMessage": "contactsArrayMessage",
        "chatId": "70000000012@c.us",
        "messageData": {
            "contacts": [
                {
                    "displayName": "Иван Иванов",
                    "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:;Иван Иванов;;;\nFN:Иван Иванов\nORG:Иван Иванов\nTITLE:\nTEL;type=Mobile:+7 912 345-56-78\nEND:VCARD",
                    "contextInfo": null
                },
                {
                    "displayName": "Василий",
                    "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:;Василий;;;\nFN:Василий\nTEL;type=Mobile;waid=79123456799:+7 912 345-67-99\nEND:VCARD",
                    "contextInfo": null
                }
                ],
            "forwardingScore": 0,
            "isForwarded": false
            },
        "senderId": "70000000012@c.us",
        "senderName": "Николай",
        "senderContactName": "Коля"
    }
]

Ошибки LastIncomingMessages#

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

Примеры кода#

PythoncURLJava - SpringJava - UnirestVBA

import requests

url = "{{apiUrl}}/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}?minutes=3240"

payload = {}
headers= {}

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

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

curl --location '{{apiUrl}}/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}?minutes=3240'

var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();
requestUrl
    .append({{apiUrl}})
    .append("/waInstance").append({{idInstance}})
    .append("/lastIncomingMessages/")
    .append({{apiTokenInstance}});

var response = restTemplate.exchange(requestUrl.toString(), HttpMethod.GET, null, String.class);
System.out.println(response);

var requestUrl = new StringBuilder();
requestUrl
    .append({{apiUrl}})
    .append("/waInstance").append({{idInstance}})
    .append("/lastIncomingMessages/")
    .append({{apiTokenInstance}});

var response = Unirest.get(requestUrl.toString())
    .header("Content-Type", "application/json")
    .asString();

System.out.println(response);

Sub LastIncomingMessages()
    Dim url As String
    Dim http As Object
    Dim response As String

    ' The idInstance and apiTokenInstance values are available in your account, double brackets must be removed
    url = "{{apiUrl}}/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}"

    Set http = CreateObject("MSXML2.XMLHTTP")

    http.Open "GET", url, False
    http.send

    response = http.responseText

    Debug.Print response

    ' Outputting the answer to the desired cell
    Range("A1").Value = response

    Set http = Nothing
End Sub