# Интеграция с ВАТС Sipuni

**Возможности интеграции:**

* **Исходящие звонки** по клику на номер клиента в CRM — АТС перезванивает сначала оператору, затем звонит вызываемому абоненту.
* **Всплывающая карточка** при входящем/исходящем звонке.
* **Прослушивание записей звонков** прямо в CRM.
* **Переадресация на «знакомого» менеджера** — при входящем звонке производится поиск номера телефона клиента в базе и, если номер найден, звонок переадресуется на менеджера, ответственного за заявку этого клиента.

## Старый личный кабинет

### Подключение и настройка интеграции

1\. В личном кабинете виртуальной АТС необходимо перейти в раздел **Настройки → API → Ключ интеграции...Сгенерировать** 

<mark style="color:orange;">**Важно!**</mark> Обратите внимание, данные услуги должны быть подключены: Статистика, Звонок на номер, События на АТС.

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FJ10zEVF1Vh8lNCvtbXJw%2Fst_Sipuni_1.png?alt=media&#x26;token=dc63e3d7-23a8-4cc2-b4df-5ce4a47560ba" alt=""><figcaption></figcaption></figure>

2. В новой вкладке браузера откройте **MacroCRM**, зайдите в раздел \
   **Интеграции → Телефония → АТС Sipuni:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2Fbi1tr6WMvhXoAo1VhpaQ%2Fst_Sipuni_2.png?alt=media&#x26;token=dd547f42-8f46-4c97-97cc-071106a91a7e" alt=""><figcaption></figcaption></figure>

### Настройка параметров

1. Скопируйте в настройках интеграции виртуальной АТС Сгенерированный **Ключ интеграции, Номер в системе (user) →** вставьте в одноименные поля в **MacroCRM**.

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FLFK3D5G4kcnlwIyYSJCO%2Fst_Sipuni_3.png?alt=media&#x26;token=d57c9edc-71e8-4998-9a61-a840e7e5d93a" alt=""><figcaption></figcaption></figure>

2. Скопируйте **URL принимающего скрипта** из **MacroCRM** → вставьте в поле **События на АТС** в настройках интеграции, сохраните настройки в виртуальной АТС:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2F4djrL8EecUUnjteZqnIG%2Fst_Sipuni_4.png?alt=media&#x26;token=f24aefee-37a8-41a0-b870-42a0cc7a2ecf" alt=""><figcaption></figcaption></figure>

### Сопоставление менеджеров

Для отображения менеджера, ответившего на звонок, для совершения обратных звонков по клику из **MacroCRM**, а также для корректного распределения заявок, создающихся по звонкам,&#x20;

необходимо настроить сопоставление менеджеров в **MacroCRM**.

Для настройки сопоставления на странице интеграции в **MacroCRM** нажмите **Сопоставление менеджеров:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FFOBIWBCPVnVOMwGHb4G9%2Fst_Sipuni_5.png?alt=media&#x26;token=958b322e-e17e-41ca-8e65-83504b43b08a" alt=""><figcaption></figcaption></figure>

Для добавления менеджера нажмите **+ Добавить.** В появившейся строке слева выберите менеджера в CRM, справа пропишите его внутренний номер. **Сохраните настройки.**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FQI2nDsSXEbaZHjNF9pUe%2Fst_Sipuni_6.png?alt=media&#x26;token=b55ac5a5-6e31-43df-a361-1785ced8c084" alt=""><figcaption></figcaption></figure>

## Новый личный кабинет

### Подключение и настройка интеграции

1\. В личном кабинете виртуальной АТС необходимо перейти в раздел **Интеграции → Интеграция по API → Ключ интеграции...Сгенерировать**&#x20;

<mark style="color:orange;">**Важно!**</mark> Обратите внимание, данные услуги должны быть подключены: Статистика, Звонок на номер, События на АТС.

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FDfgWm75jXF6RSlhidcJQ%2Fnv_Sipuni_1.png?alt=media&#x26;token=272b648a-7e11-4836-9954-28a36b3118ce" alt=""><figcaption></figcaption></figure>

2. В новой вкладке браузера откройте **MacroCRM**, зайдите в раздел **Интеграции → Телефония → АТС Sipuni:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FF6nbAAlybOAY828SWvaj%2Fnv_Sipuni_2.png?alt=media&#x26;token=1d23abfb-0d7a-4b5a-a96f-89c82ad8e641" alt=""><figcaption></figcaption></figure>

### Настройка параметров

