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

Настройки аналогичны для FreePBX 15/16.

Перейдите по пути: Настройки - Конфигурация - Телефония - Asterisk.

Предварительная настройка сервера FreePBX

• Для получения информации о звонках на сервере FreePBX должен быть создан файл /etc/asterisk/cdr_manager.conf.
• В файле /etc/asterisk/cdr_manager.conf должен присутствовать раздел [general].
• Для параметра enabled должно быть указано значение yes.
• После изменения файла необходимо перезапустить FreePBX.
• На сервере необходимо настроить выполнение задачи по расписанию один раз в минуту. Без этой задачи обмен данными с системой выполняться не будет.
• Команда для выполнения задачи по расписанию: /opt/alt/php73/usr/bin/php /home/uaperfectum/docs.perfectum.ua/index.php gateways asterisk index.

Доступ к серверу FreePBX

• Хост - адрес сервера FreePBX, к которому будет подключаться система.
• Порт - порт для подключения к серверу FreePBX.
• Имя пользователя интерфейса управления Asterisk - имя пользователя, используемое для авторизации в интерфейсе управления Asterisk.
• Пароль - пароль пользователя интерфейса управления Asterisk.

Звонки

• Протокол - выбор протокола, который используется телефонией для обработки звонков.

Записи звонков

• Имя пользователя Линукс - имя пользователя сервера, от имени которого система получает доступ к файлам записей звонков.
• Пароль - пароль пользователя сервера.
• Порт - порт для подключения к серверу и получения файлов записей звонков.
• Папка с файлами - путь к папке на сервере, в которой сохраняются записи звонков.
• Расширение файлов - расширение файлов записей звонков, которые должна обрабатывать система.

Автоматическое создание лидов

• Создавать лиды из потерянных звонков - включает автоматическое создание лидов по пропущенным звонкам.
• Автоматическое создание лида при ответе на входящий звонок - включает создание лида после принятия входящего звонка.
• Источник лида по умолчанию при автоматическом создании для пропущенного звонка - выбор источника, который будет назначаться лидам, созданным по пропущенным звонкам.
• Источник лида по умолчанию при автоматическом создании для принятого звонка - выбор источника, который будет назначаться лидам, созданным по принятым входящим звонкам.

Настройки лидов и уведомлений

• Статус для автоматического открытия лида при исходящем звонке через программу - выбор статуса лида, при котором его карточка будет автоматически открываться во время исходящего звонка.
• Время, через которое будут отправлены уведомления группе сотрудников, если найден ответственный - указывается задержка перед отправкой уведомления дополнительным сотрудникам.
• Сотрудники, которым отправлять уведомления при звонках, кроме ответственных - выбор сотрудников, которые дополнительно будут получать уведомления о звонках.
• Отправлять уведомления о потерянных звонках с неизвестных номеров - выбор сотрудников, которым будут отправляться уведомления о пропущенных звонках с номеров, не найденных в системе.
• Отправлять уведомления о потерянных звонках ответственному за лид - включает отправку уведомлений сотруднику, назначенному ответственным за лид.
• Отправлять уведомления о потерянных звонках администраторам клиента - включает отправку уведомлений администраторам карточки клиента.
• Стандартный промежуток дней для истории и статистики - количество дней, за которое по умолчанию отображаются история и статистика звонков.

Автоматическое распределение лидов

• Автоматическое распределение лидов - выбор способа распределения автоматически созданных лидов между сотрудниками.
• Равномерное распределение - новые лиды последовательно распределяются между выбранными сотрудниками.
• Активное распределение - новые лиды распределяются с учетом активности и текущей нагрузки сотрудников.
• Список сотрудников для автоматического распределения лидов - выбор сотрудников, между которыми будут распределяться автоматически созданные лиды.

Параметры диагностики

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

