﻿# Телефония Zadarma

> [HTML Version](telephony-zadarma.html)

Модуль для подключения к провайдеру IP-телефонии Zadarma. Позволяет идентифицировать клиента по номеру, открывать во время звонка карточку связанного с ним приложения, например, сделки или лида, и прослушивать записи разговоров непосредственно в карточке.

````
начало внимание

````
Перед началом настройки убедитесь, что ваш аккаунт в Zadarma активен.

````
конец внимание

````
**Важно**: использовать модуль телефонии для работы с продажами можно, если активировано решение **ELMA365 Sales**. Иначе функциональные возможности **CRM** недоступны. 

## Подключить модуль

1. Перейдите в раздел **Администрирование** > **Модули** > **Zadarma** и поставьте флажок напротив опции **Включить модуль**.

2. Скопируйте вебхук из поля **Webhook URL**.

3. Войдите в аккаунт Zadarma. Перейдите в раздел **Настройки** > **Интеграции и API**.

4. На открывшейся странице на вкладке **Интеграции** в блоке **Сервисы Новофон** выберите **Notifications**. 

5. В открывшейся справа панели в блоке **Шаг 2. Укажите ссылки** в поле **О звонках в АТС** введите скопированный на шаге 2 вебхук. После этого под полем появится список событий. Отметьте события, о которых в ELMA365 будут приходить уведомления. 

Затем вставьте тот же вебхук в поле **О событиях** и аналогично отметьте события. 

**[![17.png](360010714039-17.png)]**

6. Закройте панель и перейдите на вкладку **Ключи и API**. Нажмите кнопку **Создать ключи**. 

**[![15.png](360010703080-15.png)]**

7. Скопируйте ключ авторизации — **Key** и секретный ключ — **Secret**.

**[![16.png](360010703100-16.png)]**

8. Вернитесь в ELMA365, откройте раздел **Администрирование** > **Модули **> **Zadarma**. В поле **API ключ\*** вставьте **Key**, в поле **API секрет\*** — **Secret**.

**(zadarma_1.png)**

9. Нажмите кнопку **Проверить соединение**. Если связь между системами установлена, вы увидите соответствующее уведомление.

10. Сохраните настройки.

## Сопоставить пользователей

После того как соединение с провайдером будет установлено, необходимо сопоставить внутренних пользователей телефонии и пользователей ELMA365. 

1. В настройках модуля нажмите кнопку **Настроить**.

2. Во всплывающем окне укажите пользователей ELMA365 для каждого внутреннего номера провайдера.

**(zadarma-5.png)**

3. Нажмите **OK**.

Обратите внимание, пользователи/внутренние номера провайдера IP телефонии загружаются автоматически. Если эти данные не отобразились, убедитесь, что вы создали пользователей на стороне провайдера. Подробнее читайте в [документации телефонии Zadarma](https://zadarma.com/ru/support/faq/pbx/how-to-create-and-set-internal-numbers/). 

## Настроить обработку входящего звонка

После подключения телефонии настройте обработку входящих звонков:

- в разделе **Администрирование** **>** **Настройка звонка **вы можете задать расширенные настройки карточек входящего, исходящего и пропущенного звонков, а также карточки сводной информации по звонку. Подробнее читайте в статье [«Настроить карточку звонка»](/ru/help/crm/call-card.html); 

- если вы не используете расширенные настройки телефонии, на странице модуля в блоке **Настройки обработки входящего звонка** заполните следующие поля: 

	- **Связать с приложением** — укажите приложение, в котором будут создаваться и храниться элементы с информацией о клиенте и звонке. Обратите внимание, на форме выбранного приложения должно находиться поле типа [Номер телефона](360009707032.md#phone-number);  

	- **Контактный телефон** — выберите поле типа **Номер телефона** из контекста указанного приложения, в которое будет записываться телефон клиента;

	- **Отключить создание элемента** — выберите **Да**, чтобы отключить автоматическое создание контакта после завершения звонка. Тогда в приложении с вашей базой контактов, указанном в поле **Связать с приложением**, не будут добавляться лишние записи;

	- **Карточка звонка** — нажмите кнопку **Настроить**, чтобы изменить внешний вид оповещения, всплывающего при звонке. В открывшемся окне вы можете отредактировать [шаблон заголовка](360007679591.md) карточки, а также выбрать поля, которые будут отображаться в ней. 

**(telephony-gravitel_3.png)**

После настройки всех параметров интеграции нажмите кнопку **Сохранить**. 