> For the complete documentation index, see [llms.txt](https://metabot.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://metabot.gitbook.io/documentation/lessons/bot-na-baze-umnico.md).

# Бот на базе Umnico

В этом уроке вы узнаете про тонкости создания ботов на базе социальной CRM системы Umnico.

{% embed url="<https://youtu.be/-_OS2OVHYOk>" %}

Чтобы создать бота, вы можете воспользоваться любыми уроками из раздела [**Уроки**](https://metabot.gitbook.io/documentation/lessons) и затем перейти к этому уроку, чтобы подключить вашего бота к сервису Umnico.

### Создание бота

Вы можете быстро создать бот с [Меню самообслуживания](https://metabot.gitbook.io/documentation/lessons/bot-s-menyu-samoobsluzhivaniya) или создать более сложный бот с [применением распознавания естественного языка (NLP)](https://metabot.gitbook.io/documentation/lessons/bot-pervogo-kasaniya-s-nlp).

Предположим, что вы уже ознакомились с указанными уроками и создали бота. Далее мы расскажем, как интегрировать полученного бота в Umnico и про тонкости специфической  настройки этого сервиса.

### Интеграция с Umnico

С [Umniсo](https://umnico.com) возможна настройка интеграций по перечисленным ниже каналам связи:

{% hint style="info" %}
Umnico предлагает следующий список возможных интеграций: Онлайн-чат для сайта, WhatsApp, Instagram, Telegram, Facebook Messenger, ВКонтакте.
{% endhint %}

![Список интеграция от Umnico](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-M-ivedUKBVxZSsc8y2a%2F-M-iyJaoSh1xh08cOcFe%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=1c53739c-3afc-497c-abf4-bfa476b417e4)

Для интеграции сервиса Umnico c платформой Metabot24 необходимо в разделе **Настройки -> API** скопировать ваш API токен, нажав на кнопку ***Скопировать токен***.&#x20;

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-M-UFYj-JoOAawtgnKx9%2F-M-UGbfNYpA-INSNKC89%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=a0b9bc45-c5a4-428a-8ec7-cd3561e88dce)

Далее на платформе [**Metabot24**](https://app.metabot24.com/) в настройках своего бота выполнить следующие действия:

* Перейти в настройки бота в раздел **Настройки бота** подраздел [**Каналы**](https://app.metabot24.com/bot-channel)**.**
* Нажать кнопку ***Новая привязка*** и выбрать канал **Umnico**, вставить токен.
* В поле ***Логин Менеджера*** вставить логин пользователя из Umnico, остальные параметры оставить без изменения и сохранить настройку.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-M1iUizxlGBP8qBLnWOU%2F-M1jUvHjFwZSOeCVzRJd%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=25e6503d-c776-40b5-adf9-8f4b98154fe7)

* Новая привязка создана и для завершения настройки необходимо нажать ссылку **Вебхук.**
* Подтвердить выполняемую операцию.
* Подключение к сервису Umnico завершено.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-M-UFYj-JoOAawtgnKx9%2F-M-UHldkJw7TBD0PzDJc%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=89a027d1-41d5-497b-a96c-5b0c2daca005)

### Особенности работы

После настройки интеграции канала **Umnico** необходимо выполнить синхронизацию статусов.

{% hint style="success" %}
Синхронизация статусов нужна, чтобы связать между собой статусы в Umnico со статусами в вашем боте на платформе Metabot24. После установки связки напротив каждого статуса появится ***Внешний ID*** (т.е. идентификатор статуса в системе Umnico), что означает что связь статусов произошла. Теперь вы сможете менять статус заявок в Umnico из бота, выполняя команду **Изменить статус лида** в скриптах.
{% endhint %}

Для этого на платформе [**Metabot24**](https://app.metabot24.com) в настройках своего бота выполнить следующие действия:

* Перейти в настройки бота в раздел **Настройки бота** подраздел [**Статусы**](https://app.metabot24.com/status)**.**
* Нажать кнопку ***Синхронизация:***
  * Подтвердить или отменить выполняемую операцию.
  * Синхронизация завершена.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-M-TxGrXvu8AuF-45fW9%2F-M-TzfaWjTdcU8ceM9kg%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=7b63587e-ec42-4024-b98d-65c613ff7ee2)

{% hint style="success" %}
Синхронизация завершена успешно, если в списке **Статусов** появятся записи с заполненным полем ***Внешний ID**, которое является идентификатором статуса в Umnico.*
{% endhint %}

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-M-TxGrXvu8AuF-45fW9%2F-M-U-a3HKqF7Mvl6V4Rs%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=d91ed65d-5f2a-429f-aa8b-875a7fa9904a)

Как только проведена синхронизация платформы Metabot с Umnico, то появляется возможность из Metabot управлять статусами в Umnico.

### Передача управления оператору

Поскольку в Umnico отсутствует нативная возможность передавать управление диалогом от бота человеку и обратно, то для эмуляции этой возможности мы добавляем в воронку дополнительный статус ***Диалог с оператором***. Логика работы гибридного бота с человеком получается следующая:

* Бот встречает всех пользователей на самом первом статусе воронки, отвечая на часто задаваемые вопросы и выступая некоторым фильтром обращений;
* Бот при необходимости переводит в статус *Диалог с оператором*;
* Ваши менеджеры не вмешиваются в диалог до тех пор, пока заявка не достигнет статуса *Диалог с оператором*;&#x20;
* Если необходимо вмешаться в диалог с ботом, то менеджер вначале переводит в Umnico заявку в статус *Диалог с оператором*, чтобы остановить бота, а затем общается. После завершения общения переводит обратно в статус для бота или другой статус воронки.

{% hint style="warning" %}
**Внимание!**  Рекомендуем для обеспечения первоклассного клиентского сервиса, при вступлении оператора в диалог, далее менеджерам приветствовать пользователя, сообщать, что в диалог вступил человек и называть свое имя. А по завершении диалога сообщать, что управление передано обратно боту.
{% endhint %}

###
