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 Нет Код ошибки. Для возможности интернационализации