# Телефония RunTel > [HTML Version](runtel.html) Модуль предназначен для настройки интеграции с провайдером телефонии RunTel. После подключения пользователи могут: - принимать, а также совершать исходящие и внутренние звонки в интерфейсе ELMA365; - во время звонка просматривать данные о клиенте, открывать связанные с ним лиды и сделки; - прослушивать записи разговоров. ## Этапы настройки интеграции Чтобы настроить интеграцию с RunTel, [администратор системы](360006871932.md#administrators) выполняет следующие шаги: 1. [Выполнить предварительную настройку в ELMA365](#preconfiguration). 2. [Задать настройки на стороне RunTel](#settings-runtel). 3. [Настроить модуль RunTel в ELMA365](#connect-module). Подробнее о настройке каждого этапа читайте ниже. ## Шаг 1. Выполнить предварительную настройку в ELMA365 На этом шаге выполняется подготовка ELMA365 к работе с телефонией RunTel: - [активация лицензии](#license) для использования расширенных возможностей телефонии в ELMA365; - [установка модуля RunTel в ELMA365](#download-module); - [получение токенов](#tokens) для настройки интеграции на стороне RunTel; - [выбор способа работы сотрудников с исходящими звонками](#calls-method) — через сторонний софтфон или CTI‑панель в интерфейсе ELMA365. ### Активировать лицензию «ELMA365 Sales+Omni» Перед подключением интеграции активируйте лицензию **ELMA365 Sales+Omni**. Это позволяет работать со звонками, анализировать данные по вызовам в интерфейсе ELMA365, а также использовать функции управления продажами. Подробнее о функциональных возможностях, доступных после активации лицензии, читайте в статье [«Телефония»](360013063359.md). ### Установить модуль RunTel в ELMA365 Чтобы установить модуль: 1. Перейдите в раздел **Администрирование > Модули**. 2. Нажмите **+ Модуль**, а затем **Скачать**. В каталоге [ELMA365 Store](https://store.elma365.ru/component/runtel-992) выберите модуль **RunTel** и установите его. 3. Включите модуль, чтобы в дальнейшем можно было перейти в его настройки. ### Получить токены Для настройки интеграции на стороне RunTel потребуются два токена из ELMA365. Первый токен создаётся вручную для синхронизации пользователей, второй доступен в настройках модуля RunTel и используется для корректной работы интеграции. 1. **Токен для синхронизации пользователей**. Чтобы создать токен и получить его значение, выполните следующие действия: 1. Перейдите в раздел [Администрирование > Токены](360016488452.md). 2. В правом верхнем углу нажмите **+ Токен** и в открывшемся окне заполните данные. 3. Скопируйте значение токена. Обратите внимание, токен доступен для копирования только при создании. В дальнейшем получить значение токена невозможно. 2. **Токен для корректной работы интеграции**. Для получения этого токена откройте настройки установленного модуля **RunTel**. Затем в блоке **Настройки телефонии** скопируйте значение из поля **Токен**. Сохраните полученные токены. Они указываются в параметрах подключения на стороне провайдера RunTel на [шаге 2](#settings-runtel). ### Определить способ работы с исходящими звонками Выберите, каким способом сотрудники будут работать с исходящими звонками: - сторонний софтфон — специальная программа для совершения звонков, например MicroSip, которая настраивается на рабочих местах сотрудников. Её необходимо подключить к вашему серверу RunTel; - [CTI‑панель](cti-panel-calls.md) — инструмент для совершения исходящих и внутренних звонков в интерфейсе ELMA365. В этом случае устанавливать дополнительный софтфон не требуется. Если вы выбрали этот вариант, настройка CTI‑панели выполняется на [шаге 3](#users-match). ## Шаг 2. Задать настройки на стороне RunTel ```` Начало примера ```` **Примечание** По вопросам, связанным с настройкой на стороне RunTel, обращайтесь в техническую поддержку RunTel или воспользуйтесь [официальной документацией](https://doc-cp.runtel.ru). ```` Конец примера 1. ```` Перейдите в личный кабинет RunTel, в левом меню выберите раздел **Маркетплейсы** и на открывшейся странице нажмите **ELMA365**. После этого появится окно с настройками интеграции. 2. В блоке **Шаг 1. Авторизация** заполните следующие поля: - **Домен** — укажите домен, на котором зарегистрирована ваша компания в ELMA365; - **Токен для синхронизации пользователей** — вставьте токен, полученный в ELMA365 в разделе **Администрирование > Токены** на [шаге 1](#token-user-synchronization); - **Токен** — вставьте значение, [скопированное в настройках модуля RunTel в ELMA365](#token) из поля **Токен**; - **Токен модуля** — укажите идентификатор модуля RunTel в ELMA365: **7b313c6d-b642-479c-b607-a0e55604fa8f**. 3. В блоке **Шаг 2. Настройка параметров** в поле **Разрешить обработку номера** выберите опцию **Исходящие, Входящие, Внутренние**. 4. В блоке **Шаг 3. Сохранение ключей в CRM** скопируйте значения в полях **Ссылка на API АТС** и **API‑ключ**. Эти данные потребуются для настройки подключения модуля RunTel в ELMA365. ## Шаг 3. Подключить модуль RunTel в ELMA365 В разделе **Администрирование > Модули** откройте ранее установленный модуль RunTel. На открывшейся странице: - [настройте подключение к серверу RunTel](#connection-to-server); - [сопоставьте пользователей RunTel с пользователями ELMA365 и включите CTI‑панель](#users-match); - [настройте обработку входящего звонка](#configure-incoming-call); - [включите инструменты диагностики](#diagnostics). ### Настроить подключение к серверу RunTel Чтобы получать данные из RunTel, укажите в модуле параметры подключения. Для этого: 1. Откройте страницу подключения модуля, на вкладке **Основное** заполните поля и сохраните внесённые данные: **(runtel-1.png)** - **Ссылка на API АТС\*** — вставьте ссылку, скопированную из соответствующего поля при [настройке интеграции в RunTel](#value-runtel); - **API‑ключ\*** — вставьте значение, скопированное из соответствующего поля при настройке интеграции на стороне провайдера. 2. Перейдите ниже к блоку **Настройки телефонии** и нажмите кнопку **Проверить соединение**. Если связь между RunTel и ELMA365 установлена, вы увидите уведомление об этом. ### Сопоставить пользователей и включить CTI‑панель После того как соединение с провайдером установится, укажите сотрудников, которые смогут работать со звонками. Для этого сопоставьте внутренних пользователей телефонии и пользователей ELMA365: 1. В блоке **Настройки телефонии** нажмите **Настроить**. 2. В открывшемся окне отобразятся внутренние номера провайдера IP‑телефонии, которые загружаются автоматически. Справа от внутреннего номера нажмите значок шестерёнки и заполните поля в появившемся окне: **(runtel-2.png)** - **Пользователь ELMA365\*** — из списка выберите сотрудника, который будет работать со звонками; - **Подключить CTI-панель\*** — если вы выбрали CTI‑панель как способ работы сотрудников с телефонией, отметьте **Да**. 3. Сохраните настройки. После сохранения настроек внутренний номер RunTel будет сопоставлен с выбранным пользователем ELMA365. Если для пользователя настроена [CTI‑панель](cti-panel-calls.md), он сможет включить её в своём профиле для совершения звонков в интерфейсе ELMA365. Чтобы в консоли разработчика отслеживать состояние подключения CTI‑панели, в настройках модуля откройте вкладку **CTI‑панель** и в поле **Режим отладки\*** выберите **Да**. ### Настроить обработку входящего звонка После подключения провайдера телефонии настройте обработку входящих звонков вы можете: 1. Задать общие настройки. Для этого перейдите в раздел **Администрирование > Настройка звонка**. Здесь можно задать расширенные настройки карточек входящего, исходящего и пропущенного звонков, а также карточек сводной информации по звонкам. Эти настройки можно применить для всех подключённых модулей телефонии. Подробнее читайте в статье [«Настроить карточку звонка»](call-card.md). 2. Задать индивидуальные параметры обработки звонков в модуле RunTel. Для этого откройте страницу управления модулем. На вкладке **Основное** внизу страницы перейдите к блоку **Настройки обработки входящего звонка** и заполните поля: **(runtel-3.png)** - **Связать с приложением\*** — укажите приложение, в котором будут создаваться и храниться элементы с информацией о клиенте и звонке. Обратите внимание, на форме выбранного приложения должно находиться поле типа [Номер телефона](360009707032.md#phone-number); - **Контактный телефон\*** — выберите поле типа **Номер телефона** из контекста указанного приложения, в которое запишется телефон клиента. По умолчанию по этому полю происходит поиск элемента, связанного со звонком. Если входящий номер совпал со значением в поле, откроется нужная карточка; - **Отключить создание элемента** — выберите **Да**, чтобы отключить автоматическое создание контакта после завершения звонка. Тогда в приложении с вашей базой контактов, указанном в поле **Связать с приложением\***, не будут добавляться лишние записи; - **Карточка звонка** — нажмите кнопку **Настроить**, чтобы изменить внешний вид оповещения, всплывающего при звонке. В открывшемся окне вы можете отредактировать [шаблон заголовка](360007679591.md#name_template) карточки, а также выбрать поля, которые будут отображаться в ней. **(runtel-4.png)** ### Включить инструменты диагностики Вы можете настроить сбор данных о работе модуля RunTel для последующей диагностики. В случае возникновения ошибок полученная информация поможет вам проанализировать их причины. Для этого: 1. Откройте страницу настроек модуля и перейдите на вкладку **Диагностика**. 2. В поле **Вебхук для отладки** укажите ссылку, на которую будут отправляться данные о работе модуля RunTel. Ссылку можно получить на [сайте сервиса Webhook.site](https://webhook.site/#!/view/a2d88c44-9f7c-4457-ae4b-6f26954d4b07). Там же вы сможете ознакомиться с отладочной информацией, если возникнут ошибки в работе модуля.