Webim

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

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

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

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

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

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

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

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

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

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

1. Первый сотрудник, он же может быть и администратором аккаунта Webim, должен быть включен в отдел Операторы.
2. Второй сотрудник, через которого будет работать бот, должен быть включен в отдел бот, с наивысшим приоритетом в поле Порядок сортировки.
3. Третий сотрудник, это будет оператор, на которого будет переводиться диалог, должен быть включен в отдел Операторы.

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

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

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

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

• Оператор для бота — указать имя сотрудника, под которым будет работать бот;
• Тип бота — Умный бот;
• Порядок сортировки — по умолчанию 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.

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

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

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

• Текстовое сообщение;
• Кнопочное меню;
• Вложения различных типов.

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

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

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

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

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

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

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

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