Телефония Asterisk

Модуль предназначен для настройки интеграции с провайдером телефонии Asterisk. С его помощью можно принимать и совершать звонки в интерфейсе ELMA365. Пользователи смогут идентифицировать клиента по номеру телефона, открывать во время звонка карточку связанного с ним приложения, например, сделки или лида, а также прослушивать записи разговоров.

Начало внимание

Модуль доступен только для ELMA365 On‑Premises. Интеграцию можно настроить с телефонией Asterisk версии 12 и выше.

Конец внимание

Шаг 1. Активировать решение «ELMA365 Управление коммуникациями»

Чтобы получить доступ ко всем предусмотренным в ELMA365 возможностям телефонии, перед подключением интеграции активируйте решение ELMA365 Управление коммуникациями отдельно или в составе одного из решений CRM.

Это позволит применять расширенные настройки карточек звонков и карточек сводной информации по звонкам — формам с дополнительными данными о клиенте, которые можно просматривать во время звонка. Кроме того, пользователи смогут использовать раздел Телефония, где предусмотрена отдельная страница для фиксирования звонков и работы с ними.

Подробнее о доступных функциональных возможностях читайте в статье «Телефония».

Шаг 2. Задать настройки на стороне Asterisk

Начало внимание

В статье приведены основные шаги для настройки сервера Asterisk. По всем вопросам, связанным с настройкой провайдера телефонии, обращайтесь в техническую поддержку Asterisk или воспользуйтесь официальной документацией.

Конец внимание

1. На стороне Asterisk включите интерфейсы ARI и AMI. Они требуются для корректной работы модуля.

Включение интерфейса ARI

Включение интерфейса AMI

2. На рабочих местах сотрудников настройте софтфон — специальную программу для совершения звонков, например MicroSip. Её необходимо подключить к вашему серверу Asterisk.

Шаг 3. Подключить модуль Asterisk в ELMA365

1. Перейдите в раздел Администрирование > Модули.
2. Нажмите + Модуль, а затем Скачать. В каталоге ELMA365 Store выберите модуль Asterisk и установите его.
3. Нажмите Перейти в модуль. На открывшейся странице выполните действия:

1. Настройте подключение к серверу Asterisk.
2. Сопоставьте пользователей Asterisk с пользователями ELMA365.
3. Настройте обработку входящего звонка.
4. Используйте инструменты диагностики.

Настроить подключение к серверу Asterisk

Чтобы получать данные из Asterisk, укажите в модуле параметры подключения. Их можно найти в настройках сервера Asterisk в файлах ari.conf и manager.conf.

1. На странице подключения модуля заполните поля:

• Адрес Облачной АТС* — укажите полный URL или API‑адрес сервера, на котором находится Asterisk;
• Пользователь* — введите логин пользователя, указанный в файле ari.conf;
• Порт ARI* — введите порт, заданный в настройках интерфейса ARI. Он указан в файле ari.conf. Обычно используется порт 8088;
• Пароль* — введите пароль пользователя, указанный в файле ari.conf;
• Приложение Облачной АТС* — добавьте произвольное название приложения, например, elma365. Приложение будет использоваться в качестве контекста, который объединит все настройки, каналы и события для работы в рамках одного подключения;
• Тип канала* — укажите протокол, по которому работает канал: SIP, PJSIP, DAHDI или IAX2. Тип канала определяется при настройке Asterisk;
• Пользователь AMI* — введите логин пользователя, указанный в файле manager.conf;
• Пароль AMI* — введите пароль пользователя, указанный в файле manager.conf;
• Порт AMI* — введите порт, указанный в файле manager.conf. Обычно используется порт 5038;
• Контекст исходящих вызовов — укажите название контекста, т. е. набора расширений, которые определяют правила совершения исходящих вызовов. Контекст настраивается на сервере Asterisk;
• Ссылка на запись звонка — введите шаблон прямой ссылки для получения файлов с записью разговора из базы Asterisk. URL‑адрес указан в настройках сервера провайдера IP‑телефонии. Чтобы составить шаблон, под полем Ссылка на запись звонка нажмите Переменные для подстановки и используйте параметры канала, которые создаются при звонке. Шаблон может выглядеть следующим образом: http://record_{Id}_{Name}_{Creationtime}_{Creationtime.DayOfWeek}.wav.

