метод REST scope: imconnector

imconnector.chat.name.set

Установить новое имя чата

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

Описание

Метод imconnector.chat.name.set устанавливает новое имя чата.

Метод работает только в контексте приложения.

Параметры

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

Строковый код коннектора, который задали в параметре ID при вызове imconnector.register

LINE integer обязательный

Идентификатор открытой линии

Идентификатор можно получить методами imopenlines.config.get и imopenlines.config.list.get

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

Идентификатор чата во внешней системе

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

Новое имя чата

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

Идентификатор пользователя. Параметр является обязательным только для коннекторов без групповых чатов с внешней стороны. У такого коннектора в методе imconnector.register параметр CHAT_GROUP должен быть равен false

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"CONNECTOR":"connector","LINE":105,"CHAT_ID":"47e007b1-ee15-43db-bcba-1c26e5884d3f","NAME":"Новое имя диалога","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/imconnector.chat.name.set

Ответ

HTTP-статус: 200

{
    "result": {
        "SUCCESS": true,
        "DATA": {
            "RESULT": {}
        }
    },
    "time": {
        "start": 1732110908.525962,
        "finish": 1732110908.879113,
        "duration": 0.3531508445739746,
        "processing": 0.07694888114929199,
        "date_start": "2024-11-20T15:55:08+02:00",
        "date_finish": "2024-11-20T15:55:08+02:00"
    }
}

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

result object

Результат установки имени чата (подробное описание)

time time

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

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

HTTP-статус: 400

{
    "error": "NOT_ACTIVE_LINE",
    "error_description": "Линия c таким ID неактивна или не существует"
}
Код Описание Значение
400 NOT_ACTIVE_LINE Линия c таким ID неактивна или не существует
400 IMCONNECTOR_NO_CORRECT_PROVIDER Не удалось найти подходящий провайдер для коннектора
400 ERROR_ARGUMENT Не указаны обязательные параметры NAME, CHAT_ID, USER_ID, CONNECTOR или LINE
400 CHAT_RENAMING_FAILED Не удалось переименовать чат

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

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