Webim
Интеграция сервиса Webim с платформой Metabot24
Last updated
Интеграция сервиса Webim с платформой Metabot24
Last updated
Интеграции сервиса 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.
Если чат переведён на Оператора, для того чтобы вернуть его обратно на Бота, нужно в панели Webim начать набирать ответный текст. При этом появляется функциональная кнопка Перенаправить, нажав на которую нужно выбрать оператора, на которого настроен Бот.
2. Реализована поддержка следующих типов сообщений с платформы Metabot24:
текстовое сообщение;
кнопочное меню;
вложения различных типов.
3. Если чат переведен на Оператора лидом или ботом через скрипт на платформе, то диалог должен закрыть Оператор по кнопке Закрыть или он закроется автоматически по таймеру - Тайм-аут автозакрытия чата с момента последней активности. Таймеры настраиваются в разделе Общие настройки, подраздел Тайм-ауты и сообщения:
После выполнения тайм-аута окончательного закрытия чата, если по Лиду установлен параметр Чат передан оператору, то данный признак сбрасывается и выполняется скрипт с типом Возврат.
На текущий момент Webim обеспечивает следующий список каналов связи для возможного подключения:
Для того, чтобы получить код чата для размещения на сайт, необходимо перейти в раздел Настройки - Кнопки и размещения:
В блоке Код для сайта размещен HTML-код, который необходимо вставить в код веб-страниц Вашего сайта, лучше всего в шаблон.
Параметр Обращение для отдела необходимо оставить по умолчанию Без отдела.
