Асинхронный Webim 2.0
В данной статье описан вывод Агента в каналы через асинхронный Webim 2.0 и возможности общения Агента в каналах при выводе через асинхронный Webim 2.0.
Webim — одна из популярных омниканальных платформ для общения с клиентами в текстовых каналах.
В данной статье рассмотрено подключение Агентов через асинхронный API – Webim External Bot API 2.0.
Webim может использоваться как сервис по подписке на облаке, так и быть размещен на частных серверах как коробочное решение. Адрес аккаунта Webim используется для настройки подключения Агента в качестве бота-оператора – см. раздел Подключение.
При использовании Webim как облачного сервиса по подписке адрес аккаунта Webim выглядит как <some-name>.webim.ru, где <some-name> – имя под-домена, которые установленный в настройках аккаунта Webim. Например, адрес может быть задан следующим образом: https://chatmeai006.webim.ru/.
При размещении Webim на частных серверах клиента адрес аккаунта устанавливается клиентом и зависит от домена размещения.
Подключение
Конфигурация на стороне Webim
В первую очередь необходимо произвести конфигурацию на стороне Webim.
Авторизуйтесь в Webim как администратор.
Перейдите в раздел Настройки → Боты.
Начните создавать нового бота и заполните следующие поля:
Оператор для бота — выберите оператора, к которому будет прикреплен бот. Для ботов рекомендуется создавать отдельных операторов.
Тип бота — выберите Умный бот.
Порядок сортировки — порядок определяет, на каком месте в списке ботов данный бот будет находиться. Чем меньше число, тем выше приоритет.
Статус — выберите статус бота.
Версия — выберите версию 2.
На этом конфигурация бота в Webim завершена.
Конфигурация канала Агента в Платформе
Для Агента необходимо создать и настроить Канал Агента с коннектором Omnichannel.
В появившемся окне перейдите на вкладку Channels для настройки каналов, далее:
выберите тип канала Omnichannel
Заголовки разных каналов агента могут совпадать.
Нажмите Save, чтобы сохранить Канал.
Все настройки будут применены только после сохранения.
Общение
Взаимодействие с Webim происходит через Webim External Bot API 2.0 и согласно настройкам вашего аккаунта Webim. Бот является ботом-оператором в Webim.
Маппинг канальных переменных из канала Webim2.0
| Канальная переменная | Переменная в теле входящего запроса из канала |
|---|---|
channel_conversation_id | chat.id |
channel_visitor_id | visitor.id |
channel_visitor_firstname | visitor.fields.name |
channel_visitor_lastname | — |
channel_visitor_account | visitor.fields.login |
channel_visitor_phone | visitor.fields.phone |
channel_visitor_email | visitor.fields.email |
channel_visitor_source | visitor.fields.site |
Возможности общения в канале Webim2.0
Функционал | Доступность | Описание |
Переменная channel_chat_id | Да | |
Агент может писать первым | Да | |
Кнопки | Да | Нажатие на кнопку приходит как текст лейбла кнопки |
Перевод на оператора | Нет | Не поддерживается в текущей реализации функционала Платформа. |
Передача файлов в виде файлов от Агента (слот Attachment) | Нет | |
Передача файлов в виде ссылок от Агента (слот Attachment) | Да | |
Получение файла от Собеседника в сценарий | Да | |
Доставка сообщений более 1000 символов от Агента до Собеседника | Да | |
Использование маркдауна | Нет |
Перевод на оператора
Не поддерживается для асинхронного API Webim в текущей реализации функционала Платформы.
Предлагается выполнять перевод на оператора с помощью External Request, используя соответствующий метод Webim External Bot API 2.0.
Last updated
