Вывод Агента в каналы через Webim
В данной статье описан вывод Агента в каналы через Webim и возможности общения Агента в каналах при выводе через Webim.
Webim — одна из популярных омниканальных платформ для общения с клиентами в текстовых каналах. Используя омниканальную платформу Webim, можно разместить Агент в одном или нескольких каналах общения. Webim имеет два API для работы с Агентами — синхронный (описан в данной статье) и асинхронный (см. Асинхронный Webim 2.0). Взаимодействие с конечным каналом “Webim” происходит в синхронном режим, с использованием Webim External Bot API 1.0.
Подключение
Конфигурация на стороне Webim
В первую очередь нужно произвести конфигурацию на стороне Webim.
Авторизуйтесь в Webim как администратор.
Перейдите в раздел Настройки → Боты.
Начните создавать нового бота и заполните следующие поля:
Оператор для бота — выберите оператора, к которому будет прикреплен бот, рекомендуется создавать отдельных операторов для ботов.
Тип бота — выберите Умный бот.
Порядок сортировки — порядок определяет, на каком месте в списке ботов данный бот будет находиться. Чем меньше число, тем выше приоритет.
Статус — выберите статус бота.
Версия — выберите версию 1.
На этом конфигурация бота в Webim завершена.
Конфигурация канала Агента в Платформе
Агенту необходимо создать и настроить канал Агента с коннектором Webim.
В появившемся окне перейдите на вкладку Channels для настройки каналов, далее:
выберите тип канала Omnichannel
Заголовки разных каналов агента могут совпадать.
Сохраните Канал Агента — нажмите Save.
Все настройки будут применены только после сохранения.
Общение
Взаимодействие с данным конечным каналом происходит по синхронному методу, с использованием Webim External Bot API 1.0. Так как конечный канал синхронный, то общение происходит по схеме Request от Webim — Response от Агента, что накладывает некоторые ограничения и особенности на общение:
Чтобы перевести на оператора с помощью Change Chat Mode, Change Chat Mode должен стоять обязательно после слота Wait For Reaction: в ответ на Response c сообщением собеседника будет отправлен Response c управляющей командой перевода диалога на оператора
Агент может только отвечать на сообщения, но не может первым отправлять сообщения в Чат данного конечного канала через слот Timer или Incoming Request, так как в этом случае от Webim не будет Request, на который можно дать Response.
Важно: при срабатывании Incoming Request или Timer Агент начнет соответствующие ветки Сценария и пойдет по Сценарию, остановившись на слоте ожидания ввода, при этом, отправленные до этого слота сообщения фактически не будут доставлены Собеседнику.
Маппинг Канальных переменных из канала Webim
Канальная переменная | Переменная в теле входящего запроса из канала |
---|---|
channel_conversation_id | chat.id |
channel_visitor_id | visitor.id |
channel_visitor_firstname | visitor.firstname |
channel_visitor_lastname | visitor.lastname |
channel_visitor_account | visitor.username |
channel_visitor_phone | visitor.phone |
channel_visitor_email | visitor.email |
channel_visitor_location | visitor.location |
Возможности общения в канале Webim
Функционал | Наличие в канале | Описание |
---|---|---|
Передача файлов в виде файлов от Агента (слот Attachment) | Да | |
Переменная channel_chat_id | Да | формат |
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате | Частично | Диалог в Webim длится 24 часа, сообщения дойдут до Собеседника только в течение этого времени |
Перевод на оператора | Да | C помощью слота Change Chat Mode Важно: перед Change Chat Mode обязательно должен находиться Wait For Reaction. Перевод на оператора также произойдет автоматически, если Webim не получит ответа от Агента в течение 5 секунд. |
Кнопки | Да | |
Передача файлов в виде ссылок от Агента (слот Attachment) | Да | |
Передача файлов в (слот Attachment) | Нет | Слот Attachment передаст текстовую ссылку |
Получение файла от Собеседника в сценарий | Нет | |
Получение геолокации от собеседника в сценарии | Да | В переменную client_message будет передана ссылка вида: https://www.google.com/maps/search/?api=1&query=62.174535,-75.937498 |
Доставка сообщений более 1000 символов от Агента до Собеседника | Да | |
Использование маркдауна | Нет |
Last updated