Webim
Интеграция сервиса Webim с платформой Metabot24
История диалогов с ботами автоматически сохраняется в архиве.
Создайте новый аккаунт Webim или войдите в существующий.

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

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

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

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

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

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

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

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

В диалоговом окне указать следующие параметры:
- Оператор для бота - указать имя сотрудника, под которым будет работать Бот;
- Тип бота - Умный бот;
- Порядок сортировки - по умолчанию 100;
- Версия - указать параметр 2;
- Ссылка на внешний API - указать любое значение, например, https://ya.ru, в дальнейшем будет редактироваться;
- Токен авторизации - будет заполнен автоматически после сохранения настроек.
Сохранить настройки.

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

- Нажать кнопку Новая привязка и выбрать канал 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 обеспечивает следующий список каналов связи для возможного подключения:

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

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

Last modified 1yr ago