Используйте этот метод для того, чтобы перевести тред от одного агента другому агенту или в очередь распределения.
Разрешения
---- Permissions:INTEGRATOR,OPERATOR,SUPERVISOR,BOT ----
Пример curl
$ curl 'http://localhost:8080/api/v1/threads/2/transfer' -i -X PUT \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <integrator_token>' \ -d '{ "transferMode" : "TO_FREE_SLOT", "userIds" : [ 1 ], "skillIds" : null, "unitIds" : null, "comment" : "comment" }'
/api/v1/threads/{threadId}/transfer
Параметр | Описание |
threadId | Внутренний идентификатор треда в edna Chat Center |
Пример HTTP запроса
PUT /api/v1/threads/2/transfer HTTP/1.1 Content-Type: application/json Authorization: Bearer <integrator_token> Content-Length: 124 Host: localhost: 8080 { "transferMode": "TO_FREE_SLOT", "userIds": [ 1 ], "skillIds": null, "unitIds": null, "comment": "comment" }
Поля тела запроса
Параметр | Тип | Описание |
transferMode | string (enum) | Один из следующих способов распределения: • TO_FREE_SLOT – Система пытается найти агентов с пустыми слотами. Если не находит – ошибка.• TO_READY_OPERATOR – Сперва система пытается найти агентов с пустыми слотами. Если система не находит такого агента, она попытается найти агента в статусе Ready и использовать его дополнительный слот (если разрешено). Если система не находит агента в статусе Ready – ошибка. Тред переводится в маршрутизацию, если система не находит агента или если использование дополнительных слотов не разрешено.• TO_ROUTING – Сперва система пытается найти агентов с пустыми слотами. Если она не находит такого агента, она пытается найти агента в статусе Ready и использовать его дополнительный слот (если разрешено). Тред переводится в маршрутизацию, если система не находит агента или если использование дополнительных слотов не разрешено. |
userIds | array of longs (необязательно) * | Список ID агентов, на которых вы хотите перевести тред. |
skillIds | array of longs (необязательно) * | Список ID навыков агентов, на которых вы хотите перевести тред. |
unitIds | array of longs (необязательно) * | Список ID отделов, куда вы хотите перевести тред. |
comment | string (необязательно) | Дополнительная информация о трансфере, которую вы хотите передать агенту. |
* Необходимо предоставить один из следующих параметров: userIds
, skillIds
, or unitIds
.
Пример HTTP ответа
HTTP/1.1 200 OK Vary: Origin Vary: Access-Control-Request-Method Vary: Access-Control-Request-Headers Content-Type: application/json Content-Length: 176 { "id": 2, "type": "NORMAL", "operator": { "id": 1, "name": null, "alias": null, "role": null, "maxThreads": null, "photoUrl": null } }
Поля тела ответа
Параметр | Тип | Описание |
id | long | Уникальный идентификатор треда в {edna} |
client | object | Объект, описывающий клиента, который инициировал тред |
state | string (enum) | Состояние треда |
channel | string (enum) | Тип канала клиента |
startTime | date | Дата и время создания треда |
stateChangeTime | date | Дата и время последней смены состояния треда |
lastMessageTime | date | Дата и время получения последнего сообщения в треде |
firstUnreadMessageTime | date | Дата и время получения первого несистемного сообщения |
assignTime | date | Дата и время присвоения треда текущему оператору |
unanswered | long | Количество неотвеченных сообщений в треде |
rule | string (enum) | Правило маршрутизации треда |
activeTasks | long | Количество активных заданий привязанных к треду |
hasMessagesFromOperator | boolean | Параметр, указывающий на существование сообщений в треде от любого оператора |
hasMessagesFromCurrentOperator | boolean | Параметр, указывающий на существование сообщений в треде от оператора, которому присвоен тред |
hasTags | boolean | Параметр, указывающий привязаны ли к треду теги |
type | string (enum) | Тип треда |
operator | object | Объект, описывающий оператора на которого назначен тред |
emailAccount | object | Объект, описывающий почтовый аккаунт, привязанный к треду |
messages | array of objects | Список сообщений треда |
unread | long | Количество непрочитанных сообщений в треде |
tags | array of objects | Список тегов, привязанных к треду |