Webim

Интеграция сервиса Webim с платформой Metabot24

Интеграции сервиса Webim с Metabot24 позволяет подключить бота в диалоги с клиентами в любых каналах связи. При этом, все новые диалоги вначале будут отправляться боту. По сценарию бот может переключить диалог на оператора.

История диалогов с ботами автоматически сохраняется в архиве.

Подключение интеграции

Создайте новый аккаунт Webim или войдите в существующий.

Произведите настройки аккаунта Webim для дальнейшей интеграции с платформой Metabot24, перейдя в раздел Отделы:

Для реализации работы с переводом на Оператора необходимо создать в аккаунте Webim, как минимум 2 отдела:

• Один отдел с сотрудником без Бота;

• Второй отдел с ботом. Для того, чтобы по умолчанию диалог стартовал с ботом, надо ему выставить более высокий приоритет в поле Порядок сортировки.

Например, можно произвести минимальные настройки Отделов в такой форме:

Далее перейдите в раздел Сотрудники:

Для регистрации нового сотрудника нажмите кнопку Зарегистрировать нового сотрудника:

Для работы необходимо зарегистрировать как минимум 3-х сотрудников:

• Первый сотрудник, он же может быть и администратором аккаунта Webim, должен быть включен в отдел Операторы;

• Второй сотрудник, через которого будет работать бот, должен быть включен в отдел Бот, с наивысшим приоритетом в поле Порядок сортировки;

• Третий сотрудник, это будет Оператор, на которого будет переводиться диалог, должен быть включен в отдел Операторы.

Далее перейдите в раздел Боты:

Нажмите кнопку Создать нового бота и установите первоначальные настройки:

В диалоговом окне указать следующие параметры:

• Оператор для бота - указать имя сотрудника, под которым будет работать Бот;

• Тип бота - Умный бот;

• Порядок сортировки - по умолчанию 100;

• Версия - указать параметр 2;

• Ссылка на внешний API - указать любое значение, например, https://ya.ru, в дальнейшем будет редактироваться;

• Токен авторизации - будет заполнен автоматически после сохранения настроек.

Сохранить настройки.

Скопируйте в буфер обмена токен, который сгенерируется при создании бота в Webim:

На платформе Metabot24 в настройках своего бота необходимо выполнить следующие действия:

• Перейти в раздел Настройки бота подраздел Каналы;

• Нажать кнопку Новая привязка и выбрать канал Webim.

В диалоговом окне указать следующие параметры:

• Имя хоста - это адрес, который отображается при входе в личный кабинет Webim в адресной строке браузера. Вводится без протокола и закрывающей косой, например, metabot3.webim.ru.;

• Логин - логин администратора учётной записи Webim;

• Пароль - пароль администратора учётной записи Webim;

• Код отдела для перевода на оператора - буквенный идентификатор отдела, на который будет переведен диалог при вызове команды Перевести на оператора. Код отдела отображается в Webim на странице редактирования отдела, например, operatory:

• Установить активность параметра Использовать inline-кнопки;

• Токен - скопировать из буфера обмена токен сгенерированный при создании бота в Webim.

Сохранить настройки.

Далее нажмите пункт Вебхук и скопируйте сгенерированный вебхук. При копировании обратите внимание, чтобы не было в начале и в конце строки знаков «пробел».

Перейдите в личный кабинет Webim в раздел Боты и нажмите редактирование бота:

В поле Ссылка на внешний API вставьте скорированный вебхук с платформы Metabot24 и сохранить настройку:

Настройка каналов общения

После подключения интеграции с Metabot24 необходимо произвести настройку каналов общения в Webim. Для этого перейдите в раздел Общие настройки:

Перейдите в подраздел Каналы общения и произведите настройки каналов, согласно документации и рекомендациям Webim, например, Telegram:

Необходимо указать название бота и скопировать токен из @BotFather и сохранить настройки. Бот подключен.

Для получения дополнительный сведений о начале чата, назначении диалога на оператора, закрытии чата - необходимо в разделе Общие настройки в подразделе Интеграции в блоке Обработчики событий заполнить необходимые поля. Поля формы заполняются адресом для вебхуков, указанным в настройках канала Webim на платформе Metabot24 со следующими дополнениями:

• Начало чата - к адресу на конце надо дописать "?event=chat_started" без кавычек;

• Подключение оператора - к адресу на конце надо дописать "?event=chat_assigned" без кавычек;

• Завершение чата - к адресу на конце надо дописать "?event=chat_closed" без кавычек.

Сохранить настройку.

На этом всё. Бот подключен и готов к работе. Мы рекомендуем вам провести несколько тестовых диалогов, чтобы убедиться в правильности настройки сценариев. Увидеть активность пользователей при взаимодействии с ботом вы можете в разделе Лиды в личном кабинете Metabot24.

Дополнительные возможности

1. Если чат переведён на Оператора, для того чтобы вернуть его обратно на Бота, нужно в панели Webim начать набирать ответный текст. При этом появляется функциональная кнопка Перенаправить, нажав на которую нужно выбрать оператора, на которого настроен Бот.

2. Реализована поддержка следующих типов сообщений с платформы Metabot24:

• текстовое сообщение;

• кнопочное меню;

• вложения различных типов.

3. Если чат переведен на Оператора лидом или ботом через скрипт на платформе, то диалог должен закрыть Оператор по кнопке Закрыть или он закроется автоматически по таймеру - Тайм-аут автозакрытия чата с момента последней активности. Таймеры настраиваются в разделе Общие настройки, подраздел Тайм-ауты и сообщения:

После выполнения тайм-аута окончательного закрытия чата, если по Лиду установлен параметр Чат передан оператору, то данный признак сбрасывается и выполняется скрипт с типом Возврат.

Каналы связи Webim

На текущий момент Webim обеспечивает следующий список каналов связи для возможного подключения:

Размещение чата на сайте

Для того, чтобы получить код чата для размещения на сайт, необходимо перейти в раздел Настройки - Кнопки и размещения:

В блоке Код для сайта размещен HTML-код, который необходимо вставить в код веб-страниц Вашего сайта, лучше всего в шаблон.

Параметр Обращение для отдела необходимо оставить по умолчанию Без отдела.