Webim (Custom Channel API) как операторский канал
Webim — платформа онлайн-консультирования, которая позволяет общаться через различные каналы: чат на сайте, мессенджеры, социальные сети, чат-боты, мобильные приложения и другие. Платформа также интегрируется с системами CRM и HelpDesk.
Чтобы настроить Webim как операторский канал:
- Создайте канал в Webim.
- Создайте операторский канал в JAICP.
- Подключите операторский канал к входящему.
- Настройте перевод на оператора или группу операторов в сценарии
Создание канала в Webim
-
Авторизуйтесь в личном кабинете платформы Webim как администратор аккаунта.
-
Перейдите на страницу Настройки → Общие → Каналы общения.
-
В секции Произвольный, нажмите Добавить канал.
-
Заполните настройки произвольного канала:
-
Название — укажите название, которое будет отображаться в интерфейсе оператора.
-
Ваш секретный ключ — придумайте и введите секретный ключ. Он будет использоваться платформой Webim для отправки сообщения.
-
Адрес сервера — укажите адрес сервера, куда будут отправляться события о новых сообщениях в формате:
https://{имя_хоста}/chatapi/webhook/webim/{идентификатор_канала}
https://bot.jaicp.com/chatapi/webhook/webim/3899495ffd6f48e9aeaec
— пример адреса сервера. -
Выбор отдела — укажите параметры перевода диалога на операторский отдел:
-
Не нужен — при переводе на оператора отдел можно не указывать. В выпадающем списке ниже выберите отдел по умолчанию. Также можно выбрать вариант Без отдела — тогда диалоги будут по умолчанию переводиться в общую очередь.
-
Обязателен — отдел нужно указывать всегда. В выпадающем списке ниже выберите, на какие отделы разрешено переводить диалоги.
предупреждениеЕсли вы выберете Обязателен, но не зададите разрешенные отделы, бот не сможет переводить диалоги ни на какой отдел.
-
-
-
Скопируйте значения полей Наш секретный ключ и Идентификатор канала. Они понадобятся для подключения канала в JAICP.
- Наш секретный ключ используется, чтобы идентифицировать запросы к платформе Webim.
- Идентификатор канала используется, чтобы идентифицировать канал, с которого пришло сообщение.
-
Нажмите Сохранить.
Создание операторского канала
- Авторизуйтесь в платформе JAICP и перейдите в проект.
- Перейдите на вкладку Каналы.
- В разделе Операторы нажмите Подключить канал.
- Выберите Webim (Custom Channel API).
- Заполните поля:
- Название — укажите название канала.
- ID Канала — вставьте значение из поля Идентификатор канала.
- Входящий ключ — вставьте ключ из поля Ваш секретный ключ.
- Исходящий ключ — вставьте ключ из поля Наш секретный ключ.
- Имя аккаунта Webim — укажите название аккаунта. Вы можете скопировать его из адресной строки —
{имя_вашего_аккаунта}.webim.ru
.
Подключение входящего канала
- Выберите уже подключенный входящий канал или подключите новый.
- Перейдите в окно редактирования канала.
- В поле Оператор выберите операторский канал Webim и нажмите Сохранить.
Особенности сценария
Перевести диалог на оператора можно с помощью ответа бота с типом switch
.
Webim также поддерживает перевод диалога на группу операторов, закрепленных за определенным отделом.