метод REST scope: im

im.dialog.get

Получить данные о чате

Кто может выполнять: любой пользователь — участник чата

Описание

Метод im.dialog.get получает информацию о чате.

Параметры

DIALOG_ID string обязательный

Идентификатор чата в формате:
- chatXXX — чат
- sgXXX — чат группы или проекта
- XXX — идентификатор пользователя личного чата

Примеры: chat1435, sg103

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"DIALOG_ID":"chat1435"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.dialog.get

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 1439,
        "parent_chat_id": 0,
        "parent_message_id": 0,
        "name": "Чат по сделке",
        "description": "Здесь обсуждаем сделку",
        "owner": 503,
        "extranet": false,
        "avatar": "",
        "color": "#f76187",
        "type": "crm",
        "counter": 0,
        "user_counter": 3,
        "message_count": 3,
        "unread_id": 0,
        "restrictions": {
            "avatar": false,
            "rename": false,
            "extend": true,
            "call": true,
            "mute": true,
            "leave": true,
            "leave_owner": false,
            "send": true,
            "user_list": true,
            "path": "",
            "path_title": ""
        },
        "last_message_id": 84477,
        "last_id": 84477,
        "marked_id": 0,
        "disk_folder_id": 0,
        "entity_type": "CRM",
        "entity_id": "DEAL|1663",
        "entity_data_1": "",
        "entity_data_2": "",
        "entity_data_3": "",
        "mute_list": [],
        "date_create": "2026-02-25T16:50:58+03:00",
        "message_type": "C",
        "public": "",
        "role": "owner",
        "entity_link": {
            "type": "DEAL",
            "url": "/crm/deal/details/1663/",
            "id": "DEAL|1663"
        },
        "text_field_enabled": true,
        "background_id": null,
        "permissions": {
            "manage_users_add": "member",
            "manage_users_delete": "manager",
            "manage_ui": "member",
            "manage_settings": "owner",
            "manage_messages": "member",
            "can_post": "member"
        },
        "is_new": false,
        "readed_list": [
            {
                "user_id": 103,
                "user_name": "Иван Иванов",
                "message_id": 0,
                "date": null
            },
            {
                "user_id": 547,
                "user_name": "Петр Петров",
                "message_id": 0,
                "date": null
            }
        ],
        "manager_list": [
            503
        ],
        "last_message_views": {
            "message_id": 84477,
            "first_viewers": [],
            "count_of_viewers": 0
        },
        "dialog_id": "chat1439"
    },
    "time": {
        "start": 1772030091,
        "finish": 1772030091.165223,
        "duration": 0.1652228832244873,
        "processing": 0,
        "date_start": "2026-02-25T17:34:51+03:00",
        "date_finish": "2026-02-25T17:34:51+03:00",
        "operating_reset_at": 1772030691,
        "operating": 0
    }
}

Возвращаемые данные

result object

Корневой объект с данными чата (подробное описание)

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "DIALOG_ID_EMPTY",
    "error_description": "Dialog ID can't be empty"
}
Код Описание Значение
400 DIALOG_ID_EMPTY Dialog ID can't be empty
403 ACCESS_ERROR You do not have access to the specified dialog

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.