Перейти к основному содержимому

Получить диалог

Получает информацию о диалоге по ID

Функция ПолучитьДиалог(Знач URL, Знач IDЧата, Знач Токен = "") Экспорт

ПараметрCLI опцияТипОбяз.Назначение
URL--urlСтрока✔URL внешнего вебхука или адрес Bitrix24 при использовании токена
IDЧата--chatСтрока, Число✔ID чата (chatXXX) или пользователя (XXX) для диалога
Токен--tokenСтрока✖Токен авторизации, если используется не вебхук

Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrxi24


подсказка

Метод в документации API: im.dialog.get


Пример использования для 1С:Предприятие/OneScript
    URL    = "https://b24-ar17wx.bitrix24.by/rest/1/h0m...";
    IDЧата = "2948";

    OPI_ПреобразованиеТипов.ПолучитьСтроку(IDЧата);

    СтрокаЧата = "chat" + IDЧата;

    Результат = OPI_Bitrix24.ПолучитьДиалог(URL, СтрокаЧата);

    URL            = "b24-ar17wx.bitrix24.by";
    Токен          = "4f8db968006e9f06006b12e400000001000...";
    IDПользователя = 10;

    Результат = OPI_Bitrix24.ПолучитьДиалог(URL, IDПользователя, Токен);
    oint bitrix24 ПолучитьДиалог \
      --url "b24-ar17wx.bitrix24.by" \
      --chat 10 \
      --token ***
Результат
{
 "result": {
  "id": 10,
  "parent_chat_id": 0,
  "parent_message_id": 0,
  "name": "",
  "description": null,
  "owner": 10,
  "extranet": false,
  "avatar": "",
  "color": "#ab7761",
  "type": "private",
  "counter": 0,
  "user_counter": 0,
  "message_count": 647,
  "unread_id": 0,
  "restrictions": {
   "avatar": true,
   "rename": true,
   "extend": true,
   "call": true,
   "mute": true,
   "leave": true,
   "leave_owner": true,
   "send": true,
   "user_list": true
  },
  "last_message_id": 59260,
  "last_id": 3854,
  "marked_id": 0,
  "disk_folder_id": 0,
  "entity_type": "",
  "entity_id": "",
  "entity_data_1": "",
  "entity_data_2": "",
  "entity_data_3": "",
  "mute_list": [],
  "date_create": "2024-06-15T16:48:49+00:00",
  "message_type": "P",
  "public": "",
  "role": "member",
  "entity_link": {
   "type": "",
   "url": ""
  },
  "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": 10,
    "user_name": "Techno Pizza",
    "message_id": 3854,
    "date": null
   }
  ],
  "manager_list": [],
  "last_message_views": {
   "message_id": 59260,
   "first_viewers": [],
   "count_of_viewers": 0
  },
  "dialog_id": "10"
 },
 "time": {
  "start": 1757443337.10372,
  "finish": 1757443337.14831,
  "duration": 0.0445919036865234,
  "processing": 0.0183827877044678,
  "date_start": "2025-09-09T18:42:17+00:00",
  "date_finish": "2025-09-09T18:42:17+00:00",
  "operating_reset_at": 1757443937,
  "operating": 0
 }
}