Gallery

Docs

История изменений

История релизов

НАЧАЛО РАБОТЫ С ПЛАТФОРМОЙ

ПЕРЕД СОЗДАНИЕМ АГЕНТА

КОНСТРУКТОР СЦЕНАРИЯ АГЕНТА

СОЗДАНИЕ АГЕНТА НА ПЛАТФОРМЕ

ОБУЧЕНИЕ И ТЕСТИРОВАНИЕ АГЕНТА

РАЗМЕЩЕНИЕ АГЕНТА В КАНАЛАХ

ЭКСПЛУАТАЦИЯ АГЕНТА

АНАЛИТИКА ОБЩЕНИЯ АГЕНТА

Explore

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

Webim

⁠

Webim⁠

— одна из популярных омниканальных платформ для общения с клиентами в

текстовых каналах⁠

. Используя омниканальную платформу Webim, можно разместить

@Бот⁠

а в одном или нескольких каналах общения.

Подключение

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

В первую очередь нужно произвести конфигурацию на стороне Webim.

Авторизуйтесь в

Webim⁠

как администратор.

Перейдите в раздел Настройки → Боты.

Начните создавать нового бота и заполните следующие поля:

Оператор для бота — выберите оператора, к которому будет прикреплен бот, рекомендуется создавать отдельных операторов для ботов.

Тип бота — выберите Умный бот.

Порядок сортировки — порядок определяет, на каком месте в списке ботов данный бот будет находиться. Чем меньше число, тем выше приоритет.

Статус — выберите статус бота.

Версия — выберите версию 1.

Ссылка на внешний API — введите адрес вебхука, его можно получить при настройке

@Канал Агента⁠

— см.

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

⁠

⁠

На этом конфигурация бота в Webim завершена.

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

⁠

@Агент⁠

у необходимо создать и настроить

@Канал Агента⁠

@Коннектор⁠

ом “Webim”.

Войдите в меню редактирования (Edit) настроек вашего

@Агент⁠

⁠

В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:

выберите тип канала Omnichannel

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

⁠

Выберите в поле Channel

@Коннектор⁠

“Webim”.

⁠

По необходимости пропишите заголовок для данного

@Канал Агента⁠

в поле Title.

⁠

После выбора “Webim” вам станет доступна ссылка на вебхук канала агента (поле Chatbot webhook: URL), которую нужно скопировать и вставить в поле

Ссылка на внешний API⁠

в настройках бота в Webim.

⁠

⁠

Активируйте канал переключением тумблера для того, чтобы

@Агент⁠

начал отвечать в нем.

⁠

Если

@Агент⁠

не был обучен, появится предупреждение. В таком случае необходимо обучить

@Агент⁠

а, после чего повторить попытку активации

@Канал Агента⁠

⁠

После активации

@Канал Агента⁠

, если есть проблемы с его доступностью, будет выведено предупреждение (

@Канал Агента⁠

будет активирован несмотря на проблемы):

"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL

⁠

Сохраните

@Канал Агента⁠

— нажмите Save.

Важно: Все настройки будут применены только после сохранения.

Общение

Взаимодействие с данным

@Конечный канал⁠

происходит по синхронному методу, с использованием

Webim External Bot API 1.0⁠

Так как

@Конечный канал⁠

синхронный, то

@Общение⁠

происходит по схеме Request от Webim — Response от

@Агент⁠

а, это накладывает некоторые ограничения и особенности на

@Общение⁠

Чтобы перевести на оператора с помощью

@Change Chat Mode⁠

, этот

@Слот⁠

должен стоять обязательно после

@Слот⁠

@Wait For Reaction⁠

: в ответ на Response c сообщением

@Собеседник⁠

а будет отправлен Response c управляющей командой перевода диалога на оператора

⁠

@Агент⁠

может только отвечать на сообщения, но не может первым отправлять сообщения в

@Чат⁠

данного

@Конечный канал⁠

через

@Слот⁠

@Timer⁠

