# Подключение Mango Office
:::caution
ВАЖНО!  Для корректного обмена данными с сервером Mango,  Swarmica должна быть доступна <u>**по доменному имени**</u> по HTTPS из внешней сети Интернет.
:::



## Что дает подключение?

1.  По входящему звонку создается пользователь 7ХХХХХХХХХХ@PHONE
2.  От этого пользователя создается тикет
3.  После окончания разговора в тикет добавляется запись звонка



## Инструкция по подключению

Подключение вашего аккаунта Mango Office к Swarmica позволит передать в Swarmica информацию о звонках и записи звонков. Информация будет передаваться в виде заявки в соответствующий раздел. Заявка содержит номер телефона и запись разговора, если такая опция у вас подключена в Mango. Заявку из Mango можно прикрепить к клиенту, а также добавлять в неё различные внутренние комментарии.

![](https://support.swarmica.com/attachments/t/Y/tYhXH8EVYp8Enb67_a/image.png)

# Настройка подключения

В Mango в боковом меню откройте раздел **Интеграции** и выберите **API-коннектор**:

![](https://support.swarmica.com/attachments/u/3/u39h_G6FwXJ9Q9TI_a/711fec11a68a8c265035d19fd408c88c.png)

Подключение может быть платным. Обратитесь по этому вопросу в поддержку Mango.

Откроется такая страница:

![](https://support.swarmica.com/attachments/r/q/rqdZMoIpImn7gljW_a/image.png)

В соседней вкладке браузера откройте Swarmica и перейдите в раздел **Настройки - Каналы**. Выберите **Mango Office**. Нажмите !["Создать"](https://support.swarmica.com/attachments/O/S/OSMVs0SPyMQfvedW_a/image.png) справа вверху.

![](https://support.swarmica.com/attachments/a/7/a7aKzsKRhPnY9kqP_a/image.png)

Введите **название** - любое произвольное название вашего канала. Затем переключитесь на вкладку Mango "API коннектор", которую вы открыли в предыдущем шаге, скопируйте и вставьте из неё в Swarmica следующие данные.

**Ключ API** в Swarmica - Уникальный код вашей АТС в Mango.

**Ключ подписи** в Swarmica - Ключ для создания подписи в Mango.

Для копирования воспользуйтесь специальными кнопками в правой части каждого из полей.

![](https://support.swarmica.com/attachments/l/X/lXIzCQvJkgR6jau3_a/image.png)

Нажмите в Swarmica !["Сохранить"](https://support.swarmica.com/attachments/_/r/_rYlnonVbh7qHHSp_a/image.png) - вы окажетесь на странице настроек канала Mango.

![](https://support.swarmica.com/attachments/w/N/wNG89yYxh7yLCh1h_a/image.png)

Пропишите в поле **URL** содержимое поля со страницы Mango **Адрес API виртуальной АТС**:

![](https://support.swarmica.com/attachments/J/3/J3Ut_Nl0WwTPHFVd_a/image.png)

Активируйте канал бегунком **Включен** и нажмите **Сохранить**:

![](https://support.swarmica.com/attachments/S/8/S8hNGep86KRnuKm5_a/image.png)

Теперь нужно сгенерировать и прописать **адрес внешней системы** и прописать его в поле ниже на этой же странице Mango. Он имеет такой формат:  https://your\_swarmica\_url/webhooks/mangooffice/XXXXX

Скопируйте этот url в поле **Адрес внешней системы** в Mango&#x20;

![](https://support.swarmica.com/attachments/t/0/t0fAFcpzL3snjgE8_a/image.png)

Замените в нём следующее содержимое.

your\_swarmica\_url - ваш уникальный url, с которым вы входите в Swarmica.

XXXXX - набор символов, которым заканчивается URL на странице настроек Mango в Swarmica, указан на картинке:

![](https://support.swarmica.com/attachments/2/W/2WK3Wz3SOPm9wcDd_a/image.png)

**На странице Mango API коннектор обязательно активируйте следующие настройки.**

![](https://support.swarmica.com/attachments/A/w/Aw2ip3bb3ivh9WpX_a/image.png)

![](https://support.swarmica.com/attachments/s/K/sKl3PiIB0yUUyZ54_a/image.png)

1.  Предоставлять возможность генерации и использования ссылок.
2.  Отправка данных о лиде из Контакт Центра.
3.  Не проверять сертификат.
4.  Не пробрасывать идентификатор SIP\_Call\_ID из внешней системы.
5.  Не отправлять события о статистике диалогов робота.
6.  Не отправлять информацию о событиях в Адресной книге на указанный адрес внешней системы.
7.  Не отправлять события о завершении процесса распознавания тематик.
8.  Не отправлять события Манго Диалоги.