Просмотров: 17149
Дата последнего изменения: 17.11.2021
Александр Суворов
Сложность урока:
4 уровень - сложно, требуется сосредоточиться, внимание деталям и точному следованию инструкции.
1
2
3
4
5
Получение информации о диалоге
Ревизия
Получить информацию о текущей ревизии API (версии платформы) – im.revision.get
: 24
Параметры
Параметр
Пример
Обязат.
Описание
Ревизия
DIALOG_ID
chat29 или 256
Да
Идентификатор диалога. Формат: chatXXX – чат получателя, если сообщение для чата
или XXX – идентификатор получателя, если сообщение для приватного диалога
extranet – признак участия в чате внешнего экстранет-пользователя (true/false)
color – цвет чата в формате hex
avatar – ссылка на аватар (если пусто, значит аватар не задан)
type – тип чата (групповой чат, чат для звонка, чат открытой линии и тд)
entity_type – внешний код для чата – тип
entity_id – внешний код для чата – идентификатор
entity_data_1 – внешние данные для чата
entity_data_2 – внешние данные для чата
entity_data_3 – внешние данные для чата
date_create – дата создания чата в формате АТОМ
message_type – тип сообщений чата
Пример ответа при возникновения ошибки
{
"error": "DIALOG_ID_EMPTY",
"error_description": "Dialog ID can't be empty"
}
Описание ключей:
error – код возникшей ошибки
error_description – краткое описание возникшей ошибки
Возможные коды ошибок
Код
Описание
DIALOG_ID_EMPTY
Не передан идентификатор диалога
ACCESS_ERROR
Текущий пользователь не имеет прав доступа к диалогу
Обратите внимание! Метод указан с использованием функции restCommand - это метод отправки данных в Битрикс24, данный метод есть в примере ЭхоБота, и представлен здесь в качестве примера. Вы можете использовать свою функцию или javascript-метод BX24.callMethod или bitrix24-php-sdk.