# Webim Интеграции сервиса Webim с Metabot24 позволяет подключить бота в диалоги с клиентами в любых каналах связи. При этом, все новые диалоги вначале будут отправляться боту. По сценарию бот может переключить диалог на оператора. История диалогов с ботами автоматически сохраняется в архиве. ### Подключение интеграции Создайте новый аккаунт Webim или войдите в существующий. Произведите настройки аккаунта Webim для дальнейшей интеграции с платформой Metabot24, перейдя в раздел **Отделы**: [![Снимок экрана 2024-07-15 155621.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/lWjR7BOZ3sJQIU8q-snimok-ekrana-2024-07-15-155621.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/lWjR7BOZ3sJQIU8q-snimok-ekrana-2024-07-15-155621.png) Для реализации работы с переводом на оператора необходимо создать в аккаунте Webim, как минимум 2 отдела: 1. Один отдел с сотрудником без бота. 2. Второй отдел с ботом. Для того, чтобы по умолчанию диалог стартовал с ботом, надо ему выставить более высокий приоритет в поле **Порядок сортировки**. Например, можно произвести минимальные настройки отделов в такой форме: [![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/kFSK2GeBXtNTq4FS-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/kFSK2GeBXtNTq4FS-image.png) Далее перейдите в раздел **Сотрудники**: [![Снимок экрана 2024-07-15 160140.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/KXu2hJC6x0D6pjRy-snimok-ekrana-2024-07-15-160140.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/KXu2hJC6x0D6pjRy-snimok-ekrana-2024-07-15-160140.png) Для работы необходимо зарегистрировать как минимум 3-х сотрудников: 1. Первый сотрудник, он же может быть и администратором аккаунта Webim, должен быть включен в отдел **Операторы**. 2. Второй сотрудник, через которого будет работать бот, должен быть включен в отдел бот, с наивысшим приоритетом в поле **Порядок сортировки**. 3. Третий сотрудник, это будет оператор, на которого будет переводиться диалог, должен быть включен в отдел **Операторы**. Для регистрации нового сотрудника нажмите кнопку **Зарегистрировать нового сотрудника**: [![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/4ikstE6vOkNHXNPh-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/4ikstE6vOkNHXNPh-image.png) Далее перейдите в раздел **Боты**: [![Снимок экрана 2024-07-15 160535.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/PUiEPpL9OPNooj85-snimok-ekrana-2024-07-15-160535.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/PUiEPpL9OPNooj85-snimok-ekrana-2024-07-15-160535.png) Нажмите кнопку **Создать нового бота** и установите первоначальные настройки. В диалоговом окне указать следующие параметры: - **Оператор для бота** — указать имя сотрудника, под которым будет работать бот; - **Тип бота** — Умный бот; - **Порядок сортировки** — по умолчанию 100; - **Версия** — указать параметр 2; - **Ссылка на внешний API** — указать любое значение, например, https://ya.ru, в дальнейшем будет редактироваться; - **Токен авторизации** — будет заполнен автоматически после сохранения настроек. Сохранить настройки. [![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/ars9zjpYZhYeL9gk-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/ars9zjpYZhYeL9gk-image.png) Скопируйте в буфер обмена токен из меню **Редактирования бота**, который сгенерируется после создании бота в Webim: [![Снимок экрана 2024-07-15 161140.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/voxydqnES0b5I8nu-snimok-ekrana-2024-07-15-161140.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/voxydqnES0b5I8nu-snimok-ekrana-2024-07-15-161140.png) На платформе Metabot24 в настройках своего бота необходимо выполнить следующие действия: Перейти в раздел Настройки бота подраздел Каналы; Нажать кнопку Новая привязка и выбрать канал Webim. В диалоговом окне указать следующие параметры: - **Имя хоста** — это адрес, который отображается при входе в личный кабинет Webim в адресной строке браузера. Вводится без протокола и закрывающей косой, например, metabot3.webim.ru.; - **Логин** — логин администратора учётной записи Webim; - **Пароль** — пароль администратора учётной записи Webim; - **Код отдела для перевода на оператора** — буквенный идентификатор отдела, на который будет переведен диалог при вызове команды **Перевести на оператора**. Код отдела отображается в Webim на странице редактирования отдела, например, operatory: - Установить активность параметра **Использовать inline-кнопки**; - **Токен** — вставить из буфера обмена токен сгенерированный при создании бота в Webim. Сохранить настройки. [![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/s1qQt6D0U9hRhDhA-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/s1qQt6D0U9hRhDhA-image.png) Далее нажмите пункт Вебхук и скопируйте сгенерированный вебхук. При копировании обратите внимание, чтобы не было в начале и в конце строки знаков «пробел». [![Снимок экрана 2024-07-15 161816.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/Ps0DOny2CTbXAdDd-snimok-ekrana-2024-07-15-161816.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/Ps0DOny2CTbXAdDd-snimok-ekrana-2024-07-15-161816.png) Перейдите в личный кабинет Webim в раздел **Боты** и нажмите редактирование бота: В поле **Ссылка на внешний API** вставьте скопированный вебхук с платформы Metabot24 и сохраните настройки. ### Настройка каналов общения После подключения интеграции с Metabot24 необходимо произвести настройку каналов общения в Webim. Для этого перейдите в раздел **Общие настройки**: [![Снимок экрана 2024-07-15 162245.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/Wwtc7742AhxwNyoy-snimok-ekrana-2024-07-15-162245.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/Wwtc7742AhxwNyoy-snimok-ekrana-2024-07-15-162245.png) Перейдите в подраздел **Каналы общения** и произведите настройки каналов, согласно документации и рекомендациям Webim, например, Telegram: [![Снимок экрана 2024-07-15 162344.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/T9mDfYWfPtzMsrpj-snimok-ekrana-2024-07-15-162344.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/T9mDfYWfPtzMsrpj-snimok-ekrana-2024-07-15-162344.png) Необходимо указать название бота и скопировать токен из **@BotFather** и сохранить настройки. Бот подключен. Для получения дополнительный сведений о начале чата, назначении диалога на оператора, закрытии чата — необходимо в разделе **Общие настройки** в подразделе **Интеграции** в блоке **Обработчики событий** заполнить необходимые поля. Поля формы заполняются адресом для вебхуков, указанным в настройках канала Webim на платформе Metabot24 со следующими дополнениями: - **Начало чата** — к адресу на конце надо дописать "?event=chat\_started" без кавычек; - **Подключение оператора** — к адресу на конце надо дописать "?event=chat\_assigned" без кавычек; - **Завершение чата** — к адресу на конце надо дописать "?event=chat\_closed" без кавычек. Сохранить настройку. [![Снимок экрана 2024-07-15 162655.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/CqM18o9vznj5zPPP-snimok-ekrana-2024-07-15-162655.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/CqM18o9vznj5zPPP-snimok-ekrana-2024-07-15-162655.png) На этом всё. Бот подключен и готов к работе. Мы рекомендуем вам провести несколько тестовых диалогов, чтобы убедиться в правильности настройки сценариев. Увидеть активность пользователей при взаимодействии с ботом вы можете в разделе **Лиды** в личном кабинете Metabot24. ### Дополнительные возможности Если чат переведён на оператора, для того чтобы вернуть его обратно на бота, нужно в панели Webim начать набирать ответный текст. При этом появляется функциональная кнопка **Перенаправить**, нажав на которую нужно выбрать оператора, на которого настроен бот. [![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/zBsvECVubz5KWAPg-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/zBsvECVubz5KWAPg-image.png) Реализована поддержка следующих типов сообщений с платформы Metabot24: - Текстовое сообщение; - Кнопочное меню; - Вложения различных типов. Если чат переведен на оператора лидом или ботом через скрипт на платформе, то диалог должен закрыть оператор по кнопке **Закрыть** или он закроется автоматически по таймеру — Тайм-аут автозакрытия чата с момента последней активности. Таймеры настраиваются в разделе **Общие настройки**, подраздел **Тайм-ауты и сообщения**: [![Снимок экрана 2024-07-15 162925.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/pVwTaZdmx1ueIk5F-snimok-ekrana-2024-07-15-162925.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/pVwTaZdmx1ueIk5F-snimok-ekrana-2024-07-15-162925.png) После выполнения тайм-аута окончательного закрытия чата, если по лиду установлен параметр **Чат передан оператору**, то данный признак сбрасывается и выполняется скрипт с типом **Возврат**. ### Каналы связи Webim На текущий момент Webim обеспечивает следующий список каналов связи для возможного подключения: [![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/Dhm031a1MpheUdgJ-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/Dhm031a1MpheUdgJ-image.png) ### Размещение чата на сайте Для того, чтобы получить код чата для размещения на сайт, необходимо перейти в раздел **Настройки** — **Кнопки и размещения**: [![Снимок экрана 2024-07-15 163424.png](https://docs.metabot24.ru/uploads/images/gallery/2024-07/scaled-1680-/owjjNOyFR7kkYkSu-snimok-ekrana-2024-07-15-163424.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-07/owjjNOyFR7kkYkSu-snimok-ekrana-2024-07-15-163424.png) В блоке **Код для сайта** размещен HTML-код, который необходимо вставить в код веб-страниц вашего сайта, лучше всего в шаблон. Параметр **Обращение для отдела** необходимо оставить по умолчанию без отдела.