2. После заполнения полей нажмите Установить настройки сервиса, чтобы звонки отображались в интерфейсе ELMA365, и под блоком Диагностика нажмите Сохранить.
3. В блоке Настройки телефонии:

• поля Токен и Webhook URL заполняются автоматически. Это служебные данные, которые используются для корректной работы модуля;
• нажмите Проверить соединение. Если связь между Asterisk и ELMA365 установлена, вы увидите уведомление об этом.
  

4. Нажмите Сохранить.

Сопоставить пользователей

После того как соединение с провайдером установится, укажите сотрудников, которые смогут работать со звонками. Для этого сопоставьте внутренних пользователей телефонии и пользователей ELMA365:

1. В блоке Настройки телефонии нажмите Настроить.
2. В появившемся окне укажите пользователей ELMA365 для каждого внутреннего номера провайдера.
    
   Обратите внимание, пользователи Asterisk или внутренние номера провайдера IP-телефонии загружаются автоматически. Если эти данные не отобразились в окне Настройка пользователей, убедитесь, что пользователи на стороне провайдера созданы.
   
3. Нажмите OK.

Настроить обработку входящего звонка

После подключения провайдера телефонии настройте обработку входящих звонков:

1. Если подключено решение ELMA365 Управление коммуникациями отдельно или в составе одного из решений CRM, настраивать параметры звонка в модуле Asterisk не нужно.
    
   Перейдите в раздел Администрирование > Настройка звонка, где доступны расширенные настройки карточек входящего, исходящего и пропущенного звонков, а также карточек сводной информации по звонкам.
    
   Подробнее читайте в статье «Настроить карточку звонка».
2. Если решение ELMA365 Управление коммуникациями не подключено, на странице модуля Asterisk настройте внешний вид карточки входящего звонка.
    
   Перейдите к блоку Настройки обработки входящего звонка и заполните поля:
   

• Связать с приложением — укажите приложение, в котором будут создаваться и храниться элементы с информацией о клиенте и звонке. Обратите внимание, на форме выбранного приложения должно находиться поле типа Номер телефона;
• Контактный телефон — выберите поле типа Номер телефона из контекста указанного приложения, в которое будет записываться телефон клиента;
• Карточка звонка — нажмите кнопку Настроить, чтобы изменить внешний вид оповещения, всплывающего при звонке. В открывшемся окне вы можете отредактировать шаблон заголовка карточки, а также выбрать поля, которые будут отображаться в ней.

После настройки всех параметров интеграции нажмите Сохранить.

Использовать инструменты диагностики

При возникновении ошибок в работе модуля Asterisk вы можете воспользоваться инструментами для диагностики подключения интеграции.

Для этого откройте страницу настроек модуля и перейдите к блоку Диагностика:

1. Получатели уведомлений — укажите пользователей, которые получат уведомления при возникновении ошибок в работе модуля Asterisk.
2. Просмотреть логи — нажмите кнопку, чтобы открыть окно со списком последних 200 записей о состоянии работы модуля.
3. Проверить настройки сервиса — нажмите кнопку, чтобы проверить, что настройки на стороне ELMA365 применены к сервису Asterisk. При обнаружении ошибок выводится уведомление в окне под кнопкой.
4. Проверить статус подключения к Asterisk — нажмите кнопку, чтобы проверить установку связи с провайдером IP‑телефонии. Результат проверки выводится в окне под кнопкой.
    
   Если отображается ошибка соединения, проверьте:

• корректность указанных значений для интерфейса ARI в общих настройках модуля;
• доступность сервера Asterisk по ссылке, указанной в поле Адрес Облачной АТС*.

Возможные ошибки и решения

В таблице ниже приведены ошибки, которые могут возникнуть при настройке и работе модуля.

Была ли статья полезной?

Спасибо за ваш отзыв!

×

Ваш отзыв успешно отправлен!

Спасибо за обратную связь.

×

Уточните, почему:

Рекомендации не помоглиТекст трудно понятьНет ответа на мой вопросСодержание статьи не соответствует заголовкуДругая причина

×

Расскажите, что вам не понравилось в статье:

ДаНет

Выберите вариантРекомендации не помоглиТекст трудно понятьНет ответа на мой вопросСодержание статьи не соответствует заголовкуДругая причина