| Параметр | Описание | Пример: |
| title | Заголовок виджета | "Title" |
| subtitle | Подзаголовок виджета | "Subtitle" |
| initPayload | Стартовое сообщение | "/start" |
| inputTextFieldHint | Приглашение ввести текст | "Введите сообщение..." |
| inputTextTitle | Всплывающее приглашение ввести текст | "Введите сообщение..." |
| showMessageDate | Показывать дату отправки сообщения | showMessageDate |
| isButtonsInOneColumn | Отображать все кнопки в 1 колонку | false |
| isCustomScrolling | При получении входящего сообщения в виджете (от бота/оператора) выполнять скроллинг к последнему исходящему сообщению Лида | false |
| mainColor | Основной цвет | "#F69B1D" |
| userTextColor | Цвет текста на кнопках | "#FFF" |
| userBackgroundColor | Цвет кнопок | "#F69B1D" |
| attachments | ||
| enabled | Вкл/откл отправки файлов в виджете | "true" |
| extensions | Список поддерживаемых расширений файлов | "png,jpg,gif,pdf,doc,docx,csv,xml,zip,7zip,gzip,rar" |
| icon | Ссылка на иконку для прикрепления файлов | "default" |
| maxSize | Максимальный размер файлов | { all: 10485760, video: 20971520 } |
| errorMessage | Сообщения об ошибке отправки файла | { 'default': 'Sorry, there was an error uploading the file', 'en': 'Sorry, there was an error uploading the file', 'en-US': 'Sorry, there was an error uploading the file', 'ru': 'Извините, произошла ошибка при загрузке файла', 'ru-RU': 'Извините, произошла ошибка при загрузке файла', 'zh-CN': '抱歉，上传文件时出错', 'zh-HK': '抱歉，上传文件时出错', 'zh-TW': '抱歉，上传文件时出错' } |
| errorLargeFileMessage | Сообщения о файле слишком большого формата | { 'default': 'Maximum file size exceeded', 'en': 'Maximum file size exceeded', 'en-US': 'Maximum file size exceeded', 'ru': 'Превышен максимальный размер файла', 'ru-RU': 'Превышен максимальный размер файла', 'zh': '超出最大文件大小', 'zh-CN': '超出最大文件大小', 'zh-HK': '超出最大文件大小', 'zh-TW': '超出最大文件大小' } |
Если в поле **attachment: icon** указано **'default'** то указываем SVG иконки прошитую в виджете, иначе будет указана HTTPS ссылка на картинку.
Эти параметры добавляются в код инициализации виджета, который вы можете взять в поле **Код виджета** канала. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/go3PVEfnL7nYhRXO-image.png) Например, вот так выглядит код виджета для бренда Metabot, который работает на нашем сайте [https://metabot24.ru](https://metabot24.ru). Обратите внимание на новые параметры в методе init. ```JavaScript ```В Metabot Widget можно так же настроить **мультиязычность**, **приветственное меню** и **персонажа**. Для настройки данных возможностей обратитесь к команде Metabot*.*
Размещение кода виджета на сайтеЕсли аккаунт GTM уже был создан, то достаточно в аккаунте добавить новый контейнер.
5. Добавить новый тег. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/wXgAKohCCFEFpABd-izobrazenie.png) 6\. Нажать на кнопку в блоке **Конфигурация тега**. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/KHM1000aKy5A3eWO-izobrazenie.png) 7\. Выбрать пункт **Пользовательский HTML**. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/xLvBdFNKlcg8HmK1-izobrazenie.png) 8. В административной панели платформы Metabot, необходимо создать подключение канала Metabot Widget (если ещё нет) и загрузить в CDN скрипт-загрузчик.Запись должна быть отмечена зеленым значком со значением “200”.
9\. Скопировать тело скрипта в буфер. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/739nkJpeJlsBE0em-izobrazenie.png) 10\. Продолжить заполнение тега в GTM, для этого выполнить по пунктам: 10.1. Придумать имя тега. 10.2. Вставить из буфера обмена скопированный скрипт. 10.3. Создать GTM-триггер. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/4ubq2Z8OR9mhQX0s-izobrazenie.png) 10.4. Выбрать пункт All Pages. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/aA5EwlhV3tTrFp57-izobrazenie.png) 10.5. Нажать кнопку **Сохранить**. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/OaTHisatKbcWgVUJ-izobrazenie.png) 11\. В рабочей области нажать кнопку **Отправить.** [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/Q9Jixv3yHX4ajs4M-izobrazenie.png) 12\. Заполнить форму указав название версии, например, ver1 и по желанию описание версии. Затем нажать кнопку **Опубликовать**. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/E1VpR7w1lgeBlVYz-izobrazenie.png) 13\. После успешной публикации версии, вернуться в **Рабочую область** и открыть popup с кодами тег-менеджера. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/s6FqkV7BYazRUEmZ-izobrazenie.png) 14\. Скопировать фрагменты кода в вставить в соответствующие разделы на сайте в head и body нужной html-страницы. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/y8gJpHoZyguol52w-izobrazenie.png) Ниже показан пример как это может выглядеть: [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/j42wwrEY262LXVab-izobrazenie.png) 15. Открыть страницу сайта в браузере. Нужные скрипты подгружаются и виджет запускается. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/JEyYsBiDbDOUObVs-izobrazenie.png) #### Редактирование чат-виджета в GTM При удалении и создании нового канала Metabot Widget на платформе, затем достаточно просто скопировать скрипт из блока **Загрузчик** и вставить его новой версией тега в контейнер GTM. Для этого в аккаунте GTM открыть тег на редактирование. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/UkxgULHvSk0TKfWh-izobrazenie.png) Через функцию редактирования вставить скопированный скрипт и сохранить изменения, указав новое имя версии. Далее опубликовать новую версию. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/HU2w5LqlemCxcvyD-izobrazenie.png) Мы получим новую версию загруженного чат-виджета с платформы. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/glFC251UAWP2R6jd-izobrazenie.png) Таким образом без правки кода сайта мы можем переключать на различные версии чат-виджетов. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/jCBClvfAht3G5iYi-izobrazenie.png) # Metabot Widget с диплинками ### Чат-виджет с диплинками При создании и тестировании чат-бота в канале Metabot Widget необходимо провести первоначальные настройки виджета. Как это сделать подробно описано в статье [Metabot Widget](https://docs.metabot24.ru/books/2-instrukciya-polzovatelya/page/metabot-widget). Здесь мы рассмотрим дополнительные настройки бота и виджета, которые позволят вам изучить метод настройки с диплинками. ### Настройка маршрутов с диплинками Для того, чтобы настроить в чат-виджете дополнительные кнопки, например, переход в определенные сценарные ветки или быстрый вывод информации, необходимо настроить маршруты с переходами в данные разделы сценария или скрипты. Также можно настроить на странице сайта кнопку с запуском диплинка и переходом в чат-виджет в соответствующий сценарий. Рассмотрим пример:Контроль автоопределения текущего раздела сайта выполняется с помощью V8 условий в маршруте с диплинком.
В нем условие можно и не писать, но в таком случае этот маршрут должен обязательно идти последним в списке. На случай если кто-то случайно передвинет его выше в списке маршрутов, v8 просто не даст ему запуститься, если сервис ОПРЕДЕЛЕН.
[](https://docs.metabot24.ru/uploads/images/gallery/2023-07/SNoZLzUgjIdTQwu7-izobrazenie.png)"href": <ссылка на телеграм аккаунт бота с икранирующими \\/ символами>
"value": <ссылка на загруженный файл иконки с икранирующими \\/ символами, картинку можно загрузить на платформу в разделе Магазин- Медиагалерея>
[](https://docs.metabot24.ru/uploads/images/gallery/2023-07/ZGK6KhCVCm6HvFGH-izobrazenie.png) - **Объединение диплинков в папки —** различные кнопки с диплинками можно объединить/сгруппировать в папки; ```JavaScript { "type": "folder", "title": { "text": "Сервисы тестового САЙТА", "color": "#ffffff" }, "icon": { "type": "url", "value": "https:\/\/user43148.clients-cdnnow.ru\/img\/more.svg" }, "data": [ { "type": "deepLink", "event": { "dataset": { "deeplink": "{{ ^#Deeplink1 }}" } }, "title": { "color": "#1B1C1E", "background": "#1B1C1E", "text": "ДЕМО-БОТ" }, "background": "#E8F3FF" }, { "type": "deepLink", "event": { "dataset": { "deeplink": "{{ ^#Deeplink2 }}" } }, "title": { "color": "#1B1C1E", "background": "#1B1C1E", "text": "ПОДДЕРЖКА" }, "background": "#E8F3FF" }, { "type": "deepLink", "event": { "dataset": { "deeplink": "{{ ^#Deeplink3 }}" } }, "title": { "color": "#1B1C1E", "background": "#1B1C1E", "text": "СТАРТ общий" }, "background": "#E8F3FF" } ] }, ``` [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/3O1hkgi9GvS5nc7x-izobrazenie.png) [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/Qk3G28sdDNp7vtVh-izobrazenie.png) - **Кнопка с диплинком в теле чат-виджета:** - Если лид новый и еще не общался с ботом в виджет; ```JavaScript { "type": "deepLink", "newConversation": { "title": { "color": "#1B1C1E", "text": "Начать диалог" }, "subtitle": { "text": "Начать диалог с ботом" }, "event": { "dataset": { "deeplink": "someDeeplinkHashCode" } }, "icon": { "type": "url", "value": "https:\/\/user43148.clients-cdnnow.ru\/img\/message_round.svg" } }, ``` [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/a8GDElaJFbRMFMkH-izobrazenie.png) - - Если лид уже общался с ботом в виджете, то продолжение кода; ```JavaScript "existConversation": { "title": { "color": "#1B1C1E", "text": "Продолжить диалог" }, "subtitle": { "text": "Продолжить ранее начатый диалог" }, "icon": { "type": "url", "value": "https:\/\/user43148.clients-cdnnow.ru\/img\/message_round.svg" } } ``` На виджете так [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/iNIB03nBi4fvrXjp-izobrazenie.png) - **Кнопка в футере виджета**: - Если лид новый и еще не общался с ботом в виджет; ```JavaScript { "type": "actionOpen", "title": { "color": "#1B1C1E", "text": "Задать вопрос" }, "event": { "dataset": { "deeplink": "E7tsR7VFWUGHKBgg" } }, "icon": { "type": "url", "value": "https:\/\/user43148.clients-cdnnow.ru\/img\/message.svg" } }, ``` [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/NkTniqllOvKVFAgY-izobrazenie.png) - - Если лид уже общался с ботом в виджете, в кнопки можно добавить диплинки с переходом в нужные точки сценарной ветки чат-бота; ``` { "type": "actionContinue", "title": { "color": "#1B1C1E", "text": "Задать новый вопрос" }, "event": { "dataset": { "deeplink": "E7tsR7VFWUGHKBgg" } }, "icon": { "type": "url", "value": "https:\/\/user43148.clients-cdnnow.ru\/img\/message.svg" } }, ``` [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/Ps5SvQXcFVALJC0G-izobrazenie.png) В целом чат-виджет может быть настроен с различными диплинками, мессенджерам и соц.сетями. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/hqEdeYhsvWubqtzV-izobrazenie.png) ### Настройка диплинков на сайте Для того, чтобы настроить диплинки на странице сайта необходимо на раздел сайта или кнопку установить код, который генерируется автоматически при создании ссылки. Раздел **Ссылки** с типом ссылки Deep Link. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/v2w7jIYWM4EIumKY-izobrazenie.png) Например, на беке есть кнопки: Демо-бот, Поддержка и Старт общий, то для их настройки надо передать: - ДЕМО-БОТ: ```JavaScript {"type":"deepLink","event":{"dataset":{"deeplink":"{{ ^#Deeplink1 }}"}}, "title":{"color":"#1B1C1E","background":"#1B1C1E","text":"Deeplink1"},"background":"#E8F3FF"} ``` - ПОДДЕРЖКА: ```JavaScript {"type":"deepLink","event":{"dataset":{"deeplink":"{{ ^#Deeplink2 }}"}}, "title":{"color":"#1B1C1E","background":"#1B1C1E","text":"Deeplink2"},"background":"#E8F3FF"} ``` - СТАРТ общий: ```JavaScript {"type":"deepLink","event":{"dataset":{"deeplink":"{{ ^#Deeplink3 }}"}}, "title":{"color":"#1B1C1E","background":"#1B1C1E","text":"Deeplink3"},"background":"#E8F3FF"} ``` # TelegramДля настройки интеграции рекомендуется использовать ПК версию мессенджера Telergam.
В поиске по ID необходимо найти **@BotFather**. В найденном боте следует открыть список команд и выбрать функцию **/newbot**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-03/qJDqjBltO4C10UnX-image.png) Затем нужно ввести имя нового бота (то, что будет отображаться в Именной строке). [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/t3UU1APHwboot8RW-metabot-bot.png) Название может быть на любом языке и может быть созвучно с вашим бизнесом. Например, **primerbot**. [](https://docs.metabot24.ru/uploads/images/gallery/2023-01/krW46PZ5njG7Yigl-image.png) Далее укажите ID для мессенджера (то, что будет использоваться для ссылки), оно может совпадать с именем бота для удобства. [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/c2PEFkEmWf7MkqEn-metabot-bot.png) Например, укажем со словом test **test\_rpimerbot**. [](https://docs.metabot24.ru/uploads/images/gallery/2023-01/PNmYkSeJHu5lEfoi-image.png) Затем сохраните ID токена, который будет сгенерирован в Telegram, скопировать его полностью в буфер обмена. [](https://docs.metabot24.ru/uploads/images/gallery/2023-01/XPO7IPN8ZxtpeL7b-image.png) Перейдите в **Настройки бота** в раздел подраздел **Каналы**. Нажмите кнопку **Новая привязка** и выберите канал Telegram, вставьте токен. [](https://docs.metabot24.ru/uploads/images/gallery/2024-03/aJXqRwqyZzxodTCV-image.png) Остальные параметры можете заполнить по желанию: - **Использовать inline-кнопки** — вместо списка вариантов в боте будет выводиться inline-кнопка отдельно для каждого варианта из меню; - **Реакция на фото** — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать фото отправленные пользователем, либо реагировать при помощи NLP или выводом меню; - **Контекст NLP для фото** — контекст NLP для реакции на фото; - **Отключить Fallback для фото** — при игнорировании фото, не активировать для него Fallback скрипт; - **Реакция на файлы (документы)** — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать файлы отправленные пользователем, либо реагировать при помощи NLP или выводом меню; - **Контекст NLP для файлов (документов)** — контекст NLP для реакции на файлы; - **Отключить Fallback для файлов (документов)** — при игнорировании файлов, не активировать для них Fallback скрипт; - **Реакция на видео** — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать видео отправленные пользователем, либо реагировать при помощи NLP или выводом меню; - **Контекст NLP для видео** — контекст NLP для реакции на видео; - **Отключить Fallback для видео** — при игнорировании видео, не активировать для него Fallback скрипт; - **Реакция на аудио** — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать аудио отправленные пользователем, либо реагировать при помощи NLP или выводом меню; - **Контекст NLP для аудио** — контекст NLP для реакции на аудио; - **Отключить Fallback для аудио** — при игнорировании аудио, не активировать для него Fallback скрипт; - **Реакция на голосовые сообщения** — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать голосовые сообщения отправленные пользователем, либо реагировать при помощи NLP или выводом меню; - **Контекст NLP для голосовых сообщений** — контекст NLP для реакции на голосовые сообщения; - **Отключить Fallback для голосовых сообщений** — при игнорировании голосовых сообщений, не активировать для них Fallback скрипт; - **Реакция на стикер** — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать стикеры отправленные пользователем, либо реагировать при помощи NLP или выводом меню; - **Контекст NLP для стикера** — контекст NLP для реакции на стикеры; - **Отключить Fallback для стикера** — при игнорировании стикера, не активировать для него Fallback скрипт.Если оставить настройки файлов без изменений, то бот будет реагировать на них вызовом Fallback-а.
Нажмите кнопку **Сохранить**. Новая привязка создана и для завершения настройки необходимо нажать ссылку **Вебхук**.Не забудьте сгенерировать **Вебхук** в поле **Операции**, иначе операция привязки бота к каналу не будет завершена.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-09/Hpv1EG4nCeQcAksE-bez-imeni.png) Далее необходимо подтвердить или отменить выполняемую операцию. Оставьте версию без изменений, как было предложено. [](https://docs.metabot24.ru/uploads/images/gallery/2024-03/A8kUJihRtJP86qwZ-image.png) Подключение к каналу Telegram завершено. Теперь можно проверить запуск бота, набрав имя бота в мессенджере Telegram. [](https://docs.metabot24.ru/uploads/images/gallery/2023-01/3bCzE0xcEk6ef5dS-image.png) Нажмите кнопку **Запустить**. На экране должно появиться приветственное сообщение — это свидетельствует о правильности привязки канала. [](https://docs.metabot24.ru/uploads/images/gallery/2023-01/MWVR4zGg35iaVm7P-image.png) ### Оформление карточки бота Чтобы наполнить бота информацией необходимо выбрать раздел **/mybots** *—* **edit your bots \[beta\]** в сообщении с помощью или меню. Выберите бота, которого хотите изменить и нажмите кнопку **Edit Bot**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/GSyjFvbokjFRFoLQ-redaktirovanie-bota.png) Далее выберите, что именно хотите изменить: название, описание или информацию о боте.Команды тоже можно поставить, но данный функционал работает не во всех логических сценариях ботов, тут нужно продумывать дополнительные запросы в НЛП системы.
- **Edit Name** — меняет имя в главной строке. Введите новое имя и отправьте боту (замена моментальная); [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/FKPXlIBXaoLRi1K3-image.png) - **Edit Description** — меняет первое сообщение, приглашающее к диалогу. Введите текст и отправьте боту (замена моментальная); [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/JfnJAk2yf8jjUmbK-image.png) - **Edit About** — меняет описание бота в карточке аккаунта. Введите описание, объем 120 символов (замена моментальная); --- [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/N0rkxy1VFePs1gBR-image.png)Команда Метабот очень просит своих клиентов указывать в описании сотрудничество, если это позволяет политика компании: **Сделано вместе с @MetabotBot**.
- **Edit Botpic** — меняет аватар аккаунта. Отправьте фото. Не файл, а именно фото через телефон любого формата, размером не менее 150х150 пикселей - замена моментальная. Какое-то время у бота может показываться галерея предыдущих аватаров, но через день галерея автоматически сбросится и останется только последнее отправленное фото; [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/aIXFUATwOLvx1TG7-metabot-bot.png) - **Edit Privacy Policy** — добавление кнопки с ссылкой на политику конфиденциальности бота. Отправьте публичный URL-адрес на политику конфиденциальности. [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/ljXUJHmkIkmDTbTu-metabot-bot.png) - **Edit Commands** — меняет системные команды бота (замена моментальная). [](https://docs.metabot24.ru/uploads/images/gallery/2024-10/zQ5TWodpmBJ05vbr-image.png) Команды должны быть написаны латиницей, а описание можно написать кириллицей в формате:| command1 - Description command2 - Another description |
Если вы будете постепенно добавлять команды, то при создании новых, **не забудьте написать старые**. Порядок вашего написания будет напрямую влиять на отображение в боте.
Для связи команд из botFather с платформой перейдите в маршруты. [Документация](https://docs.metabot24.ru/books/03-nastroika-botov/page/marsruty)
Создайте маршрут бота, который будет вызывать скрипт по команде команды. **Регулярное выражение (код команды) должно быть написано с экранированием**.
ВАЖНО: в маршруте с регулярным выражением подписи команды должен быть включен флаг **Действует в диалоге.**
Также можно добавить маршрут рестарта, для корректного реагирования бота, в случае остановки-перезапуска бота в настройках Telegram. [](https://docs.metabot24.ru/uploads/images/gallery/2024-10/6HJsn0OvXV6lf6HN-image.png) ### Блокировка канала На платформе реализована реакция на событие **блокировки** бота в Telegram, если приходит событие блокировки, то автоматически блокируется лид, включается параметр **Отключение реакции боа на сообщения лида** и сбрасывается беседа лида. Также на платформе реализована реакция на событие **разблокирования** бота в Telegram (событие перезагрузки бота), Если приходит событие разблокировки, то автоматически у лида выключается параметр **Отключение реакции боа на сообщения лида**. Далее после получения вебхука с разблокировкой приходит вебхук с текстом **/start**. ### Mini App Чтобы создать ссылку на Mini App следуйте шагам: 1\. Перейдите в BotFather Mini App 2\. Выберите нужного бота из списка 3\. Нажмите на Mini Apps 4\. Нажмите на Create Direct Link 5\. В url вставьте ссылку https://app.metabot24.com/forms/acrihin/instruments 6\. Заполните полностью metadata 7\. Ниже допишите адрес ссылки на МА 8\. Нажмите Create # Jivochat Интеграции сервиса [**Jivo**](https://www.jivo.ru) с [**Metabot24**](https://app.metabot24.com) позволяет подключить бота в диалоги с клиентами в любых каналах связи. При этом, все новые диалоги вначале будут отправляться боту. По сценарию бот может переключить диалог на оператора.Все параметры кроме **Использовать inline-кнопки** пока можно оставить без изменений, по умолчанию и сохранить настройку.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-02/NnCgMS8h0GO91z1t-image.png) [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/Daui6Tze2yf6Ao4h-image.png) [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/SNop9m4pnlup8ZU6-image.png) [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/wz9S7ve5UZ2r1fHU-image.png) После создания нажмите пункт **Вебхук** и скопируйте сгенерированный вебхук.При копировании обратите внимание, чтобы не было вначале и в конце строки знаков «пробел».
### Настройка Jivochat После получения вебхука, вам необходимо будет зайти в [приложение Jivo](https://app.jivosite.com/settings/integrations) в раздел **Управление**, **Каналы** **связи**, добавить канал, например, Telegram. [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/Xm4Da11og9e9UNgu-dzivo.png) После подключения канала проведите настройку раздела **Настройки интеграции для разработчиков.** Для этого необходимо включить опцию Включить Webhooks и заполнить поле URL для Webhooks вставить скопированный вебхук, полученный в Metabot. [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/HlHsfx3XrFk1R6Aj-vebxuk-dzivo.png) Аналогично можно сделать настройку для виджета и всех подключенных каналов. Перейдите по ссылке [**https://app.jivosite.com/settings/integrations/add-bot/31**](https://app.jivosite.com/settings/integrations/add-bot/31) и настройте расширение Metabot для подключения бота: [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/dztu311A6JL9PTlb-image.png) [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/SSMiztghd3VJmhSS-image.png) Здесь можно настроить внешний вид бота, который будут видеть пользователи. Загрузите логотип компании или специальную иконку бота, укажите имя и должность бота. **Токен бота** можно найти на платформе в разделе **Каналы**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/nCL90ufAJPiHGtUi-vebxuk-dzivo.png) После нажатия кнопки **Сохранить**, интеграция будет подключена и данный бот отобразится в подключенных системах.Обратите внимание, что когда добавляются новые каналы и интегрируются с Metabot24, то необходимо не забывать включать в разделе **Опции** активность для новых каналов.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-02/ZebzhvBuY7HmjO47-vebxuk-dzivo.png) На этом всё. Бот подключен и готов к работе. Мы рекомендуем вам провести несколько тестовых диалогов, чтобы убедиться в правильности настройки сценариев. Увидеть активность пользователей при взаимодействии с ботом вы можете в разделе [**Лиды**](https://app.metabot24.com/lead) в личном кабинете Metabot24. ### Настройка включения кнопок по каналам связи Если по части каналов не поддерживаются или не корректно работают кнопки, то необходима настройка выборочного включения кнопок по каналам связи Jivo. Данную настройку необходимо сделать вначале подключения канала Jivo. Для этого определить выбор в канале для каких мессенджеров используются кнопки. Если мессенджер не определен, то параметр берется из глобальной настройки канала из параметра **Использовать inline-кнопки***.* Если мессенджер определен, по параметр берется из следующего перечисления: - **Определяется общей настройкой канала **— установлен по умолчанию; - **Да** — использовать в канале кнопки; - **Нет** — не использовать в канале кнопки. Проведем настройку кодов виджета и мессенджеров для определения наличия кнопок в мессенджере при обращении лида.| Канал | Кнопки | Использовать inline-кнопки | Регулярное выражение |
| Jivo Widget | поддерживает | Да | ^https:\\/\\/metabot24\\.info/.\*$ |
| Telegram | поддерживает не более 7 | Да | telegram |
| Viber | поддерживает не более 7 | Да | ^metabotjivo$ |
| ВКонтакте | не поддерживает | Нет | ^Metabot.\*$ |
| не поддерживает | Нет | ^Metabot.\*$ | |
| не поддерживает | Нет | ^Metabot.\*$ | |
| Avito | не поддерживает | Нет | Avito |
| Apple Business Chat | не поддерживает | Нет | - |
| Одноклассники | не поддерживает | Нет | ^Metabot.\*$ |
Если в Jivo настроена омниканальность, то могут возникнуть проблемы, поэтому рекомендуем подключать каждый мессенджер в Jivo как новый канал
Если у вас в ЛК Jivo **не указан алиас**, то в регулярном выражении канала Jivo по мессенджеру telegram следует указать **дополнительно имя канала**. Например: **telegram|||^Test\_bot\*$**
### Заполнение контактных данных по лиду После общения Лида (пользователя) с ботом можно в дальнейшем просмотреть его контактные данные: мессенджер, с которого общались, имя, телефон, email. На сервисе [**Jivo**](https://app.jivosite.com) эти данные можно посмотреть на вкладке **Диалоги**, зайдя в диалог: [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/xs8MruP5ByVFNnpF-dialog-dzivo.png) Для просмотра этих данных на платформе Metabot24 следует выполнить следующие действия: 1. В истории сообщений хранится параметр **widget\_id**, который является уникальным для каждого канала. По тестовому лиду перейдите в историю сообщений. [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/ZzafMltIgRiDHYLZ-dialog-dzivo.png) 2. Далее перейдите по ссылке в webhooks-log. [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/Q54EECy11VHUQTSh-dialog-dzivo.png) 3. В строках с параметрами в поле **Event Type** = chat\_accepted/chat\_finished/chat\_updated необходимо открыть ссылку **Show Formatted Payload**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/pGl0PJ5PlAPGGfqx-dialog-dzivo.png) 4. Cкопируйте код параметра **widget\_id**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/vK9rgn6mCvsqAhsf-dialog-dzivo.png) 5. Откройте на редактирование канал **Jivo** в настройках бота, вставьте скопированный код в соответствующее поле мессенджера и сохраните настройки. [](https://docs.metabot24.ru/uploads/images/gallery/2024-02/hQfySQgjGMD8Bv0M-dialog-dzivo.png) После этого при получении последующих CRM-вебхуков из этого канала для лидов будет прописываться соответствующий мессенджер, а также и все контактные данные из карточки лида отредактированные в сервисе Jivo. ### Дополнительные возможности - Bot API сервиса **Jivo** не поддерживает вложения, поэтому изображения и прочие вложения отправляемые с платформы **Metabot24** клиенту приходят в виде текста **URL**: - Telegram автоматически делает такую ссылку активной и даже подгружает изображение; - Чат-виджет ссылку передает просто текстом и не кликабельной, поэтому ее можно только выделить и скопировать текст, далее вставить в адресную строку браузера; - Если в настройках канала включить параметр **Использовать inline-кнопки**, то кнопки прорисовываются и становятся кликабельны; - При подключении оператора в чат с лидом сервис **Jivo** отправляет сообщение в мессенджер о присоединении оператора к чату. При выходе оператора из чата сервис **Jivo** не отправляет никаких сообщений и в боте также не отображается, что оператор вышел из чата с лидом; - После завершения чата оператором или если это произошло автоматически через определённое время простоя, теряется возможность отправки ботом сообщений в этот чат. Возможность возобновляется после перезагрузки данного чата оператором или лидом; - Имеется возможность переключения на оператора с помощью команд в боте, обратно переключение на бота может сделать только оператор — **Выйти из чата**, но лид должен заново начать диалог, написав сообщение, иначе бот не возобновит работу; - Если операторов нет онлайн, то при отправке сообщения приходит вебхук соответствующего события и в боте можно использовать вызов скрипта с типом **Нет доступных операторов**; - При перенаправлении чата от одного оператора другому оператору, никаких событий от сервиса **Jivo** не поступает в **Metabot24** и этот момент не обрабатывается на платформе, в бота не отправляются уведомительные сообщения; - Рекомендуемые настройки канала, для отображения чата: - Можно настроить автоматические действия и поведение чат-бота при недоступности операторов, для этого в настройках канала в разделе **Автоматические действия** отключить все пункты и добавить новый пункт **Показать чат-бот при самом первом посещении сайта**, делается это с помощью кнопки **Добавить действие**; - В новом пункте указать следующие рекомендованные настройки по условиям: - Время на сайте; - Количество визитов; - Время от последнего активного приглашения; - При таких настройках окно чата будет показываться пользователю при первом посещении через 20 сек; - В разделе **Форма контактов** необходимо отключить запрос формы контактов клиента; - В разделе **Кнопки в чате** можно настроить поведение чата при условии, что пользователь еще ничего не написал. Это рекомендуется настраивать, чтоб при повторном обращении в бота спустя время, пользователь мог нажать на кнопку и активировать бота или при первом посещении чата - окно чата не было пустым. ### Работа с Jivochat из JS С каналами Jivochat можно работать из JS следующими методами: #### Отправить markdown текст ##### Описание: Используйте когда вам необходимо отправить форматированное сообщение в канал, например, когда вам нужно отправить ссылку в окно чат-виджета в виде гипертекстовой ссылки [сайт](https://metabot24.ru) вместо [https://metabot24.ru](https://metabot24.ru). Markdown передается через указание дополнительных параметров **apiAdditionalParams** для JS функции bot.**sendText**(). Если интеграция Jivochat с каналом не поддерживает markdown, то будет отправлена plain версия. ##### Пример: ```JavaScript let markdown = `Ознакомьтесь с нашим [каталогом плагинов](https://metabot24.ru/plugins/)`; let plain = `Ознакомьтесь с нашим каталогом плагинов: https://metabot24.ru/plugins/`; bot.sendText( plain, { "message": { "type":"MARKDOWN", "content": markdown, "text": plain, "timestamp": Date.now(), } } ); ``` # VK ### Интеграция канала VK с платформой Metabot24 Для интеграции канала VK с платформой необходимо иметь в сообществе VK роль — **Администратор**. Входим в аккаунт VK. Затем переходим в раздел **Сообщества**, на вкладку **Управление** и выбираем нужное для настройки канала сообщество. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/KoJ2VxOXvLGCjnLu-izobrazenie.png) Переходим в раздел **Управление**. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/GctxMW9G9xn1Hd7c-izobrazenie.png) Здесь выбираем раздел **Работа с API** и нажимаем кнопку **Создать ключ**. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/rFZ3YSiDulwR4b2N-izobrazenie.png) В диалогом окне выбираем установить активность по всем пунктам и нажимаем кнопку **Создать** и далее подтверждаем все действия. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/YoTarJALLlxATDx3-izobrazenie.png) Копируем созданный ключ в буфер обмена. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/cU8pvWXIghclRD4d-izobrazenie.png) Дальше следует перейти в административную панель платформы Metabot24. Для этого выполняем следующие действия: 1. Переходим в [Настройки бота](https://app.metabot24.com/menubuilder) в подраздел **Каналы**. 2. Нажимаем кнопку **Новая привязка** и выбираем канал VK. 3. Вставляем скопированный ключ в поле **Токен***.* 4. При необходимости включаем опцию **Использовать inline-кнопки**. 5. Форму пока не закрываем. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/Fo6pXf1Vt0U2Z3cc-izobrazenie.png)При включении опции **Использовать inline-кнопки** стоит помнить об ограничениях VK: в меню должно быть не более 7 пунктов и наименование кнопок меню должно быль не более 20 символов с учетом пробелов между словами.
Переходим обратно в админ-панель VK в раздел **Сообщения** подраздел **Настройки для бота**. Опция **Сообщения сообщества** должна быть включена, остальные поля необязательны. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/hvhLdqgdnH5X0ICA-izobrazenie.png) Далее переходим в раздел **Настройки** и копируем ID сообщества. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/Yraj0KjnTwetUZta-izobrazenie.png) Возвращаемся в административную панель платформы Metabot24 и вставляем скопированное в поле **ID сообщества.** Сохраняем, нажав кнопку **Создать**. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/mGp8Z3ksbet4AiKB-izobrazenie.png) Новая привязка создана и для завершения настройки необходимо нажать на кнопку **Вебхук**.Не забудьте сгенерировать вебхук в поле Операции, иначе операция привязки бота к каналу не будет завершена.
[](https://docs.metabot24.ru/uploads/images/gallery/2023-07/QeM4oVKLz8zPMFGd-izobrazenie.png) Подтверждаем или отменяем выполняемую операцию. Версия формата вебхука по умолчанию = V3. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/UoY1Pr3KcDjHvShn-izobrazenie.png) Подключение к каналу VK завершено. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/SHg9UUPa11NX3YiS-izobrazenie.png) Далее необходимо проверить работу бота, написав боту в VK сообщение. [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/VWRXm3aAAysWu7Z2-izobrazenie.png) Если в приложении появится новое сообщение от бота — это успех! [](https://docs.metabot24.ru/uploads/images/gallery/2023-07/a7O60v2j5k4tYoRW-izobrazenie.png) # Umnico Для интеграции сервиса [Umnico](https://umnico.com/) с платформой Metabot24 необходимо в разделе **Настройки -> API** скопировать ваш API токен, нажав на кнопку **Скопировать токен**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-03/lvYHeiKbtqiHb4V7-image.png) Далее на платформе Metabot24 в настройках своего бота выполнить следующие действия: - Перейти в настройки бота в раздел **Настройки бота** подраздел **Каналы**; - Нажать кнопку **Новая привязка** и выбрать канал **Umnico**; - В поле **Токен** вставить скопированный токен; - В поле **Логин менеджера** вставить логин пользователя из **Umnico** и сохранить настройку. [](https://docs.metabot24.ru/uploads/images/gallery/2024-03/M5fVLsgcuE2Ic7AX-image.png) Найти **Логин менеджера** можно на сайте Umnico. [](https://docs.metabot24.ru/uploads/images/gallery/2024-03/fB9Ymmkw5xiqWC8d-image.png) Новая привязка создана и для завершения настройки необходимо нажать ссылку **Вебхук**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-03/QEkaAERqqqD9A5ZO-menyu.png) Далее необходимо подтвердить или отменить выполняемую операцию. Оставьте версию без изменений, как было предложено. [](https://docs.metabot24.ru/uploads/images/gallery/2024-03/6B1w0FYtdzkWQGBh-image.png) Подключение к сервису Umnico завершено! # Подключение распознавания файлов в различных каналах ### Редактирование настроек канала Metabot Widget В канале **Metabot Widget** через редактирование необходимо:  1. Поставить активность чекбокса **Разрешить отправку файлов**. 2. В поле **Список поддерживаемых расширений файлов** добавить список разрешенных форматов файлов:| pdf,doc,docx,xls,xlsx,csv,txt,png,jpe,jpg,jpeg,gif,bmp,ico,svg,svgz,tif,tiff,jfif,ai,drw,pct,psp,xcf,psd,raw,webp,xbm,dib,pgp,apng,pjpeg,avif,avi,divx,flv,m4v,mkv,mov,mp4,mpeg,mpg,ogm,ogv,ogx,rm,rmvb,smil,webm,wmv,xvid,3gp,3g2,qt,asx |
| **Текст команды** |
| {{ $randomAnswer }} |
| **Текст команды** |
| Файл принят, передадим на изучения группе поддержки. С вами свяжутся либо через чат-бота, либо через имеющиеся контакты. А пока что можете воспользоваться автоматическим функционалом чат-бота. |
| **Получатель** | email, на который необходимо отправить письмо. (**{{ $bot.botSupportMails }}**) |
| **Тема** | **\*Название бота поддержки\***: лид отправил в бота файл |
| **Содержимое** | В чат-боте пользователь прислал в бота файл <br> <br>ID клиента для поиска в диалогах на платформе Metabot: {{ &$leadId }} <br> <br>Ссылка на файл: {{ $is\_attachment }} <br> <img src="{{ $is\_attachment }}" alt="Отправленный файл" width="400" height="341" /> <br> С уважением, <br> Ваш Metabot |
При необходимости, можно создать системный атрибут с ключом **botSupportMails**, типом **variable** и значением равным всем почтам, на которые должно поступить письмо.
- **Последней командой** должна идти команда **Повторить вопрос**. ### Как достать данные вложений Для Telegram используйте метод bot.**getAllAttachments**() ```JavaScript let attachments = bot.getAllAttachments() if(Boolean(attachments?.[0]?.url)){ uploadData = bot.downloadFileFromUrl(attachments[0].url) msg.debug('Пользователь отправил файл: ' + uploadData.url) lead.setAttr('file', uploadData.url) } ``` Для других каналов bot.**getWebhookPayload**() ```JavaScript let attachments = bot.getWebhookPayload() if(attachments.payload.attachments[0].url){ uploadData = bot.downloadFileFromUrl(attachments.payload.attachments[0].url) lead.setAttr('file', uploadData.url) } ``` В данных примерах в атрибут записывается url вложения для скачивания с помощью метода bot.**downloadFileFromUrl**(). # Битрикс24 Создать новый портал Битрикс24 вы можете самостоятельно, просто перейдите по [ссылке](https://www.bitrix24.ru/?p=8731059) и пройдите регистрацию. Далее мы сможем вам помочь его настроить под ваш бизнес. ### Настройка канала Битрикс24 Для интеграции портала **Битрикс24** c платформой **Metabot24** необходимо в настройках своего бота выполнить следующие действия: 1\. В меню **Настройки** разделе **Каналы** создать новый канал, нажав на кнопку **Новая привязка**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/3kEUpze6KqlkUIOY-image.png) 2\. Далее в диалоговом окне выбрать из списка канал **Bitrix** и нажать кнопку **Создать**, оставив остальные поля не заполненными. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/Pqe9LPerxBNoqrJD-image.png) 3\. Новая привязка создана, далее необходимо нажать ссылку **Вебхук.** [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/it14uruSlmWJW5I6-image.png) 4\. Подтвердить выполняемую операцию. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/Goj3rwPQEwtW2vLw-image.png) 5\. Обновить страницу **Привязка к каналам** и скопировать созданный вебхук. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/yS4lYpTNz0OEPMQT-image.png) 6\. Перейти на свой портал Битрикс24 в раздел **Приложения**, в подраздел **Разработчикам**. Далее раздел **Готовые сценарии**, в подразделе **Другое**, выбрать **Локальное приложение**.Настройки интеграции в Битрикс24 должен проводить пользователь с правами **Администратор**.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-06/CMKAazarh453mFmx-image.png) 7\. В открывшемся диалоговом окне на вкладке **Серверное** установить параметр **Использует только API**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/dvS9VTe70RYCv8wS-image.png) 8\. Далее добавить следующие параметры: - **Путь вашего обработчика**\* — вставить скопированный вебхук с платформы Metabot24; - **Путь для первоначальной установки** — вставить скопированный вебхук с платформы Metabot24; - В блок **Настройка прав** добавить разделы: - CRM; - Чат и уведомления; - Создание и управление Чат-ботами; - Пользователи; - Списки; - Открытые линии. 9\. После проверки всех указанных параметров нажать на кнопку **Сохранить**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/yVUwmUo4arvVitNf-image.png) 10\. Последовательно скопировать **Код приложения (client\_id)** и **Ключ приложения (client\_secret)** обратно в настройки привязки к каналам на платформе. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/QwyzwRUwVk2YPwVE-image.png) 11\. Для этого перейти на платформе в раздел **Настройки -> Каналы** и открыть канал Bitrix для редактирования. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/eX0LKDOeSVrcqpRO-image.png) 12\. Вставить последовательно скопированные **Код приложения** и **Ключ приложения** и сохранить данную настройку, нажав кнопку **Сохранить**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/tv0USWK0qRXOMKvh-image.png) Если все сделано правильно, то настроенный канал Bitrix будет выглядеть следующим образом. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/JEDzUI0A3r2oMgVv-image.png) ### Настройка Открытых линий в Битрикс24 Открытые линии в Битрикс24 собирают сообщения со всех каналов, распределяют их по очереди, маршрутизируют между сотрудниками, и все это в режиме реального времени. И в них можно настроить чат-бот, который облегчит работу сотрудников, систематизирует обращения и многое другое. Создавать **Открытые линии** может администратор Битрикс24 в **Контакт-центре** – нужно всего лишь выбрать любой канал. Итак, рассмотрим подключение **Открытой линии** на примере канала Telegram. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/hmRBrGgRTvPkAVwp-image.png)Как провести подключение канала, можно ознакомиться в инструкции Битрикс24 или обратиться в нашу службу поддержки по удобному каналу связи на странице [Помощь](https://app.metabot24.com/help).
В диалоговом окне подключенного канала необходимо произвести настройку **Открытой линии**, для этого с помощью кнопки **Настроить** перейти к ее настройкам. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/WHrG96CsejUfyUsR-image.png) В настройках перейдите на вкладку **Чат-боты**, активируйте разрешающий чек-бокс и заполните остальные поля, как указано на рисунке. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/bfKErOmpctt2LCRt-image.png) На вкладке **Автоматические действия** также рекомендуем провести настройки по отключению автоматических сообщений. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/zzVchpGpRN1hs2q6-image.png) ### Настройка статусов После настройки интеграции канала необходимо выполнить синхронизацию статусов. В меню **Настройки** разделе **Статусы** выполните следующие действия: 1. Нажмите кнопку **Синхронизация.** 2. Подтвердите или отмените выполняемую операцию. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/FJ51XZ0dIugcjqWc-image.png)Следует помнить, что изначально рекомендуем в боте наименования статусов устанавливать идентично используемым по воронке статусам справочника **Лиды** в Битрикс24.
Синхронизация завершена успешно, если в списке **Статусов** появятся записи с заполненным полем **Внешний ID**, которое является идентификатором статуса в Битрикс24.
### Работа бота в Открытой линии Диалог пользователя с чат-ботом представлен на рисунке: [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/Gue2OpOjzm9l8Dvp-image.png) В Битрикс24 данный диалог можно открыть из карточки лида. [](https://docs.metabot24.ru/uploads/images/gallery/2024-06/LXRxC6VqIUHK1cds-image.png) # Pyrus Интеграция сервиса [**Pyrus**](https://pyrus.com/ru) с [**Metabot**](https://app.metabot24.com) позволяет подключить бота в задачи по Формам в любых каналах связи. При этом, все новые диалоги вначале будут отправляться боту. По сценарию бот, предварительно собрав информацию и запросив контактные данные, далее может переключить диалог на оператора.Уроки с шаблонами можно посмотреть в **[документации Metabot](https://docs.metabot24.ru/books/02-ucimsya-na-primerax)**, там же вы найдете инструкции по подключению бота в каналы.
1. Для настройки интеграции с Pyrus в бизнес-аккаунте должен быть создан пользователь с правами доступа **Пользователь API**, для этого обратитесь в службу поддержки Metabot через раздел [**Связаться с нами**](https://app.metabot24.com/feedback/create) или через виджет на платформе оставить обращение. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/F2Tvv5QLKDp2VBSs-untitled-1.png) 2\. В разделе **Пользователи бизнеса** для появившегося пользователя сгенерируйте API-токен, нажав соответствующую кнопку. Скопируйте и сохраните появившийся в зеленом информационном окне токен. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/kGnX93rlRus9Y4zm-untitled.png)3. Перейдите в раздел **Настройки бота — Внутреннее API**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/yvNDDhkbaOtYLoCI-untitled.png) 4\. Создайте endpont (конечную точку) с алиасом — **pyrus**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/BpchIfvCSA0qqSwQ-untitled-1.png) 5. Скопируйте получившуюся ссылку: https://app.metabot24.com/api/v1/bots/{bot\_id}/call/{alias} — замените в ней **bot\_id** на ID своего бота. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/fa965RtCzr9IlIh3-image.png) Для того чтобы узнать ID, необходимо нажать на редактировать бота в списке ботов и скопировать его ID (это число расположенное в url между /bot/ и /edit). А алиас нужно заменить на **pyrus** (без фигурных скобок).Номер формы будет отображен после подключения аккаунта в Pyrus.
6\. Сохраните создание эндпоинта. #### Настройка чат-бота В списке скриптов создайте отдельный раздел для команд, которые будут работать в связке с эндпоинтом. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/FYH67GZzY0BbIggK-image.png) Название раздела и скриптов может быть произвольным, но коды ОБЯЗАТЕЛЬНО нужно перенести в предлагаемом виде: - **pyrus\_callback** — запускает перевод на общение из задачи; - **pyrus\_close\_task** — завершает диалог и возвращает в бота. В скрипте перевода диалога на Pyrus необходимо создать: команду **Выполнить JavaScript Callback** с кодом:В коде используется функция pyrus.getOperatorName(), которая возвращает значение — "Имя" или пустое значение. Также в коде callback есть текст "Оператор", который можно заменить на значение на любом языке, это используется в мультиязычных чат-ботах и когда интерфейс pyrus отличен от русского.
В коде используется системный [атрибут бота](https://app.metabot24.com/bot-attribute), в котором необходимо изменить значение, подставив цифровое значение после подключения.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-09/Aup50NHNXPoIwPX0-izobrazenie.png)Именно этот скрипт отвечает за беспрерывное общение в задаче.
И завершить его может либо кодовые слова, прописанные в переменной **patterns**, либо закрытие задачи, которое можно настроить в боте с переводом в любой сценарий. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/lxJj1FhQai1gJcgr-image.png)Если вы хотите, чтобы ваш бот в Telegram мог принимать файлы (фото, аудио и т.д.), не забудьте указать это при создании канала.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-09/Z8shzsLF2iNwINsw-photo-2024-09-12-14-38-19.jpg) Далее настройки следует произвести в самом Pyrus. ### Настройка расширения в Pyrus Чтобы Pyrus отслеживал сообщения, приходящие при передаче диалога от чат-бота. созданного на платформе Metabot, и автоматически создавал по ним заявки, включите интеграцию вашего аккаунта в Metabot с формой обработки клиентских обращений. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/C7jwhq22knteVOoY-izobrazenie.png) Бот преобразует ваши разговоры в любом канале, подключенном на платформе Metabot в комментарии к задачам в Pyrus и позволяет вам управлять ими так же, как и обычными задачами. Сотрудники смогут отвечать клиентам из Pyrus прямо в тот канал связи, в котором ранее обращался пользователь (Telegram, Viber, VK, WhatsApp, виджет на сайте), завершать задачи, добавлять других участников в разговор и использовать любой другой функционал Pyrus. Чтобы сообщения клиентов из чат-бота попадали в задачи Pyrus, подключите расширение **Metabot** к нужной форме — новой или уже существующей. Перейдите в настройки формы и в списке расширений найдите **Metabot** и нажмите **Подключить.** [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/SoahybzAEdxGMBw8-untitled.png) В настройках расширения необходимо указать **Эндпоинт Metabot** и **Токен**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/B8CBuGc6Jl06ELLE-untitled.png) В поле **Эндпоинт Metabot** вставляем ссылку, которую берём во внутреннем API (https://app.metabot24.com/api-internal-endpoints) с предварительно измененными параметрами в п.3. В поле **Токен** вставляем значение, которое генерируем в разделе **Пользователи бизнеса** https://app.metabot24.com/user, в п.2. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/92C7sfFSsxzoLrr8-untitled-1.png) Нажмите кнопку **Подключить аккаунт**. Генерируется номер аккаунта, это значит что аккаунт успешно подключен.Номер формы — это цифры после **Account**.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-08/Ut1pDtPrOCUTvfI5-untitled.png) Теперь, когда клиент будет общаться с ботом, вы получите его в Pyrus. А ваши ответы он увидит в сообщениях в том канале связи, в котором он общался с ботом. Все API запросы будут записываться в [**Лог**](https://app.metabot24.com/admin/api-logs).Логи можно обрабатывать с помощью JS кода в блоке эндпоина, который вы указали.
### Возможности интеграции #### Отправлять и принимать сообщения При запуске на платформе Metabot скрипта **callback\_pyrus** происходит следующее: - Если это был первый запрос пользователя, то при переходе диалога в Pyrus вся история его переписок поступит комментарием в задачу по Форме, к которой подключено расширение. В блок с отправкой сообщений пропишется имя аккаунта и мессенджер; [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/WkukMXEnYa4wjv6d-untitled.png) - Если это не первый запрос пользователя, то отправиться только само сообщение от пользователя; - Если менеджер закрыл диалог с пользователем, т.е. закрыл задачу, нажав на кнопку **Завершить**, а человек подал новый запрос, то загружается вся история с момента последнего диалога;Для корректного завершения задачи и возврата диалога боту необходимо, чтоб в настройках интеграции для нужной формы было выдано разрешение на отслеживание внутренних событий.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-09/RkcylP6UQ8PpIXmB-izobrazenie.png) - Если менеджер закрыл диалог с пользователем, прошло время больше количества часов/дней, которые были указаны в настройках Формы и пользователь задал вопрос повторно, то создается **новая** задача без истории;Часы/дни можно изменить в настройках формы.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-08/AflI7Qr27WwTJM5f-izobrazenie.png)Происходит вновь открытие задачи и добавляется новый комментарий
[](https://docs.metabot24.ru/uploads/images/gallery/2024-08/h3n8qAYDTo7dH6fD-izobrazenie.png) - Файлы можно отправлять в чат-бот и принимать из чат-бота в каналах связи: **Telegram** и **Виджет на сайте** только в том случае, когда открыт диалог с пользователем.В настройках канала обязательно должна быть включены следующие опции: Реакция на фото, файлы и видео - **Штатная (NLP и меню)**
[](https://docs.metabot24.ru/uploads/images/gallery/2024-08/sfqUthKX2C3fSimm-izobrazenie.png) - На платформе можно настроить **Маршрут** бота с регулярными выражениями. Например, когда пользователь пишет **“бот"** или **“меню"** (без кавычек), то для его диалога запускается скрипт с меню и обновляется атрибут, в котором указывается что диалог закрыт. #### Работа менеджера - Менеджер из задачи в Pyrus может останавливать диалог, написав команду — **/stop**;Пользователю отправляется сообщение, что его диалог Завершен и запускается скрипт **Главного меню**. Задача в Pyrus при этот действии не закрывается.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-08/2BffCsTpa8QqrMas-izobrazenie.png) - Менеджер из задачи в Pyrus может переводить пользователя в определенную точку сценария на запуск скрипта, написав команду — **/go + ID<скрипта>**; - В диалоге пользователя в мессенджере отображается **Ответственный менеджер**, который ведет в донное время диалог с пользователем.Имя оператора меняется после смены **Ответственного** в Pyrus и после отправки сообщения пользователем.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-08/OT9plgZRHMZCHl6m-untitled.png) [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/Zzwcqwb5sRZTxeYt-izobrazenie.png) #### Закрытие задачи При закрытии менеджером задачи по кнопке **Завершить**, она закрывается и на платформе **Metabot**. Пользователю отправляется сообщение и запускается скрипт **Главного меню**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/aoNntlDkGpzmEkh5-izobrazenie.png) #### Запрос и передача данных Для того чтобы передать контактные или запрошенные у пользователя данные в соответствующие поля задачи по Форме, необходимо сохранить эти данные в переменную **mappings**. ```JavaScript let mappings = [{ "code": "SenderName", "value": lead.getAttr('clientName') }, { "code": "Subject", "value": "Задача: " + lead.getAttr('Задача') }, { "code": "PhoneNumberFrom", "value": lead.getAttr('sys_phone') }, { "code": "SenderEmail", "value": lead.getAttr('sys_email') }, { "code": "CustomFields1", "value": lead.getAttr('источник') }, { "code": "Message", "value": "Компания: " + lead.getAttr('company') + '\n' + "Сфера деятельности: " + lead.getAttr('Ниша') }, { "code": "MetabotLeadId", "value": leadId.toString() } ] lead.setJsonAttr("mappings", mappings) ``` #### Как получить коды полей code 1\. Перейдите в раздел **Формы**. 2\. Выберите необходимую форму. 3\. Перейдите в раздел **Настройки**. 4\. Откройте вкладку **Шаблон**. 5\. В настройках шаблона просмотрите или измените коды полей. [](https://docs.metabot24.ru/uploads/images/gallery/2024-09/bJuqidPOi97NG9Hj-izobrazenie.png) > На данный момент доступны **ТОЛЬКО** следующие типы полей с соответствующими кодами: > > \- `SenderName` — Имя отправителя; > \- `Subject` — Тема сообщения; > \- `PhoneNumberFrom` — Телефон клиента; > \- `SenderEmail` — Эл. почта клиента; > \- `Message` — Описание; > \- `Attachments` — Файлы; > \- `MetabotLeadId` — MetabotLeadId (передача ID лида Metabot, с которым связана задача) ***обязательное поле***; > \- `OpenOrClose` — Открыта / Завершена. > > 5 кастомный текстовых поля, которые можно переименовать, сохранив коды без изменений: > > - CustomFields1 — Кастомное поле 1, тест; > - CustomFields2 — Кастомное поле 2, тест; > - CustomFields3 — Кастомное поле 3, тест; > - CustomFields4 — Кастомное поле 4, тест; > - CustomFields5 — Кастомное поле 5, тест. > > Все остальные добавляются по запросу.Обязательным для заполнения полем является только поле **MetabotLeadId**, менять код поля запрещено! По сопоставлению данного поля происходит связка лида в Метабот и в Pyrus.
Здесь можно прописать любые данные, которые получает чат-бот во время диалога с пользователем. В текущей настройке расширения доступны следующие переменные, которые будут записаны в соответствующие поля формы. [](https://docs.metabot24.ru/uploads/images/gallery/2024-09/miFysQp56WX9AmNs-izobrazenie.png)Набор полей и переменных может быть изменен при разработке чат-бота на платформе Metabot, для этого необходимо обратиться в службу поддержки Metabot через раздел [**Связаться с нами**](https://app.metabot24.com/feedback/create) или через виджет на платформе оставить обращение.
При передаче и обновлении данных в Pyrus отображается комментарий по данному действию. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/2Hcg7tgTNaBNIO4i-izobrazenie.png) ### Работа в Форме задачи в Pyrus При переводе диалога из канала связи чат-бота в Pyrus, в преднастроенной форме создается задача. В блоке Форма по полям прописываются переменные, которые собраны ботом в ходе диалога при текущем обращении пользователя или при ранее созданных обращениях. Эти переменные хранятся на платформе Metabot и передаются в Pyrus в момент работы скрипта интеграции. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/xj84M5USwDV0D8FY-izobrazenie.png) Ответственный менеджер ведет переписку с пользователем в блоке **Metabot**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-08/GS5OISsjGgY4KOfC-izobrazenie.png)Для мобильного приложения Pyrus на данный момент не доступна возможность отвечать в сторонние каналы, в том числе и в Метабот. Доработка взята в дорожную карту развития Pyrus, но сроки не известны.
Если аккаунт только создан, то необходимо **активировать пробный период**.
[](https://docs.metabot24.ru/uploads/images/gallery/2024-07/0fZfK7qFyopaY4Ev-image.png) В разделе **Главная** необходимо добавить новую точку контакта. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/mY6iCNuPXiAh1dZm-image.png) Нажмите на кнопку **Добавить**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/IlT3Djtd2ifA58Q6-image.png) Новая точка контакта должна быть с типом **Messaging API**, наименование можно указать произвольное. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/mUCmAxIDogha0N6v-image.png) Нажмите на кнопку **Ключ доступа** и сгенерируйте ключ доступа. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/bT3mZoBmhw4mL9qI-image.png) У созданной точки необходимо скопировать ключ доступа. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/bae9Akv1Zb2mxKZv-image.png) На платформе Metabot24 в настройках своего бота необходимо выполнить следующие действия: 1. Перейти в раздел **Настройки бота** подраздел **Каналы**. 2. Нажать кнопку **Новая привязка** и выбрать канал **LiveTex** **(Chat Center)**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/XBxbAMSsrHqD5aN0-image.png) В диалоговом окне указать следующие параметры: - **Канал** — по умолчанию подставляется наименование создаваемого канала; - **Заголовок сообщений бота** — произвольная фраза, которая будет отображаться в чат-центре над сообщениями от Бота, рекомендуем вставить эмодзи для визуальной наглядности; - **Заголовок сообщений лида** — произвольная фраза, которая будет отображаться в чат-центре над сообщениями от Лида, рекомендуем вставить эмодзи для визуальной наглядности; - **Исключаемые каналы** — установить активность чекбокса на тех каналах, которые не должны попадать в чат-центр LiveTex: - **Umnico**, **Bitrix**, **Jivo**, **Webim** — каналы, в которых реализованы чат-центры, рекомендуем на них установить активность чекбокса; - **Telegram**, **Metabot** **Widget**, **Viber**, **Vk** — прямые каналы, которые можно объединить в чат-центр LiveTex; - **Токен** — скопировать из буфера обмена ключ доступа сгенерированный при создании точки контакта в LiveTex. Сохранить настройки. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/DOKFH3VaVsuzYGhv-image.png) Далее нажмите пункт **Вебхук**, тем самым Metabot24 через API настроит канал на отправку оповещений. ### Настройка чат-центра Пользователь, зарегистрированный в сервисе **LiveTex**, также является первым оператором. Для работы с чат-центром необходимо скачать приложение в личном кабинете через меню пользователя. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/XobqzjXq8KJWEjwn-image.png) Произведите настройки аккаунта LiveTex для дальнейшей интеграции с платформой Metabot24, перейдя в раздел **Настройки**, подраздел **Сотрудники**, добавьте дополнительных операторов, нажав на кнопку **Добавить сотрудника**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/0nFkATd0PsX8aPDB-image.png) Далее в разделе **Настройки** подразделе **Маршрутизация** на правой секции **Сотрудники группы** добавить заведённого сотрудника в список, нажав кнопку **Добавить**. В левой секции по умолчанию только одна группа **Группа для Messaging AP****I**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/wehvqYDhgBFP7e9p-image.png)На текущий момент в Metabot24 при работе с LiveTex выбирается первая группа по порядку (не по имени или коду), то есть заложен функционал работы с одной группой.
После подключения канала все сообщения пользователя начинают отправляться в **LiveTex**. При этом, если по сценарию взаимодействие происходит с Ботом, то есть не выполнен перевод на Оператора, то Операторы не видят эти сообщения в **LiveTex**. История переписки появляется у Оператора только после переключения диалога с бота. ### Дополнительные возможности 1\. Реализована поддержка следующих типов сообщений с платформы Metabot24: - Текстовое сообщение; - Передача изображений, видео; - "Меню", выводится в виде текста; - Вложения различных типов.Выбор пользователем пункта **Меню** отображается в истории сообщений в виде кода скрипта пункта Меню.
2\. При переводе диалога на Оператора пользователь получает сообщение **Диалог переведён на оператора**. Далее при прочтении первого сообщения Оператором пользователь получает сообщение **Оператор <имя оператора> подключился к диалогу**. 3\. Поддерживается перевод чатов между Операторами. Если был произведён перевод чата на другого оператора, то после прочтения диалога опять выводится сообщение **Оператор <имя оператора> подключился к диалогу**. 4\. При закрытии чата Оператором пользователь получает сообщение **Оператор вернул диалог боту**. 5\. На платформе Metabot24 поддерживается функциональная возможность передачи атрибутов Лида для LiveTex. Для этого имеется функция **setLiveTexAttr**. Все переданные атрибуты будут отображены в шапке диалога в LiveTex. Пример вызова: ```JavaScript attr = { 'номер_заявки': 705, 'имя_заявки': 'Test', }; lead.setLiveTexAttr(attr); ``` Функция записывает данные параметры в атрибуты лида с ключом ***sys\_livetex\_attrs*** с типом ***system***. При переводе диалога на Оператора они считываются и передаются в LiveTex. 6\. Если Операторов нет онлайн, то можно использовать скрипт с типом **Нет доступных операторов**. При переводе на оператора выполняется проверка наличия хотя бы одного Оператора со статусом online. Если таких нет, то вызывается скрипт с вышеуказанным типом. 7\. Имеется возможность выполнить проверку доступности операторов и после этого определить, какой скрипт запустить с типом **Перевод на оператора (онлайн)** или **Перевод на оператора (оффлайн)**. ### Каналы связи LiveTex На текущий момент LiveTex обеспечивает следующий список каналов связи для возможного подключения: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/KZt607SG55TRImLP-image.png) # Webim Интеграции сервиса Webim с Metabot24 позволяет подключить бота в диалоги с клиентами в любых каналах связи. При этом, все новые диалоги вначале будут отправляться боту. По сценарию бот может переключить диалог на оператора. История диалогов с ботами автоматически сохраняется в архиве. ### Подключение интеграции Создайте новый аккаунт Webim или войдите в существующий. Произведите настройки аккаунта Webim для дальнейшей интеграции с платформой Metabot24, перейдя в раздел **Отделы**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/lWjR7BOZ3sJQIU8q-snimok-ekrana-2024-07-15-155621.png) Для реализации работы с переводом на оператора необходимо создать в аккаунте Webim, как минимум 2 отдела: 1. Один отдел с сотрудником без бота. 2. Второй отдел с ботом. Для того, чтобы по умолчанию диалог стартовал с ботом, надо ему выставить более высокий приоритет в поле **Порядок сортировки**. Например, можно произвести минимальные настройки отделов в такой форме: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/kFSK2GeBXtNTq4FS-image.png) Далее перейдите в раздел **Сотрудники**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/KXu2hJC6x0D6pjRy-snimok-ekrana-2024-07-15-160140.png) Для работы необходимо зарегистрировать как минимум 3-х сотрудников: 1. Первый сотрудник, он же может быть и администратором аккаунта Webim, должен быть включен в отдел **Операторы**. 2. Второй сотрудник, через которого будет работать бот, должен быть включен в отдел бот, с наивысшим приоритетом в поле **Порядок сортировки**. 3. Третий сотрудник, это будет оператор, на которого будет переводиться диалог, должен быть включен в отдел **Операторы**. Для регистрации нового сотрудника нажмите кнопку **Зарегистрировать нового сотрудника**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/4ikstE6vOkNHXNPh-image.png) Далее перейдите в раздел **Боты**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/PUiEPpL9OPNooj85-snimok-ekrana-2024-07-15-160535.png) Нажмите кнопку **Создать нового бота** и установите первоначальные настройки. В диалоговом окне указать следующие параметры: - **Оператор для бота** — указать имя сотрудника, под которым будет работать бот; - **Тип бота** — Умный бот; - **Порядок сортировки** — по умолчанию 100; - **Версия** — указать параметр 2; - **Ссылка на внешний API** — указать любое значение, например, https://ya.ru, в дальнейшем будет редактироваться; - **Токен авторизации** — будет заполнен автоматически после сохранения настроек. Сохранить настройки. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/ars9zjpYZhYeL9gk-image.png) Скопируйте в буфер обмена токен из меню **Редактирования бота**, который сгенерируется после создании бота в Webim: [](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. Сохранить настройки. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/s1qQt6D0U9hRhDhA-image.png) Далее нажмите пункт Вебхук и скопируйте сгенерированный вебхук. При копировании обратите внимание, чтобы не было в начале и в конце строки знаков «пробел». [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/Ps0DOny2CTbXAdDd-snimok-ekrana-2024-07-15-161816.png) Перейдите в личный кабинет Webim в раздел **Боты** и нажмите редактирование бота: В поле **Ссылка на внешний API** вставьте скопированный вебхук с платформы Metabot24 и сохраните настройки. ### Настройка каналов общения После подключения интеграции с Metabot24 необходимо произвести настройку каналов общения в Webim. Для этого перейдите в раздел **Общие настройки**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/Wwtc7742AhxwNyoy-snimok-ekrana-2024-07-15-162245.png) Перейдите в подраздел **Каналы общения** и произведите настройки каналов, согласно документации и рекомендациям Webim, например, Telegram: [](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" без кавычек. Сохранить настройку. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/CqM18o9vznj5zPPP-snimok-ekrana-2024-07-15-162655.png) На этом всё. Бот подключен и готов к работе. Мы рекомендуем вам провести несколько тестовых диалогов, чтобы убедиться в правильности настройки сценариев. Увидеть активность пользователей при взаимодействии с ботом вы можете в разделе **Лиды** в личном кабинете Metabot24. ### Дополнительные возможности Если чат переведён на оператора, для того чтобы вернуть его обратно на бота, нужно в панели Webim начать набирать ответный текст. При этом появляется функциональная кнопка **Перенаправить**, нажав на которую нужно выбрать оператора, на которого настроен бот. [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/zBsvECVubz5KWAPg-image.png) Реализована поддержка следующих типов сообщений с платформы Metabot24: - Текстовое сообщение; - Кнопочное меню; - Вложения различных типов. Если чат переведен на оператора лидом или ботом через скрипт на платформе, то диалог должен закрыть оператор по кнопке **Закрыть** или он закроется автоматически по таймеру — Тайм-аут автозакрытия чата с момента последней активности. Таймеры настраиваются в разделе **Общие настройки**, подраздел **Тайм-ауты и сообщения**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/pVwTaZdmx1ueIk5F-snimok-ekrana-2024-07-15-162925.png) После выполнения тайм-аута окончательного закрытия чата, если по лиду установлен параметр **Чат передан оператору**, то данный признак сбрасывается и выполняется скрипт с типом **Возврат**. ### Каналы связи Webim На текущий момент Webim обеспечивает следующий список каналов связи для возможного подключения: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/Dhm031a1MpheUdgJ-image.png) ### Размещение чата на сайте Для того, чтобы получить код чата для размещения на сайт, необходимо перейти в раздел **Настройки** — **Кнопки и размещения**: [](https://docs.metabot24.ru/uploads/images/gallery/2024-07/owjjNOyFR7kkYkSu-snimok-ekrana-2024-07-15-163424.png) В блоке **Код для сайта** размещен HTML-код, который необходимо вставить в код веб-страниц вашего сайта, лучше всего в шаблон. Параметр **Обращение для отдела** необходимо оставить по умолчанию без отдела. # Viber Создать новый или настроить существующий бот Viber можно по ссылке: [https://partners.viber.com/account/create-bot-account](https://partners.viber.com/account/create-bot-account) Для интеграции канала Viber c платформой Metabot24 необходимо зайти в аккаунт Viber по ссылке выше и в открывшемся блоке **Создать бот** установить следующие параметры: - **Account Image** — картинка, которая будет являться аватаркой бота; - **Account Name** — имя вашего бота латинскими буквами или на английском языке; - **Url** — заполняется автоматически по имени бота;**Внимание!!!** Поле Url в дальнейшем изменить нельзя, не редактируемое.
- **Category** — категория вашего бизнеса; - **Language** — используемый язык; - **Account Description** — описание вашего бота; - **Website Address** — адрес вашего сайта. Не обязательное для заполнения; - **Email Address** — адрес электронной почты; - **Location** — местоположение вашей компании на карте. Далее активируйте все чекбоксы и нажмите кнопку **Create**. В информационной окне появится токен нового бота, его необходимо скопировать в буфер обмена. Если бот уже ранее был создан и подключается к Metabot24, то необходимо скопировать ранее созданный токен. Далее перейдите в настройки бота в раздел **Настройки бота** подраздел **Каналы**. Нажмите кнопку **Новая привязка** и выберите канал **Viber**, вставьте токен и сохраните настройку. Если у вас бот с меню самообслуживания, то можно установить активность параметра **Использовать inline-кнопки**. [](https://docs.metabot24.ru/uploads/images/gallery/2024-09/63TsJTKJPsYopCqT-image.png) Новая привязка создана и для завершения настройки необходимо нажать ссылку **Вебхук**.Подключение к каналу Viber завершено.
Вы можете разместить на сайте кнопку со ссылкой на вашего бота в Viber, например, [viber://pa?chatURI=metabot24](viber://pa?chatURI=metabot24), где metabot24 — это url вашего бота. # Как из чат-бота создать лид в Битрикс24 Средства интеграции с внешними системами по API, доступные в платформе Метабота, позволяют выполнять обращения в сторонние системы в любом месте сценария диалога, если возникает такая необходимость. Разработка интеграций осуществляется с помощью встроенного в ядро платформы V8 JavaScript Engine от Google. Благодаря встроенному языку программирования перед разработчиками открываются неограниченные возможности для профессиональной разработки чат-ботов и чат-приложений. Наличие огромного количества материалов по JavaScript в профессиональных сообщества Интернета, таких как StackOverflow, делают разработку с помощью платформы Метабот такой же привычной и естественной как и разработка на чистых языка программирования. Для работы с данными вам доступны таблицы с настраиваемыми полями, а также локальные (пользовательские) и глобальные (на уровне бота/приложения) атрибуты и тэги. Пользователям не являющимися профессиональными разработчиками разобраться с интеграциями будет гораздо сложнее. Ниже мы делимся примером бота, который принимает анкету в мессенджере и затем регистрирует новый лид в платформ Битрикс24. #### Настройте Webhooks на стороне Битрикс24 Создайте новую интеграцию для входящего веб-хука, у которой настройте права на доступ к CRM.Если вы это делаете впервые, воспользуйтесь статьей [Веб-хуки. Быстрый старт](https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=99&LESSON_ID=8581).
Скопируйте «Вебхук для вызова rest api». На следующем шаге вам понадобится ввести этот адрес в настройках вашего бота в Метабот. [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/kBVGcGtLMV5xfqwX-image.png) #### Добавьте системные атрибуты в бота на стороне Metabot Создайте две системных атрибута у вашего бота, которые используются при формировании API запросов: 1\. Заголовок API вызова ``` sys_api_headers: {"Accept":"application/json"} ``` [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/Vu4PQVbkY4B1Aq99-image.png) 2\. Адреc веб-хука для вызова Rest API ``` sys_api_http_client_config: {"base_uri":"https://ваш_домен.bitrix24.ru/rest/24/ccyr5i4ptyg4neyw/"} ``` [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/UshO6Yx7n12TOd4x-image.png) #### Создайте в боте сценарий с анкетой Например, вы можете собрать следующий сценарий из шести полей: [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/Bym6SATVlT9ncnKe-image.png) Обратите внимание, что мы рекомендуем сохранять телефон и email пользователя в системные поля sys\_phone и sys\_email. Платформа использует эти поля для внутренних целей, например, они подставляются в таблицу при экспорте контактов. #### Добавьте в боте вызов API метода для создания лида в системе Bitrix24 Перед командой Стоп добавьте вызов JavaScript следующего вида: [](https://docs.metabot24.ru/uploads/images/gallery/2025-03/I7s0SPUo3IEPMHL5-image.png) Список и название полей в массиве fields будет зависеть от ваших настроек CRM. Используйте метод **crm.lead.fields**, чтобы узнать список всех полей и узнать требуемый формат полей. ```JavaScript // Добавляем лид в Bitrix24 api.getJson(‘crm.lead.add.json’, {}, [], {«query»: { «fields»: { «TITLE»: lead.getAttr(‘Компания’) + «: запрос в боте на консультацию», «NAME»: lead.getAttr(‘Имя’), «COMMENTS»: «Ниша: » + lead.getAttr(‘Ниша’) + «[Регистрация и верификация в МАХ](https://docs.metabot24.ru/books/03-interfeis-platformy/page/registraciya-i-verifikaciya-v-max "Регистрация и верификация в МАХ")
Чтобы создать бота можно воспользоваться [документацией](https://dev.max.ru/docs/chatbots/bots-create). Для одной организации доступно создание **5** ботов. Каждый из ботов настраивается отдельно. Несколько ботов понадобятся, если, например, у вас несколько представительств и вы хотите взаимодействовать с пользователями от имени каждого из них, или вам нужны разные сценарии диалогов ботов. 1. Перейдите в профиль вашей организации на [платформе](https://business.max.ru/self) 2. В разделе **Чат-бот и мини-приложение** нажмите **Создать** [](https://docs.metabot24.ru/uploads/images/gallery/2026-02/D5ROIquVo8x01vSH-image.png) или если у вас уже есть созданные боты, то нового можно добавить из выпадающего меню: [](https://docs.metabot24.ru/uploads/images/gallery/2026-02/zChD71rzieFr1kgY-image.png) #### Настройки бота Заполните данные в [настройках бота](https://dev.max.ru/docs/chatbots/bots-create#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8%20%D0%B1%D0%BE%D1%82%D0%B0) (его карточке) и нажмите **Создать** [](https://docs.metabot24.ru/uploads/images/gallery/2026-02/pZhGwzTBwatnybN7-image.png) Ник создаётся автоматически по шаблону **idИНН\_bot**. Остальные поля нужно заполнить самостоятельно. После создания и проверки бота можно отредактировать все данные, кроме **ника.** В содержимом полей и логотипе запрещено использовать ненормативную лексику, контент 18+ и данные других компаний. Описание должно соответствовать деятельности вашей организации.| Поле | Обязательность | Описание и формат |
| Название | Да | Название чат-бота, которое отображается в MAX |
| **Формат:** | ||
| - Длина: 1 — 59 символов | ||
| - Допустимые символы: латиница, кириллица, цифры | ||
| - Эмодзи не поддерживаются | ||
| Ник | Да | Никнейм, который отображается в публичной ссылке на чат-бот, например: ник — idИНН\_bot, публичная ссылка — https://max.ru/idИНН\_bot |
| Ник генерируется автоматически по шаблону idИНН\_bot | ||
| Выбрать или изменить его пока нельзя. Когда такая возможность появится, обратите внимание на требования к нику: | ||
| - Должен заканчиваться на «\_bot» или «bot» | ||
| - Длина: 11 — 60 символов, включая «\_bot» / «bot» | ||
| - Должен начинаться с маленькой буквы, без @ | ||
| - Допустимые символы: латиница, цифры и \_ | ||
| Сайт | Нет | Сайт организации |
| **Формат:** | ||
| - Длина: не более 1024 символов | ||
| - Должен начинаться с https:// | ||
| - Допустимые символы: латиница, цифры, точка, дефис | ||
| - Пробелы не поддерживаются | ||
| Логотип | Да | Логотип, который отображается в качестве аватара чат-бота в MAX. Загрузите изображение — после этого вы сразу сможете кадрировать его под необходимые требования прямо на платформе |
| **Формат:** | ||
| - Размер: 500х500 px | ||
| - Не более 5 Мб | ||
| - Cоотношение сторон: 1:1 | ||
| - Формат файлов: .jpg, .jpeg, .png | ||
| Описание | Да | Краткое описание задач, которые решает чат-бот, а также основных функций, преимуществ для клиентов и особенностей использования |
| **Формат:** | ||
| - Длина: не более 200 символов | ||
| - Допустимые символы: латиница, кириллица, типовые и спецсимволы, пробелы, эмодзи | ||
| Телефон компании | Нет | Телефон организации. Для каждого чат-бота можно задать собственный номер |
| **Формат:** | ||
| - Длина: не более 12 символов, включая + | ||
| - Должен начинаться с +7 | ||
| - Пример: +7 (999) 999-99-99 |
Если оставить настройки файлов без изменений, то бот будет реагировать на них вызовом Fallback-а.
Сгенерируйте Вебхук и создастся привязка с данными бота.Не забудьте сгенерировать **Вебхук** в поле **Операции**, иначе операция привязки бота к каналу не будет завершена.
[](https://docs.metabot24.ru/uploads/images/gallery/2026-02/TNWmqz2g9UmCtq9H-snimok-ekrana-210.png) Подключение к каналу завершено. Теперь можно проверить запуск бота. [](https://docs.metabot24.ru/uploads/images/gallery/2026-02/1297QYtjUFdJR8M3-image.png) Нажмите на кнопку **Начать** и бот отправит вам сообщение. [](https://docs.metabot24.ru/uploads/images/gallery/2026-02/f0GfBnJf5POexnmz-image.png) # Регистрация и верификация в МАХДокументация платформы [МАХ](https://dev.max.ru/docs/maxbusiness/connection?utm_source=b2bmax&utm_medium=documentation_1_screen&utm_campaign=landing)
#### Как подключиться в МАХ 1. [Войдите на платформу или зарегистрируйтесь](https://dev.max.ru/docs/maxbusiness/connection?utm_source=b2bmax&utm_medium=documentation_1_screen&utm_campaign=landing) ##### Этап 1. Вход на платформу Регистрация на [платформе](https://business.max.ru/self) только по номеру телефона с подтверждением через SMS-код. Если вы уже зарегистрированы, используйте свои данные для входа (телефон). Если вы впервые на [платформе](https://business.max.ru/self): - Укажите номер телефона — рекомендуем использовать корпоративный номер вашей организации. - Введите код из SMS, который мы пришлём на этот номер. - Готово! Вы авторизовались на платформе. Одному номеру телефона соответствует один профиль организации и привязанные к нему сервисы: чат-боты, мини-приложения, каналы и сервисы партнёров. 2. [Войдите в профиль организации или создайте организацию](https://dev.max.ru/docs/maxbusiness/connection?utm_source=b2bmax&utm_medium=documentation_1_screen&utm_campaign=landing#%D0%AD%D1%82%D0%B0%D0%BF%202.%20%D0%92%D1%85%D0%BE%D0%B4%20%D0%B2%20%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8C%20%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8) ##### Этап 2. Вход в профиль организации Для доступа к сервисам платформы потребуется [создать организацию](https://dev.max.ru/docs/maxbusiness/connection?utm_source=b2bmax&utm_medium=documentation_1_screen&utm_campaign=landing#%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5%20%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8) и пройти [верификацию](https://dev.max.ru/docs/maxbusiness/connection?utm_source=b2bmax&utm_medium=documentation_1_screen&utm_campaign=landing#%D0%92%D0%B5%D1%80%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D1%8F%20%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8). Если у вас уже есть верифицированная организация, перейдите сразу к [выбору сервисов](https://dev.max.ru/docs/maxbusiness/selectionservices). **Создание организации:** Если у вас ещё нет подходящего профиля организации, платформа предложит создать новый: - Введите ИНН вашей организации (10 или 12 цифр), нажмите **Далее → Создать** и следуйте инструкциям на экране. - [Пройдите верификацию](https://dev.max.ru/docs/maxbusiness/connection?utm_source=b2bmax&utm_medium=documentation_1_screen&utm_campaign=landing#%D0%92%D0%B5%D1%80%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D1%8F%20%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8). **Верификация организации:** Пройденная верификация подтверждает, что ваша организация зарегистрирована официально. Верификация доступна для юрлиц и ИП, которые являются резидентами РФ. Её может пройти только владелец организации — единоличный исполнительный орган — или представитель с правом первой или единственной подписи. Если организация не верифицирована, вы увидите экран **Подтвердите организацию**. Чтобы пройти верификацию и получить доступ к сервисам платформы: - Нажмите **Подтвердить** — вы перейдёте в [личный кабинет организации](https://bid.max.ru/profile). - Выберите способ подтверждения (через Госуслуги или банковские сервисы Аlfa ID, Т-Business ID, СберБизнес ID) и проверьте, что выполняются условия подключения. - Справа от выбранного сервиса нажмите **Подключить**. - Авторизуйтесь в аккаунте сервиса. - Если вы используете для верификации способ подтверждения через Госуслуги и у вас несколько организаций, то укажите нужную в окне выбора организации. В этом окне на Госуслугах отображаются только те организации, ИНН которых совпадает с ИНН в профиле на платформе MAX для партнёров. - Подтвердите согласие на передачу данных о вашей организации с помощью SMS-кода. Подтверждение обычно занимает несколько минут. Если подтвердить организацию не удалось: - Напишите нам на почту [partner\_support@max.ru](mailto:partner_support@max.ru) и укажите: - ИНН вашей организации. - Последовательность действий, которые вы выполняли. По возможности приложите в письмо скриншот ошибки — это поможет нам быстрее найти решение. - Готово! Вернитесь на [платформу ](https://business.max.ru/self)и [выберите сервис для интеграции](https://dev.max.ru/docs/maxbusiness/selectionservices). Это может быть бот, канал, мини-приложение или сервис партнёров. **Статусы верификации:** Статус верификации отображается рядом с названием организации в платформе MAX для партнёров| Статус верификации | Аватар организации |
| Организация не подтверждена | |
| Организация подтверждена |