Используйте этот метод для того, чтобы перевести тред от одного агента другому агенту или в очередь распределения.
Разрешения
---- 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 | Список тегов, привязанных к треду |