• Записывать в журнал операций ответ сервера при неудачном соединении - включает сохранение ответа сервера в журнале операций, если системе не удалось установить соединение.
• IP-адрес сервера при наличии ошибки ASTERISK IP CHECK FAILED в журнале операций - поле для указания адреса сервера, который используется при проверке подключения и диагностике ошибки.

Получение данных контакта для внутренней логики Asterisk

• Логин - имя пользователя, используемое для получения данных контакта внутренними процессами Asterisk.
• Пароль - пароль пользователя, используемого для получения данных контакта.

Получение данных

Как узнать/получить:

1. Имя пользователя Asterisk Manager Interface
2. Пароль

Если есть веб интерфейс - в шапке вкладка settings->advanced settings и ищем в открывшемся окне.

Через файловую систему/консоль - идём по пути /etc/asterisk/manager.conf и забираем данные (admin это логин, secret это пароль). Так же можно создать другого юзера, по аналогии с админом

Настройки для получения записей звонков с сервера.

• В СРМ - указывать логин и пароль для подключения по протоколу sftp к серверу, на котором стоит телефония.
• В Asterisk - при создании вн. номеров (Application->extensions), использовать только

• После заполнения основных данных во вкладке Generals (пароль генерируется автоматически). Достаточно заполнить данные что указаны на скриншоте ниже.

• Нужно перейти во вкладку Advanced, найти Recording options и установить Yes как указано на скриншоте.

Уточните у Вашего администратора хостинга, могут ли они открыть/открыты ли исходящие tcp запросы по адресу, что Вы вбивали в настройках выше. В случае с примером будет "tcp://111.11.1.111:5038"

В случае, если соединение с сервером будет блокироваться на стороне FreePBX, необходимо добавить ip адрес Вашей СРМ в белый лист fail2ban и так же добавить его в файле manager.conf (о котором речь шла выше).

• В manager необходимо добавить строку для пользователя (в примере admin), аналогичную permit на скриншоте (только со своим ip). В строке binaddr установите 0.0.0.0 (если указано иное, CRM не сможет подключаться к серверу для получения информации).
• Необходимый файл fail2ban находится по пути "/etc/fail2ban/jail.local". Необходимо в ignoredip также добавить ip своей СРМ, откуда будут идти запросы (скриншот ниже). Так же, если будут проблемы с соединением после подключения софтфона (бесконечное соединение), то так же добавьте в этот файл тот ip, с которого человек подключается.

Так же не забудьте про файл "cdr_manager.conf" (скриншот ниже). Если файла нет, создайте вручную и запишите в него то, что указано и залейте по этому пути.

После всех манипуляций необходимо перезапустить сервер FreePBX

Опция для помощи в отладке приложения (понять что именно не работает).

Отображает возможные ошибки при подключении к серверу в "Журнале операций", в СРМ. Включать когда не работает и не на долго, иначе весь журнал будет в ошибках астериска. Наиболее частые ошибки описаны в подсказке.

Настройка Freepbx для получения данных про контакты:

На вкладке "Администратор" выберите "Источники поиска Caller ID"

Далее нажмите "Add CIDLookup Source", чтобы создать новый источник данных.

Далее укажите любое удобное имя в "Source Description" и выберите:

• Source type – HTTPS.
• Cache Results – No.
• Host - домен вашей СРМ.
• port - 443.
• username, password – оставить пустыми.
• Path - /asterisk/test_name/.
• Query - number=[NUMBER].

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

Редактировать существующий маршрут:

Во вкладке "Другое" задать параметр "CID Lookup Source" и выбрать источник данных, который создавали в прошлых пунктах.

Применить изменения после завершения всех настроек.

ВАЖНО!!!

Необходимо добавить внутренние номера в профилях Сотрудников в СРМ. Точно так, как они записаны у Вас в Asterisk.

Интеграция не работает с очередями Queues, а работает с группами Ring Groups.

Команду CRON для работы модуля Asterisk необходимо настроить для запуска каждую минуту.

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