GetMessages#

Метод предназначен для получения списка сообщений по ID чата или точному списку ID сообщений.

Запрос#

Поля запроса#

Поле	Тип	Обязательный	Описание
`chat_id`	integer	Да*	Идентификатор чата (обязательно, если не указан `MessageIDs`)*
`message_ids`	array	Да*	Массив точных идентификаторов сообщений (обязательно, если нет `chat_id`)*
`from`	integer	Нет	Время начала для запрашиваемых сообщений (в формате Unix timestamp)
`to`	integer	Нет	Время окончания для запрашиваемых сообщений (в формате Unix timestamp)
`count`	integer	Нет	Максимальное количество сообщений в ответе (по умолчанию 50)

Пример запроса#

GolangPythonTypeScript

Получение всех сообщений чата:

response, err := bot.Messages.GetMessages(
    context.Background(), 
    models.GetMessagesReq{
        ChatID: 123456,
    }
)

Получение списка выбранных сообщений:

response, err := bot.Messages.GetMessages(
    context.Background(), 
    models.GetMessagesReq{
        MessageIDs: [
            "mid.000000000782a4e0019d002654056aed",
            "mid.000000000782a4e0019d0004e58330de",
            "mid.000000000782a4e0019d0004e3424fbd"
        ]
    }
)

Синхронный метод:

response = bot.messages.GetMessages(GetMessagesReq(
    chat_id=123456
))

Асинхронный метод:

response = await bot.messages.GetMessagesAsync(GetMessagesReq(
    message_ids=[
        "mid.000000000782a4e0019d002654056aed",
        "mid.000000000782a4e0019d0004e58330de",
        "mid.000000000782a4e0019d0004e3424fbd"
    ]
))

Получение всех сообщений чата:

const request: GetMessagesReq = { 
    chat_id: 123
}
const response = await bot.messages.getMessages(request)

Получение списка выбранных сообщений:

const request: GetMessagesReq = { 
    message_ids: [
        "mid.000000000782a4e0019d002654056aed",
        "mid.000000000782a4e0019d0004e58330de",
        "mid.000000000782a4e0019d0004e3424fbd"
    ]
}
const response = await bot.messages.getMessages(request)

Ответ#

Поля ответа#

Поле	Тип	Описание
`messages`	array	Массив объектов сообщений

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

{
        "recipient": {
            "chat_id": 123456789,
            "chat_type": "dialog",
            "user_id": 111222333
        },
        "timestamp": 1773835378770,
        "body": {
            "mid": "mid.000000000782a4e0019d00d3e0525a17",
            "seq": 116250075383093783,
            "text": "Hello!"
        },
        "sender": {
            "user_id": 987654321,
            "first_name": "Jane",
            "last_name": "",
            "is_bot": false,
            "last_activity_time": 1773838157000,
            "name": "Jane"
        }
    },
    {
        "recipient": {
            "chat_id": 123456789,
            "chat_type": "dialog",
            "user_id": 987654321
        },
        "timestamp": 1773824005332,
        "body": {
            "mid": "mid.000000000782a4e0019d002654d46aec",
            "seq": 116249330013465324,
            "text": "What's up?"
        },
        "sender": {
            "user_id": 111222333,
            "first_name": "GREEN-API test",
            "username": "id5047259512_1_bot",
            "is_bot": true,
            "last_activity_time": 1773838164201,
            "name": "GREEN-API test"
        }
    },
    {
        "recipient": {
            "chat_id": 123456789,
            "chat_type": "dialog",
            "user_id": 111222333
        },
        "timestamp": 1773824005125,
        "body": {
            "mid": "mid.000000000782a4e0019d002654056aed",
            "seq": 116249329999899373,
            "text": "Wanna hang out?"
        },
        "sender": {
            "user_id": 987654321,
            "first_name": "Jane",
            "last_name": "",
            "is_bot": false,
            "last_activity_time": 1773838157000,
            "name": "Jane"
        }
    }