Вывод Агента в каналы через Chat2Desk

В данной статье описан вывод Агента в каналы через Chat2Desk и возможности общения Агента в каналах при выводе через Chat2Desk.

Chat2Desk — одна из омниканальных платформ для общения с клиентами в текстовых каналах. Вы можете использовать её в качестве канала для публикации вашего Агента в качестве бота-оператора. Ознакомиться с пользовательской документацией вы можете по этой ссылке.

Подключение

Конфигурация на стороне Chat2Desk

  1. Зайдите в аккаунт Chat2Desk

Конфигурация канала Агента в Платформе

Агенту необходимо создать и настроить канал Агента с коннектором Chat2Desk.

  1. В появившемся окне перейдите на вкладку Channels для настройки каналов, далее:

    1. выберите тип канала Omnichannel

  2. Поле URL в разделе Channel webhook доступно для редактирования, например, для изменения домена .com на .kz для работы с казахстанской версией сайта Chat2Desk.

    1. Заголовки разных каналов агента могут совпадать.

  3. После активации Канала Агента, если есть проблемы с его доступностью, будет выведено предупреждение (Канал будет активирован несмотря на проблемы):

  4. Сохраните канал Агента — нажмите Save.

Все настройки будут применены только после сохранения.

Общение

Сервисные сообщения канала

Из Chat2Desk передаются следующие сервисные сообщения:

СообщениеШаблон в client_messageОписание

Закрытие диалога в Chat2Desk

Строка c2d: dialog closed

Сервисное сообщение поступает в переменную client_message при событии закрытии диалога в Chat2Desk через функцию Закрыть чат.

Маппинг Канальных переменных из канала Chat2Desk

Канальная переменнаяПеременная в теле входящего запроса из каналаОсобенности

channel_message_id

message_id

id сообщения, которое присвоил ему Chat2Desk (реализовано только в C2D)

channel_message_recipient

operator_id

Бот в Chat2Desk является оператором и в эту переменную вы получите его id (реализовано только в C2D)

channel_visitor_id

client_id

channel_conversation_id

dialog_id

channel_visitor_phone

client.phone

channel_visitor_firstname

client.name

channel_visitor_lastname

channel_visitor_account

channel_visitor_email

channel_visitor_source

channel_visitor_auth

channel_visitor_location

Возможности общения в Chat2Desk

ФункционалНаличие в каналеОписание

Использование маркдауна

Частично

Поддерживается в виджете. Отображение текста, размеченного с помощью Markdown, в остальных каналах зависит от самих каналов. Поддерживаются следующие типы разметки:

*курсив* _курсив_ __жирный шрифт__ *__жирный курсив__* [ссылка](http://www.example.com/

Переменная channel_chat_id

Да

Формат: 500482964|chat2desk

Сообщения дойдут до собеседника, если агент напишет первый в существующем чате

Да

Кейсы: Оператор принял и остался в чате - бот может написать собеседнику. Оператор принял и закрыл чат - бот может написать собеседнику.

Кнопки

Да

Перевод на оператора

Частично

Только через External Request

Передача файлов в виде файлов от Агента (слот Attachment)

Да

В виджет приходит иконка, ведущая на ссылку вида https://storage.chat2desk.com/companies/company_236200/messages/199219/Kalimba.mp3, при переходе автоматически воспроизводится содержимое. Примечание: из-за особенностей передачи файлов и работы API, картинки, переданные в Telegram из C2D, не отображаются.

Передача файлов в виде ссылок от Агента (слот Attachment)

Частично

Отображается аналогично переданному файлу, ссылка ведет на storage.chat2desk.com и файл автоматически открывается в браузере. Примечание: не отображается в Telegram.

Получение файла от Собеседника в сценарий

Да

Формат: file:photo|https://storage.chat2desk.com//companies/company_236200/messages/169029/9ac926de046179b3.png

Получение геолокации от собеседника в сценарии

Нет

Доставка сообщений более 1000 символов от Агента до Собеседника

Да

Получить ссылку на источник лида

Нет

Last updated