Chat2Desk

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

Подключение

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

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

  2. Перейдите в раздел Настройки - API

  3. Нажмите “Показать” API-токен и введите пароль учетной записи администратора аккаунта

  4. Скопируйте полученный API-токен

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

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

  1. Кликните по кнопке настроек Агента.

  2. Нажмите кнопку Add channel.

  3. Откроется панель выбора Конечный канал.

  4. Выберите Chat2Desk.

  5. Откроется панель создания Канал Проекта.

  6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.

  7. Пропишите ссылку https://api.chat2desk.com/v1 или https://api.chat2desk.kz/v1 в поле Chat2Desk webhook URL.

  8. Вставьте API-токен, скопированный в аккаунте Chat2Desk, в поле Chat2Desk token.

  9. Если необходимо настроить автоназначение чатов на конкретного оператора, вставьте id оператора в поле Chat2Desk operator ID. О том, как получить id оператора: Chat2Desk

  10. По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.

  11. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.

  12. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.

    1. Канал Проекта будет сохранен и активирован, если:

      1. Агент обучен;

      2. токен в поле Chat2Desk token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

    2. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.

  13. Для отмены создания Канал Проекта нажмите кнопку CANCEL.

Редактирование и удаление Канала Агента

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.

  1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.

  2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.

    1. Изменения будут применены, если:

      1. Агент обучен;

      2. токен в поле Chat2Desk token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

    2. Изменения не будут применены, если одно или больше условий не будут выполнены.

  3. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.

  4. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.

  5. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.

    1. Изменения будут применены и Канал Проекта будет активирован, если:

      1. Агент обучен;

      2. токен в поле Chat2Desk token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

    2. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.

  6. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.

  7. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.

Общение

Подключение Бота как оператора в Chat2Desk

В Chat2Desk возможно настроить автоназначение чатов на конкретного оператора. При выключенном автоназначении чаты поступают в общую очередь. Если необходимо, чтобы Бот обрабатывал только чаты, назначенные на конкретного оператора, нужно подключить Бота в качестве конкретного оператора и настроить назначение новых чатов на этого оператора. В случае, если в настройках Канал Проекта не указан id оператора, Бот будет принимать все сообщения из общей очереди, т.е. не распределенные на какого-либо конкретного оператора.Чтобы настроить подключение Бота в качестве оператора в Chat2Desk, необходимо:

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

  2. Перейти в раздел Настройки - Операторы - Список.

  3. Нажать кнопку Создать оператора.

  4. Заполнить все данные для нового оператора.

  5. Авторизоваться в качестве только что созданного оператора. Получить API-токен, как описано в шаге 3 раздела "Конфигурация бота на стороне Chat2Desk".

  6. Перейти в приложение Postman и отправить следующий запрос:

    1. Метод: GET

    2. Headers: Authorization: {API-токен из личного кабинета}

  7. В ответ на запрос будет получен список с информацией о всех операторов следующего формата: {"data":[{"id":id оператора,"email":"электронная почта","first_name":"имя","last_name":"фамилия","role":"роль","phone":"номер телефона","avatar":аватар,"last_visit":"время последнего логина в аккаунт","online":1, если оператор онлайн, 0, если оффлайн,"offline_type":null,"external_id":null,"opened_dialogs":количество открытых диалогов,"status_id":0}, {данные по следующему оператору}],"meta":{"total":количество операторов,"limit":лимит на количество операторов,"offset":0},"status":"success"}

  8. Необходимо найти информацию по оператору, созданному для подключения Бота, и скопировать значение параметра "id".

  9. Данное значение необходимо вставить в поле Chat2Desk operator ID настроек Канал Проекта Chat2Desk.

Переменная
Конечный канал
Переменная в запросе из канала
Примечания

message_id

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

operator_id

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

client.phone

После отправки рассылки Слотом Notification в эту переменную попадает номер телефона, на который была отправлена рассылка

Сообщение
Конечный канал
Client message
Описание

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

Строка c2d: dialog closed

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

Функционал общения
Конечный канал
Доступность в канале
Примечания

Частично

Поддерживается в виджете. Отображение текста, размеченного с помощью Markdown, в остальных каналах зависит от самих каналов.Поддерживаются следующие типы разметки:*курсив*_курсив___жирный шрифт__*__жирный курсив__*[ссылка](http://www.example.com/)

Да

Формат: <client_id.channel_id>|chat2desk

Да

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

Да

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

Частично

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

Да

Формат:

file:photo|https://storage.chat2desk.com//companies/company_236200/messages/169029/9ac926de046179b3.png

Last updated