Просмотров: 3296
Дата последнего изменения: 19.11.2021
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
4
5
Переключение разговора на конкретного оператора |
Ревизия
Получить информацию о текущей ревизии API (версии платформы) – im.revision.get
: 1 |
Внимание! Для использования методов IMOPENLINES REST необходимо помимо прав на
imbot (Создание и управление чат-ботами) иметь доступ к scope
imopenlines (Открытые линии).
Параметры
Параметр |
Пример |
Обязат. |
Описание |
Ревизия |
CHAT_ID |
112 |
Да |
Идентификатор чата |
1 |
USER_ID |
12 |
Да |
Идентификатор пользователя, на которого осуществляется перенаправление |
1 |
LEAVE |
N |
Да |
Y/N. Если указано N - чат-бот не покинет данный чат после переадресации и будет присутствовать до момента подтверждения пользователя |
1 |
|
Примечание: Вместо USER_ID
можно указать QUEUE_ID
для переключения на другую открытую линию.
Вызов метода и ответ
PHP
$result = restCommand('imopenlines.bot.session.transfer', Array(
'CHAT_ID' => 112,
'USER_ID' => 12,
'LEAVE' => 'N'
), $_REQUEST["auth"]);
Пример ответа
{
"result": true
}
Результат выполнения:
true
или ошибка.
Пример ответа при возникновении ошибки
{
"error": "CHAT_ID_EMPTY",
"error_description": "Не передан идентификатор чата"
}
Описание ключей:
error
– код возникшей ошибки
error_description
– краткое описание возникшей ошибки
Возможные коды ошибок
Код |
Описание |
CHAT_ID_EMPTY |
Не передан идентификатор чата. |
USER_ID_EMPTY |
Не передан идентификатор пользователя, на которого необходимо переадресовать разговор. |
WRONG_CHAT |
Указан некорректный идентификатор пользователя или этот пользователь является чат-ботом или экстранет пользователем. |
BOT_ID_ERROR |
Неправильный идентификатор чат-бота. |
|