selectDestination
Выбор собеседником, либо внутренней логикой конкретного TouchPoint Gateway направления маршрутизации обращения.
Согласно архитектуре у каждой точки контакта может быть несколько (но не менее одной) групп/отделов, в которые добавляются сотрудники. Обычно сотрудники таким образом разделяются на области компетенции, например, на отдел продаж и поддержку. Выбор направления, это по сути выбор группы сотрудников, в которую в итоге обратится пользователь за консультацией.
В некоторых случаях выбор направления может быть реализован посредством специальных возможностей самого канала, например, в Telegram для этого есть KeyboardButton. Выбор направления маршрутизации может происходить как реакция на оповещение о необходимости выбрать направление SelectDestination. Также, направление можно выбрать и не дожидаясь сообщений от пользователя, как бы ожидая, что в дальнейшем он может обратиться к сотруднику.
То есть, если направление не выбрано или сделанный ранее выбор уже не действует, то система LiveTex посредством Webhook оповестит TouchPoint Gateway о необходимости сделать выбор, прислав в оповещении варианты.
Выбор направления действует до того момента, как сотрудник закроет обращение у себя в приложении.
Обратите внимание: Если сотрудник не закрыл обращение и завершил работу приложения, то выбранное направление будет продолжать действовать и все сообщения пользователя получит этот же сотрудник, но только по возвращению в приложение.
Пример
curl -X POST -d '{"user_id": "<user_id>", "destination_type": "Department", "destination_id": "<touchpoint_id>"}' \
https://messaging.livetex.ru/<version>/selectDestination?key=<authentication_key>
Формат запроса
| Имя | Тип | Обязательный | Комментарий |
| user_id | String | Да | Идентификатор собеседника в точке контакта. Задается и контролируется на стороне разработчика, который использует Messaging API. LiveTex не устанавливает идентификаторы пользователей автоматически. |
| destination_type | String | Да | Тип направления маршрутизации. На данный момент доступно только значение “Department”. |
| destination_id | String | Да | Идентификатор направления маршрутизации |
| name | String | Нет | Имя собеседника. Если не значение передано, то оператор увидит "Гость" в качестве имени. |
| attributes | Map |
Нет | Набор кастомных атрибутов, которые будут переданы сотруднику |
| hidden_attributes | Map |
Нет | Набор кастомных атрибутов, которые НЕ будут переданы сотруднику. Атрибуты будут доступны только при просмотре истории обращений в личном кабинете и в выгрузке обращений. |
Формат ответа
| Имя | Тип | Обязательный | Комментарий |
| success | Boolean | Да | Проверка успешности выполнения запроса |
| error_message | String | Нет | Описание ошибки |
| error_code | Integer | Нет | Код ошибки. Для возможности интернационализации |