Все параметры кроме **Использовать 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(), } } ); ```