Вывод Агента в омниканальные платформы

icon picker
Chat2Desk

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

Подключение

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

Зайдите в аккаунт
Перейдите в раздел Настройки - API ​
%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8+_+API+-+Google+Chrome+2021-12-01+17.50.2.png
Нажмите “Показать” API-токен и введите пароль учетной записи администратора аккаунта ​
Настройки _ API - Google Chrome 2021-12-07 17.02.0.png
Скопируйте полученный API-токен ​
%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8+_+API+-+Google+Chrome+2021-12-01+17.54.2.png

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

@Агент
у необходимо создать и настроить
@Канал Агента
с
@Коннектор
ом “Chat2Desk”.
Войдите в меню редактирования (Edit) настроек вашего
@Агент
а
image.png
В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
выберите тип канала Omnichannel
Нажмите кнопку Add channel ​
Снимок экрана 2023-07-03 в 17.59.51.png
Выберите в поле Channel
@Коннектор
“Chat2Desk”. ​
image.png
Поле URL в разделе Channel webhook доступно для редактирования, например, для изменения домена .com на .kz для работы с казахстанской версией сайта Chat2Desk.
По необходимости пропишите заголовок для данного
@Канал Агента
в поле Title. ​
image.png
После выбора “Chat2Desk” в поле Channel webhook: Token будет указан автоматически сгенерированный токен, который необходимо заменить на API-токен,
Снимок экрана 2023-07-10 в 17.29.05.png
Примечание: Chatbot webhook: Token и Channel webhook: Token синхронизированы и будут идентичны, но поле Chatbot webhook: Token защищено от редактирования. Вы можете заменить токен на произвольный, установив новый токен в поле Channel webhook: Token или сгенерировать новый кнопкой Generate New
Активируйте канал переключением тумблера для того, чтобы
@Агент
начал отвечать в нем.
Если
@Агент
не был обучен, появится предупреждение. В таком случае необходимо обучить
@Агент
а, после чего повторить попытку активации
@Канал Агента
.
image.png
После активации
@Канал Агента
, если есть проблемы с его доступностью, будет выведено предупреждение (
@Канал Агента
будет активирован несмотря на проблемы):
"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
image.png
Couldn’t register agent webhook” — выводится в случае, если не удалось зарегистрировать вебхук в удаленном канале.
image.png
Сохраните
@Канал Агента
— нажмите Save.
Важно: Все настройки будут применены только после сохранения.

Общение

Маппинг Канальных переменных из канала Chat2Desk
Канальная переменная
Конечный канал
Переменная в теле входящего запроса из канала
Особенности
1
channel_message_id
Chat2Desk
message_id
id сообщения, которое присвоил ему Chat2Desk (реализовано только в C2D)
2
channel_message_recipient
Chat2Desk
operator_id
Бот в Chat2Desk является оператором и в эту переменную вы получите его id (реализовано только в C2D)
3
channel_visitor_id
Chat2Desk
client_id
4
channel_conversation_id
Chat2Desk
dialog_id
5
channel_visitor_phone
Chat2Desk
client.phone
После отправки рассылки
@Слот
ом
@Notification
в эту переменную попадает номер телефона, на который была отправлена рассылка
6
channel_visitor_firstname
Chat2Desk
client.name
7
channel_visitor_lastname
Chat2Desk
нет
8
channel_visitor_account
Chat2Desk
нет
9
channel_visitor_email
Chat2Desk
нет
10
channel_visitor_source
Chat2Desk
нет
11
channel_visitor_auth
Chat2Desk
нет
12
channel_visitor_location
Chat2Desk
нет
13
channel_reply_to
Chat2Desk
нет
There are no rows in this table
Сервисные сообщения из Chat2Desk
Сообщение
Конечный канал
Client message
Описание
1
Закрытие диалога в Chat2Desk
Chat2Desk
Строка c2d: dialog closed
Сервисное сообщение поступает в
@client_message
при событии закрытии диалога в Chat2Desk через функцию Закрыть чат.
There are no rows in this table
Возможности общения в канале Chat2Desk
Функционал
Конечный канал
Наличие в канале
Описание
1
Использование маркдауна
Chat2Desk
Частично
Поддерживается в виджете. Отображение текста, размеченного с помощью
@Markdown
, в остальных каналах зависит от самих каналов.
Поддерживаются следующие типы разметки:
*курсив*
_курсив_
__жирный шрифт__
*__жирный курсив__*
[ссылка](http://www.example.com/)
2
channel_chat_id
Chat2Desk
Да
Формат: <client_id.channel_id>|chat2desk
3
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате
Chat2Desk
Да
Кейсы: Оператор принял и остался в чате - бот может написать собеседнику. Оператор принял и закрыл чат - бот может написать собеседнику.
4
Кнопки
Chat2Desk
Да
5
Перевод на оператора
Chat2Desk
Частично
- нет
- да
6
Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Chat2Desk
Да
В виджет приходит иконка, ведущая на ссылку вида , при переходе автоматически воспроизводится содержимое.
Изображения передаются в виде изображений.
7
Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Chat2Desk
Частично
Отображается аналогично переданному файлу, ссылка ведет на и файл автоматически открывается в браузере.
8
Получение файла от Собеседника в сценарий
Chat2Desk
Да
9
Получение геолокации от собеседника в сценарии
Chat2Desk
Нет
10
Доставка сообщений более 1000 символов от Агента до Собеседника
Chat2Desk
Да
11
Получить ссылку на источник лида
Chat2Desk
Нет
12
Рассылки с помощью Notification
Chat2Desk
Нет
There are no rows in this table

Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.