или

@Incoming Request⁠

, так как в этом случае от Webim не будет Request, на который можно дать Response.

Важно: при срабатывании
@Timer⁠
или
@Incoming Request⁠

@Агент⁠
начнет соответствующие
@Ветка сценария⁠
и пойдет по
@Сценарий⁠
, остановившись на
@Слот ожидания ввода⁠
, при этом, отправленные до этого
@Слот⁠
а сообщения фактически не будут доставлены
@Агент⁠
у.

Маппинг Канальных переменных из канала Webim

Маппинг Канальных переменных из канала Webim

Канальная переменная

Конечный канал

Переменная в теле входящего запроса из канала

channel_conversation_id

Webim (External bot API 1.0)

chat.id

channel_visitor_id

Webim (External bot API 1.0)

visitor.id

channel_visitor_firstname

Webim (External bot API 1.0)

visitor.firstname

channel_visitor_lastname

Webim (External bot API 1.0)

visitor.lastname

channel_visitor_account

Webim (External bot API 1.0)

visitor.username

channel_visitor_phone

Webim (External bot API 1.0)

visitor.phone

channel_visitor_email

Webim (External bot API 1.0)

visitor.email

channel_visitor_location

Webim (External bot API 1.0)

visitor.location

channel_reply_to

Webim (External bot API 1.0)

нет

There are no rows in this table

⁠

Возможности общения в канале Webim

Возможности общения в канале Webim

Функционал

Конечный канал

Наличие в канале

Описание

channel_chat_id

Webim (External bot API 1.0)

Да

формат <webim chat_id>|webim

Сообщения дойдут до собеседника, если агент напишет первый в существующем чате

Webim (External bot API 1.0)

Нет

Сообщения не дойдут до

@Собеседник

⁠

а в таком случае. До

@Собеседник

⁠

а дойдут только сообщения

@Агент

⁠

а, отправленные в ответ на его действия или на сервисные сообщения, если они включены

Перевод на оператора

Webim (External bot API 1.0)

Да

C помощью слота

Change Chat Mode

⁠

Важно: перед

Change Chat Mode

⁠

обязательно должен находиться

Wait For Reaction

⁠

Перевод на оператора также произойдет если webim не получит ответа от

@Агент

⁠

в течение 5секунд

Кнопки

Webim (External bot API 1.0)

Да

Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )

Webim (External bot API 1.0)

Да

Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )

Webim (External bot API 1.0)

Нет

Слот

@Attachment

⁠

передаст текстовую ссылку

Получение файла от Собеседника в сценарий

Webim (External bot API 1.0)

Нет

Получение геолокации от собеседника в сценарии

Webim (External bot API 1.0)

Да

@client_message

⁠

будет передана ссылка вида:

https://www.google.com/maps/search/?api=1&query=62.174535,-75.937498

⁠

Доставка сообщений более 1000 символов от Агента до Собеседника

Webim (External bot API 1.0)

Да

Использование маркдауна

Webim (External bot API 1.0)

Нет

Рассылки с помощью Notification

Webim (External bot API 1.0)

Нет

There are no rows in this table

⁠

Перевод на оператора

При использовании

@Слот⁠

@Change Chat Mode⁠

происходит переключение на оператора.Чтобы перевести на оператора с помощью

@Change Chat Mode⁠

, этот

@Слот⁠

должен стоять обязательно после

@Слот⁠

@Wait For Reaction⁠

. После переключения на оператора диалог завершается и отображается на странице Аналитики (

@Вкладка Аналитики⁠

Переключение на оператора при отсутствии ответа от Агента

При возникновении какой-либо ошибки запроса к API (ответ отличается от ожидаемого или запрос закрылся по таймауту 5 сек) чат автоматически переводится в общую очередь операторов.

Подключение

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

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

Общение

Маппинг Канальных переменных из канала Webim

Возможности общения в канале Webim

Перевод на оператора

Переключение на оператора при отсутствии ответа от Агента

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.