Налаштування інтеграції 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 (якщо вказано інше, СRМ не зможе підключатися до сервера для отримання інформації).
• Необхідний файл 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, настійно рекомендуємо звернутися за консультацією до фахівців.