# im.dialog.messages.get URL: https://chugunov.pro/api-bitrix24/chats/messages/im-dialog-messages-get/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Получить список последних сообщений Scope: `im` Кто может выполнять метод: участник чата ## Описание Метод `im.dialog.messages.get` получает сообщения указанного диалога, в том числе системные. Не поддерживает стандартную постраничную навигацию из-за потенциально большого объема данных Получить сообщения без участия в чате можно только для чатов открытой линии через метод [imopenlines.session.history.get](https://chugunov.pro/api-bitrix24/imopenlines/openlines/sessions/imopenlines-session-history-get/) ## Параметры - `DIALOG_ID` `string` — обязательный. Идентификатор чата в формате: - `chatXXX` — чат - `sgXXX` — чат группы или проекта - `XXX` — идентификатор пользователя личного чата Идентификатор чата можно получить с помощью метода [im.chat.get](https://chugunov.pro/api-bitrix24/chats/im-chat-get/). Идентификатор пользователя — с помощью методов [user.get](https://chugunov.pro/api-bitrix24/user/user-get/) и [user.search](https://chugunov.pro/api-bitrix24/user/user-search/) - `LAST_ID` `integer` — необязательный. Идентификатор сообщения, относительно которого нужно загрузить более старые сообщения. Метод вернет сообщения с идентификатором меньше указанного. Чтобы последовательно загрузить историю назад, сначала запросите последние сообщения без `LAST_ID` и `FIRST_ID`. Затем передайте в `LAST_ID` минимальный `id` из полученного массива `messages` - `FIRST_ID` `integer` — необязательный. Идентификатор сообщения, относительно которого нужно загрузить более новые сообщения. Метод вернет сообщения с идентификатором больше указанного. Например, при `FIRST_ID=123` и `LIMIT=10` метод вернет до 10 сообщений с идентификатором больше `123`. Чтобы получить сообщения, добавленные после уже загруженной выборки, передайте в `FIRST_ID` максимальный `id` из полученного массива `messages` - `LIMIT` `integer` — необязательный. Ограничение на количество сообщений в ответе. Если не переданы `LAST_ID` и `FIRST_ID` — метод вернет последние сообщения диалога с учетом `LIMIT`. Метод может вернуть больше сообщений, чем указано в `LIMIT`, если в чате есть непрочитанные сообщения. По умолчанию — `20`. Максимальное значение — `50` ## Ответ HTTP-статус: 200 ```json { "result": { "chat_id": 1489, "messages": [ { "id": 84877, "chat_id": 1489, "author_id": 503, "date": "2026-03-04T09:43:26+03:00", "text": "Рады тебе очень!", "unread": false, "uuid": "0c42a08f-4235-49fc-994f-c9bccd499ac1", "replaces": [], "params": { "LIKE": [547], "FILE_ID": [5255] }, "disappearing_date": null }, { "id": 84875, "chat_id": 1489, "author_id": 503, "date": "2026-03-04T09:43:21+03:00", "text": "Привет, Анна! Здесь будем обсуждать проект.", "unread": false, "uuid": "db2e826a-dd18-4ab5-b76c-4084e106ee28", "replaces": [], "params": [], "disappearing_date": null }, { "id": 84869, "chat_id": 1489, "author_id": 0, "date": "2026-03-04T09:42:31+03:00", "text": "[USER=503 REPLACE]Иван Иванов[/USER] пригласил в чат [USER=547 REPLACE]Анна Петрова[/USER]", "unread": false, "uuid": null, "replaces": [], "params": { "CODE": ["CHAT_JOIN"], "NOTIFY": "N" }, "disappearing_date": null } ], "users": [ { "id": 503, "active": true, "name": "Иван Иванов", "first_name": "Иван", "last_name": "Иванов", "work_position": "админ", "color": "#4ba984", "avatar": "https://mysite.ru/upload/resize_cache/main/avatar.jpg", "avatar_hr": "https://mysite.ru/upload/resize_cache/main/avatar.jpg", "gender": "M", "birthday": "", "extranet": false, "network": false, "bot": false, "connector": false, "external_auth_id": "socservices", "status": "online", "idle": false, "last_activity_date": "2026-03-04T10:13:14+03:00", "mobile_last_date": false, "desktop_last_date": false, "absent": false, "departments": [667], "phones": false, "bot_data": null, "type": "user", "website": "", "email": "ivanov@mysite.ru" }, { "id": 547, "active": true, "name": "Анна Петрова", "first_name": "Анна", "last_name": "Петрова", "work_position": "Менеджер", "color": "#df532d", "avatar": "", "avatar_hr": "", "gender": "F", "birthday": "", "extranet": false, "network": false, "bot": false, "connector": false, "external_auth_id": "default", "status": "online", "idle": false, "last_activity_date": "2026-03-04T10:11:02+03:00", "mobile_last_date": false, "desktop_last_date": false, "absent": false, "departments": [667], "phones": false, "bot_data": null, "type": "user", "website": "", "email": "petrova@mysite.ru" } ], "files": [ { "id": 5255, "chatId": 1489, "date": "2026-03-04T09:43:27+03:00", "type": "image", "name": "image.png", "extension": "png", "size": 2144, "image": { "height": 61, "width": 72 }, "status": "done", "progress": 100, "authorId": 503, "authorName": "Иван Иванов", "urlPreview": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=5255&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png", "urlShow": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.showImage&SITE_ID=s1&humanRE=1&fileId=5255&width=1280&height=1280&signature=4b6b2bbba680d3bccd8b70e398d94c1c3cfcb018f813089c32db3bb25df594f5&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png", "urlDownload": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=5255&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png", "viewerAttrs": { "viewer": "", "viewerType": "image", "src": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=5255&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png", "viewerResized": "", "objectId": "5255", "viewerGroupBy": "1489", "imChatId": 1489, "title": "image.png", "actions": "[{\"type\":\"download\"},{\"type\":\"copyToMe\",\"text\":\"Сохранить на Диск\",\"action\":\"BXIM.disk.saveToDiskAction\",\"params\":{\"fileId\":\"5255\"},\"extension\":\"disk.viewer.actions\",\"buttonIconClass\":\"ui-btn-icon-cloud\"}]" }, "mediaUrl": { "preview": { "250": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=5255&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png" } }, "isTranscribable": false, "isVideoNote": false, "isVoiceNote": false } ] }, "time": { "start": 1772608704, "finish": 1772608704.545697, "duration": 0.5456969738006592, "processing": 0, "date_start": "2026-03-04T10:18:24+03:00", "date_finish": "2026-03-04T10:18:24+03:00", "operating_reset_at": 1772609304, "operating": 0 } } ``` ### Возвращаемые данные - `result` `object`. Корневой элемент ответа [(подробное описание)](#result) - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "error": "DIALOG_ID_EMPTY", "error_description": "Dialog ID can't be empty" } ``` - `400` — `DIALOG_ID_EMPTY`. Dialog ID can't be empty - `400` — `FIRST_ID_STRING`. First ID can't be string - `400` — `LAST_ID_STRING`. Last ID can't be string - `403` — `ACCESS_ERROR`. You do not have access to the specified dialog ## Примеры запроса ### cURL (Webhook) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"DIALOG_ID":"chat1489","FIRST_ID":84869,"LIMIT":10}' \ https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.dialog.messages.get ``` ### cURL (OAuth) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"DIALOG_ID":"chat1489","FIRST_ID":84869,"LIMIT":10,"auth":"**put_access_token_here**"}' \ https://**put_your_bitrix24_address**/rest/im.dialog.messages.get ``` ### JS (TS) ```ts // This snippet is an ES module: top-level await requires type="module" or a bundler. // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide). import { Text } from '@bitrix24/b24jssdk' import type { B24Frame, ISODate } from '@bitrix24/b24jssdk' declare const $b24: B24Frame // Shape of the payload returned in result (match the "response handling" section of the page) type DialogMessagesGetResult = { chat_id: number messages: { id: number chat_id: number author_id: number date: ISODate text: string unread: boolean uuid: string | null replaces: unknown[] params: Record disappearing_date: ISODate | null }[] users: { id: number active: boolean name: string first_name: string last_name: string status: string last_activity_date: ISODate type: string }[] files: { id: number chatId: number date: ISODate type: string name: string size: number status: string authorId: number authorName: string urlDownload: string isTranscribable: boolean isVideoNote: boolean isVoiceNote: boolean }[] } try { const response = await $b24.actions.v2.call.make({ method: 'im.dialog.messages.get', params: { DIALOG_ID: 'chat1489', FIRST_ID: 84869, LIMIT: 10, }, requestId: Text.getUuidRfc4122() }) // The payload is available only on a successful response if (!response.isSuccess) { console.error(response.getErrorMessages().join('; ')) } else { const result = response.getData()!.result console.info(result.chat_id, result.messages.length, result.messages) } } catch (error) { // Thrown on transport or SDK failures (AjaxError, SdkError, etc.) console.error(error) } ``` ### JS (UMD) ```html ``` ### Python ```python from b24pysdk.errors import BitrixAPIError, BitrixSDKException try: bitrix_response = client.im.dialog.messages.get( dialog_id="chat1489", first_id=84869, limit=10, ).response result = bitrix_response.result print(result) except BitrixAPIError as error: print( "Ошибка Bitrix API", f"error: {error.error}", f"error_description: {error.error_description}", sep="\n", ) except BitrixSDKException as error: print(f"Ошибка Bitrix SDK: {error.message}") except Exception as error: print(f"Непредвиденная ошибка: {error}") ``` ### PHP ```php try { $response = $b24Service->core->call( 'im.dialog.messages.get', [ 'DIALOG_ID' => 'chat1489', 'FIRST_ID' => 84869, 'LIMIT' => 10, ] ); $result = $response->getResponseData()->getResult(); print_r($result); } catch (Throwable $e) { error_log($e->getMessage()); } ``` ### BX24.js ```js BX24.callMethod( 'im.dialog.messages.get', { DIALOG_ID: 'chat1489', FIRST_ID: 84869, LIMIT: 10 }, function(result) { if (result.error()) { console.error(result.error()); } else { console.log(result.data()); } } ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'im.dialog.messages.get', [ 'DIALOG_ID' => 'chat1489', 'FIRST_ID' => 84869, 'LIMIT' => 10, ] ); print_r($result); ``` ### Go ```go // client и ctx уже созданы — см. раздел «SDK для Go» res, err := client.Core().Call(ctx, "im.dialog.messages.get", b24.Params{ "DIALOG_ID": "chat1489", "FIRST_ID": 84869, "LIMIT": 10, }, b24.WithIdempotent()) if err != nil { return fmt.Errorf("im.dialog.messages.get: %w", err) } // Ответ приходит как json.RawMessage — разберите его // в структуру под форму ответа, показанную ниже на этой странице. fmt.Printf("%s\n", res.Result) ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/chats/messages/im-dialog-messages-get.html