Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Создать чат im.chat.add». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Создать чат im.chat.add

Тут может не хватать некоторых данных — дополним в ближайшее время

• нужны правки под стандарт написания
• не указаны типы параметров
• отсутствуют примеры
• не прописаны ссылки на несозданные ещё страницы

> Scope: im
>
> Кто может выполнять метод: любой пользователь

Метод im.chat.add создаёт чат.

Практические примеры использования в коде

• PHP

    $result = restCommand(
        'im.chat.add',
        Array(
            'TYPE' => 'CHAT',
            'TITLE' => 'Мой новый закрытый чат',
            'DESCRIPTION' => 'Очень важный чат',
            'COLOR' => 'PINK',
            'MESSAGE' => 'Добро пожаловать в чат',
            'USERS' => Array(1,2),
            'AVATAR' => 'base64 image',
            'ENTITY_TYPE' => 'CHAT',
            'ENTITY_ID' => 13,
            'OWNER_ID' => 39,
        ),
        $_REQUEST["auth"]
    );

Ответ в случае успеха

{
    "result": 123
}

Ответ в случае ошибки

{
    "error": "USERS_EMPTY",
    "error_description": "Не переданы участники чата"
}

Описание ключей

• error – код возникшей ошибки
• error_description – краткое описание возникшей ошибки

Возможные коды ошибок