Підключіть Asterisk до Xcellerate OPS: визначення абонента, дзвінок у клік і журнал

Підключіть свій Asterisk до Xcellerate OPS: вхідні дзвінки показують відповідний контакт, кожен дзвінок потрапляє в CRM-хронологію клієнта, а команда телефонує клієнтам просто з OPS. Посібник для адміністраторів MSP і сервісних компаній із самостійно керованим Asterisk (версія 16 або новіша).

TL;DR

• OPS підключається до Asterisk через AJAM по HTTPS, з manager-користувачем, який приймає лише адресу OPS.
• Спливаюче вікно для вхідних дзвінків, дзвінок у клік (спочатку дзвонить ваш телефон) і журнал у CRM-хронології.
• За бажання: записи із захищеної HTTPS-теки та нічне звіряння з базою CDR.

Перш ніж почати

• Ви адміністратор OPS або ваша роль дозволяє керувати телефонією.
• Адміністратор Asterisk, який може редагувати http.conf, manager.conf і dialplan. Asterisk 16+; фрагмент dialplan перевірено на 18 і 20.
• OPS має досягати Asterisk по HTTPS. Станцію, до якої OPS не дістається, поки що не можна підключити.
• Адреса OPS для файрвола, показана на сторінці телефонії як "Our address, for your firewall" (Наша адреса для вашого файрвола).

Телефонія — базова функція в кожному тарифі.

Крок 1: підготуйте Asterisk

AJAM по HTTPS

У http.conf:

enabled = yes
tlsenable = yes
tlsbindaddr = 0.0.0.0:8089

Manager-користувач для OPS

У manager.conf створіть користувача з довгим секретом, обмеженого адресою OPS:

deny = 0.0.0.0/0.0.0.0
permit = <адреса OPS>/255.255.255.255
read = call,cdr,reporting,user
write = originate

Дозвольте адресу OPS до цього порту у файрволі.

За бажання: записи та CDR

• Додайте макроси запису OPS (ops-recording і ops-hangup) з опублікованого фрагмента dialplan до вхідних і вихідних контекстів. Не змінюйте назви файлів.
• Надайте теку monitor (/var/spool/asterisk/monitor) лише для читання по HTTPS, з basic auth і списком дозволених IP.
• Для звіряння: доступ на читання до бази CDR, наприклад mysql:host=…;dbname=asteriskcdrdb, таблиця cdr.

OPS ніколи сам не вмикає запис. Якщо запис треба оголошувати, зробіть це в dialplan до початку запису. Перезавантажте Asterisk.

Крок 2: додайте Asterisk в OPS

Відкрийте Settings → Data and security → Telephony (Налаштування → Дані та безпека → Телефонія), натисніть Add a phone system (Додати телефонну систему), виберіть Asterisk і вкажіть назву.

Сторінка «Телефонія» зі списком вибору телефонної системи, полем для назви та повідомленням, що жодну телефонну систему ще не підключено.

Заповніть Asterisk address (https://pbx.example.com:8089), Manager user (AMI/AJAM), Manager secret. Для записів: Recordings base URL, Recordings user, Recordings password. Для звіряння: CDR database DSN, CDR database user, CDR database password. Для самопідписаного сертифіката позначте Accept this certificate (Прийняти цей сертифікат). Збережіть.

Крок 3: тест, внутрішні номери й увімкнення

1. Натисніть Test connection (Перевірити підключення). Очікуйте "The PBX answered over AJAM." (Станція відповіла через AJAM) і "A recording source is configured." (Джерело записів налаштовано) або підказку.
2. Внутрішні номери не імпортуються. Введіть кожен номер і виберіть у Belongs to (Належить) людину. Для групи додайте всіх через Add person (Додати особу).
3. Натисніть Enable (Увімкнути) і зробіть тестовий дзвінок.

Що відбувається після підключення

• Вхідні дзвінки: OPS читає події Asterisk короткими інтервалами. Унизу праворуч видно, хто телефонує, з кнопками, щоб відкрити контакт чи компанію, створити тікет із заповненим номером або додати номер як контакт. Переадресований дзвінок лишається одним дзвінком.
• Дзвінок у клік: з власним внутрішнім номером (не групою) спочатку дзвонить ваш телефон, потім клієнт. OPS не передає аудіо. Потім ви фіксуєте результат.
• Журнал: кожен дзвінок потрапляє в CRM-хронологію контакту й компанії, пов'язаний з найновішою відкритою угодою. Не в тікети. Невідомі номери йдуть в окремий список; OPS ніколи сам не створює контакти.
• Пропущені дзвінки сповіщають людину, чий телефон дзвонив, інакше — відповідального за угоду.
• Записи завантажуються після дзвінка, прив'язуються до правильного дзвінка й відтворюються в OPS, із журналом, хто слухав. Пропущені дзвінки не завантажуються.
• Звіряння: з базою CDR OPS доповнює дані щоночі.

Корисно знати

• Лише HTTPS: OPS ніколи не надсилає manager-дані через звичайний HTTP.
• Записи OPS бере лише з HTTPS-теки.
• Вихідні дзвінки OPS запускає в контексті from-internal.
• Двоканальний запис подвоює місце на диску, зате підсумки дзвінків розділяють абонента й працівника. Підсумки дзвінків за замовчуванням вимкнені (налаштування AI) і витрачають AI-кредити.
• OPS не видаляє записи на вашому Asterisk. Manager-секрет після збереження прочитати не можна.

Усунення проблем

• "The base URL is not HTTPS." (Базова URL-адреса не HTTPS.) Розмістіть AJAM за TLS.
• "The PBX did not answer over AJAM: …" (Станція не відповіла через AJAM.) Перевірте, чи існує manager-користувач, чи рядок permit містить адресу OPS і чи відкритий порт.
• "No recording source is configured." (Джерело записів не налаштовано.) Надайте теку monitor через захищений HTTPS і застосуйте фрагмент dialplan.
• Записів немає, помилки немає: назви файлів у dialplan змінено.

Почніть зараз

Нехай ваш Asterisk працює разом із CRM і service desk. Почніть безкоштовно. Дізнайтеся також про європейські інтеграції OPS і продажі та білінг.