1. Скопируйте в настройках интеграции виртуальной АТС Сгенерированный **Ключ интеграции, Номер в системе (user)** → вставьте в одноименные поля в **MacroCRM:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FB2A11amJgUaeAGy8AnZp%2Fnv_Sipuni_3.png?alt=media&#x26;token=3b7ca2ae-3fdf-45cd-9bb6-0c8d57565013" alt=""><figcaption></figcaption></figure>

2. Скопируйте **URL принимающего скрипта** из **MacroCRM** → вставьте в поле **События на АТС** в настройках интеграции, сохраните настройки в виртуальной АТС.

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FAmrgCZQgeSAXOOrTsWSE%2Fnv_Sipuni_4.png?alt=media&#x26;token=d98494fd-dcf6-4af8-b797-d390c92db011" alt=""><figcaption></figcaption></figure>

### Сопоставление менеджеров

Для отображения менеджера, ответившего на звонок, для совершения обратных звонков по клику из **MacroCRM**, а также для корректного распределения заявок, создающихся по звонкам,&#x20;

необходимо настроить сопоставление менеджеров в **MacroCRM**.

Для настройки сопоставления на странице интеграции в **MacroCRM** нажмите **Сопоставление менеджеров:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FbPTMZbRm3Za7uJfnhOxj%2Fnv_Sipuni_5.png?alt=media&#x26;token=d2d9263f-8bdf-4107-84f0-a1f45c6f7544" alt=""><figcaption></figcaption></figure>

Для добавления менеджера нажмите **+ Добавить**. В появившейся строке слева выберите менеджера в **CRM**, справа пропишите его внутренний номер. **Сохраните настройки.**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FUcL9Vz4xwrMgnCAr3ExZ%2Fst_Sipuni_6.png?alt=media&#x26;token=db1633c2-164e-4172-a42e-cbda6dab7d91" alt=""><figcaption></figcaption></figure>

### Описание функционала

1. **Всплывающие карточки при звонках**

Для того, чтобы при входящих/исходящих звонках в MacroCRM появилась карточка с данными клиента необходимо перевести статус менеджера в On-line.&#x20;

Для этого нажмите на изображение красной трубки в верхнем правом углу страницы в MacroCRM и выберите On-line. Изображение трубки сменит цвет на зеленый, что означает успешное изменение статуса.&#x20;

Всплывающие карточки будут появляться во время звонка в нижнем левом углу экрана.&#x20;

По кнопке из всплывающей карточки можно быстро отметить звонок как **Нецелевой**, либо **Открыть заявку клиента** для редактирования, поставить тематику звонка и оставить комментарий.&#x20;

Подробнее в [инструкции по звонкам](https://docs.macrodigital.ru/manual/macrocrm/zajavki/zvonki-2.0).&#x20;

<mark style="color:orange;">**Важно!**</mark>\
Если при попытке сменить статус на On-line менеджер видит ошибку **Пользователь не зарегистрирован в виртуальной АТС**, то это значит для этого менеджера не указан внутренний номер в настройках сопоставления (см. выше раздел **Сопоставление менеджеров**).

2. **Список звонков**

Полный список звонков доступен в пункте меню **Звонки**. Фильтры позволяют сделать выборку по различным параметрам: менеджеру, дате, статусу звонка и т.д.

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FJPncHfLYmpxRasa9B8hd%2FDom_11.png?alt=media&#x26;token=406cee35-c768-47f1-a33e-c4a3ecff259d" alt=""><figcaption></figcaption></figure>

3. **Совершение обратных звонков из MacroCRM**

По клику на кнопку ![mceclip0.png](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfOTFYLFeIRUVZhXUK84YA7QIvndw-w_x0gtrraT4LoZJCsRv5kqIVxlSJUMqG_jgWP30G4YDCvWuAz-5VfGyN-qeYTurxnz2DquTzaEJ1B2oVv11Z31sWxF8jWA57_wlqLlkSnJ8znorckBLKqDX9OykI?key=nSRB5I_8ew7VAvrv2emoDQ) около номера клиента в любом месте в MacroCRM, будь то карточка контакта, лента событий, канбан — будет совершена попытка обратного звонка клиенту.&#x20;

<mark style="color:orange;">**Важно!**</mark>\
В первую очередь **ВАТС дозванивается до менеджера**, и если тот берет трубку — ВАТС звонит клиенту. В случае, если не удалось дозвониться до менеджера, то звонок прекращается:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FwgMkcKq6OKdU0txd2Px0%2FDom_12.png?alt=media&#x26;token=a949debe-beb7-4714-97b7-a7ec98ad1450" alt=""><figcaption></figcaption></figure>

Интеграция настроена!&#x20;