# Интеграция с ВАТС Ростелеком

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

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

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

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

1\. В личном кабинете виртуальной АТС необходимо подключить услугу ***Интеграционный API*** (если еще не подключена). После подключения зайдите в настройки интеграции по ссылке с рабочего стола, дальнейшие действия будут производиться на этой странице:

![](https://help.macrodigital.ru/upload/pages/manual/macrocatalog/integracii/1__5_.png)

2\. В новой вкладке браузера откройте **MacroCRM**, зайдите в раздел **Интеграции** **->** **Телефония** **-> Ростелеком**:

![](https://help.macrodigital.ru/upload/pages/manual/macrocatalog/integracii/4__5_.png)

**3. Настройка параметров**

* Скопируйте в настройках интеграции виртуальной АТС ***Уникальный код идентификации*** и ***Уникальный ключ для подписи**,* и вставьте в одноименные поля в **MacroCRM**. Сохраните настройки интеграции в **MacroCRM.**
* Скопируйте ***URL-адрес CRM*** из **MacroCRM** и вставьте в поле ***Адрес внешней системы*** в настройках интеграции виртуальной АТС.
* В настройках интеграции виртуальной АТС переведите переключатель ***Статус услуги*** в положение ***Вкл*** и сохраните изменения. На той же странице в блоке ***Методы API*** переведите переключатели в положение ***Вкл*** на всех запросах от API Виртуальной АТС во внешнюю систему.

![](https://help.macrodigital.ru/upload/pages/manual/macrocatalog/integracii/2__4_.png)

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

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

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

![](https://help.macrodigital.ru/upload/pages/manual/macrocatalog/integracii/5__5_.png)

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

Список используемых внутренних номеров можно посмотреть в личном кабинете виртуальной АТС в разделе ***Пользователи***:

![](https://help.macrodigital.ru/upload/pages/manual/macrocatalog/integracii/7__3_.png)

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

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

1. В личном кабинете виртуальной АТС необходимо перейти в **Управление услугами → Интеграционный API:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2F8hPDtpT9Y86R7x5XxFnZ%2Frostelecom_1.png?alt=media&#x26;token=fcca0a3e-8155-4ff7-a1a2-00d71cd7077d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FLgPEdXfYxqlvVipV0cyl%2Frostelecom_2.png?alt=media&#x26;token=35491b1e-df20-42f1-8968-b04c0b3208e2" alt=""><figcaption></figcaption></figure>

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

* Скопируйте **URL-адрес** **CRM** в **MacroCRM** → вставьте в поле **Адрес внешней системы** в настройках интеграции ВАТС:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FfRyeoBnEU0ADYAsjvT8y%2Frostelecom_3.png?alt=media&#x26;token=52121bd3-1500-42d0-b92b-b48cbb0b347d" alt=""><figcaption></figcaption></figure>

* Скопируйте в настройках интеграции ВАТС **Уникальный код идентификации** и **Уникальный ключ для подписи** → вставьте в одноименные поля в **MacroCRM**.&#x20;
* Сохраните настройки интеграции в MacroCRM:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FxU44UztokqpxY6onU7KD%2Frostelecom_4.png?alt=media&#x26;token=982c72ea-aad2-4aed-badd-7fe147a3076a" alt=""><figcaption></figcaption></figure>

* В настройках интеграции ВАТС переведите переключатель **Статус услуги** в положение **Вкл** и сохраните изменения. На той же странице в блоке **Методы API** переведите переключатели в положение **Вкл** на всех запросах от API ВАТС во внешнюю систему:

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FkkvRlOWjYks77rllJHld%2Frostelecom_6.png?alt=media&#x26;token=026ec690-9a23-4325-8999-07b03b1bae48" 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%2FmVJlpxWxaKoGzJk2NbeF%2Frostelecom_7.png?alt=media&#x26;token=f1d96e85-bf59-444c-ad22-06d88795d3e9" 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%2FHaTZfXS3TpCUerK5N9mc%2Frostelecom_8.png?alt=media&#x26;token=6c4b7070-3c84-4288-a566-34a3e55b1fc5" 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;
