# Интеграция с ВАТС UIS
**Возможности интеграции:**
* **Исходящие звонки** по клику на номер клиента в CRM — АТС перезванивает сначала оператору, затем звонит вызываемому абоненту.
* **Всплывающая карточка** при входящем/исходящем звонке.
* **Прослушивание записей звонко**в прямо в CRM.
* **Переадресация на «знакомого» менеджера** — при входящем звонке производится поиск номера телефона клиента в базе и, если номер найден, звонок переадресуется на менеджера, ответственного за заявку этого клиента.
### Подключение и настройка интеграции
1\. В личном кабинете виртуальной **АТС UIS** необходимо перейти в **Администратор → Аккаунт → Правила и настройки безопасности** вкладка **API**.
Добавить IP-адрес в список разрешенных:\
185.137.232.43; 188.68.217.237; 0.0.0.0/0
2. Перейдите **Администратор → Аккаунт → Тариф и опции**
Для проверки тарифа в **АТС UIS** на предмет услуг **callapi, dataapi, http-уведомления** в биллинге.\
(Все они включены в пакет **API Оптимальный, API Расширенный**).
**Важно!**\
В случае, если услуги **callapi, dataapi, http-уведомления**, отсутствуют, их необходимо подключить.
3. Создайте пользователя MACRO:\
**Администратор → Управление пользователями → Добавить пользователя**
Введите **Имя MACRO** **→ Логин+Парол**ь (формируем самостоятельно) → в описании указать **Интегратор MACRO.**
Предоставьте **Доступ к функциональности API** пользователю **MACRO** → включите **Data API, Call API, Использовать ключ API** (время жизни — вечно) → сгенерировать новый **Ключ API**.
4. В новой вкладке браузера откройте **MacroCRM**, перейдите в раздел \
**Интеграции → Телефония → АТС UIS:**
5. Вставить сгенерированный **Ключ API** в одноименное поле в **MacroCRM:**
### Настроить уведомления
Перейдите **Администратор → Управление пользователями → Уведомления → Добавить уведомление:**
1. **Название уведомления:** incoming\
**Тип события:** Входящий звонок на виртуальный номер\
**Тело:**\
notification\_name={{notification\_name}}\&direction={{direction}}\&virtual\_phone\_number={{virtual\_phone\_number}}\¬ification\_timestamp={{notification\_timestamp}}\&contact\_phone\_number={{contact\_phone\_number}}\&call\_session\_id={{call\_session\_id}}\&employee\_full\_name={{employee\_full\_name}}\&employee\_id={{employee\_id}}\&employee\_phone\_number={{employee\_phone\_number}}\&extension\_phone\_number={{extension\_phone\_number}}
2. **Название уведомления:** completed\
**Тип события:** Завершение звонка\
**Тело:**\
notification\_name={{notification\_name}}\&direction={{direction}}\&virtual\_phone\_number={{virtual\_phone\_number}}\¬ification\_timestamp={{notification\_timestamp}}\&contact\_phone\_number={{contact\_phone\_number}}\&call\_session\_id={{call\_session\_id}}\&employee\_full\_name={{employee\_full\_name}}\&employee\_id={{employee\_id}}\&employee\_phone\_number={{employee\_phone\_number}}\&extension\_phone\_number={{extension\_phone\_number}}\&finish\_reason={{finish\_reason}}\&full\_record\_file\_link={{full\_record\_file\_link}}\&talk\_time\_duration={{talk\_time\_duration}}\&total\_time\_duration={{total\_time\_duration}}\&is\_lost={{is\_lost}}\&lost\_reason={{lost\_reason}}\&clean\_talk\_time\_duration={{clean\_talk\_time\_duration}}
3. **Название уведомления:** outgoing\
**Тип события:** Исходящий звонок\
**Тело:**\
notification\_name={{notification\_name}}\&direction={{direction}}\&virtual\_phone\_number={{virtual\_phone\_number}}\¬ification\_timestamp={{notification\_timestamp}}\&contact\_phone\_number={{contact\_phone\_number}}\&call\_session\_id={{call\_session\_id}}\&employee\_full\_name={{employee\_full\_name}}\&employee\_id={{employee\_id}}\&employee\_phone\_number={{employee\_phone\_number}}\&extension\_phone\_number={{extension\_phone\_number}}
4. **Название уведомления:** talking\
**Тип события:** Начало разговора\
**Тело:**\
notification\_name={{notification\_name}}\&direction={{direction}}\&virtual\_phone\_number={{virtual\_phone\_number}}\¬ification\_timestamp={{notification\_timestamp}}\&contact\_phone\_number={{contact\_phone\_number}}\&call\_session\_id={{call\_session\_id}}\&employee\_full\_name={{employee\_full\_name}}\&employee\_id={{employee\_id}}\&employee\_phone\_number={{employee\_phone\_number}}\&extension\_phone\_number={{extension\_phone\_number}}
**Важно!**\
Произведите сохранение интеграции в первую очередь в **АТС UIS**, далее перейти в **MacroCRM** и произведите сохранение информации в системе. В **MacroCRM** появиться поле для выбора **Внутренний номер для совершения исходящего звонка**. При отсутствии пункта, повторно проверьте интеграцию и сохраните настройки согласно инструкции.
### Сопоставление менеджеров
Для отображения менеджера, ответившего на звонок, для совершения обратных звонков по клику из **MacroCRM**, а также для корректного распределения заявок, создающихся по звонкам, необходимо настроить сопоставление менеджеров в **MacroCRM.**
Для настройки сопоставления на странице интеграции в **MacroCRM** нажмите **Сопоставление менеджеров:**
Для добавления менеджера нажмите **+ Добавить**. \
В появившейся строке слева выберите менеджера в **CRM**, справа пропишите его внутренний номер. \
**Сохраните настройки:**
### Описание функционала
1. **Всплывающие карточки при звонках**
Для того, чтобы при входящих/исходящих звонках в MacroCRM появилась карточка с данными клиента необходимо перевести статус менеджера в On-line.
Для этого нажмите на изображение красной трубки в верхнем правом углу страницы в MacroCRM и выберите On-line. Изображение трубки сменит цвет на зеленый, что означает успешное изменение статуса.
Всплывающие карточки будут появляться во время звонка в нижнем левом углу экрана.
По кнопке из всплывающей карточки можно быстро отметить звонок как **Нецелевой**, либо **Открыть заявку клиента** для редактирования, поставить тематику звонка и оставить комментарий.
Подробнее в [инструкции по звонкам](https://docs.macrodigital.ru/manual/macrocrm/zajavki/zvonki-2.0).
**Важно!** \
Если при попытке сменить статус на On-line менеджер видит ошибку **Пользователь не зарегистрирован в виртуальной АТС**, то это значит для этого менеджера не указан внутренний номер в настройках сопоставления (см. выше раздел **Сопоставление менеджеров**).
2. **Список звонков**
Полный список звонков доступен в пункте меню **Звонки**. Фильтры позволяют сделать выборку по различным параметрам: менеджеру, дате, статусу звонка и т.д.
3. **Совершение обратных звонков из MacroCRM**
По клику на кнопку  около номера клиента в любом месте в MacroCRM, будь то карточка контакта, лента событий, канбан — будет совершена попытка обратного звонка клиенту.
**Важно!**\
В первую очередь **ВАТС дозванивается до менеджера**, и если тот берет трубку — ВАТС звонит клиенту. В случае, если не удалось дозвониться до менеджера, то звонок прекращается:
Интеграция настроена!
