Посібник користувача PearlPBX2

Версія: 2.7.2

Зміст

1. Вступ
2. Початок роботи
3. Головна панель
4. Дашборд оператора
5. Моніторинг ULINE
6. Звіти
7. Аналітика
8. Списки
9. Часті питання

1. Вступ

PearlPBX2 — це веб-інтерфейс для керування телефонною станцією Asterisk PBX. Система дозволяє:

• переглядати стан системи в реальному часі;
• відстежувати активні дзвінки та черги;
• переглядати звіти та аналітику по дзвінках;
• керувати списками номерів (блок-лист, дозволені, контакти).

Для роботи з системою достатньо веб-браузера. Жодного додаткового програмного забезпечення не потрібно.

Хто є користувачем

Даний посібник призначено для операторів кол-центру, менеджерів та співробітників, які мають доступ до груп “Report Viewer”. Таким користувачам доступні:

• головна панель зі статусом системи;
• дашборд оператора (режим реального часу);
• звіти та аналітика;
• керування списками номерів.

2. Початок роботи

Вхід до системи

1. Відкрийте веб-браузер і перейдіть за адресою вашої системи PearlPBX2.
2. Ви побачите сторінку входу:
   • Username — ваше ім’я користувача.
   • Password — ваш пароль.
3. Натисніть Log in / Увійти.

(скріншот «Сторінка входу» ще не додано)

Вихід із системи

Натисніть кнопку Logout / Вийти у верхньому меню.

Вибір мови

Система підтримує три мови:

• Українська (мова за замовчуванням)
• English
• Español

Для перемикання мови скористайтесь перемикачем мов у верхньому меню або за посиланням /i18n/set-language/.

Навігація

Після входу в системі доступне верхнє меню:

Якщо ви маєте роль superuser, також буде доступний пункт Admin panel (/admin) — на відміну від решти пунктів меню, він видимий лише суперкористувачам, а не будь-якому користувачу з правами адміністрування.

3. Головна панель

Головна сторінка (/) відображає загальний стан системи.

Статистика системи

У верхній частині сторінки показано кількість об’єктів у системі:

• SIP Users — кількість внутрішніх абонентів.
• SIP Peers — кількість зовнішніх з’єднань (транків).
• Queues — кількість черг.
• Routing Records — кількість правил маршрутизації.
• Contacts — кількість записів у довіднику контактів.
• Blocklist — кількість номерів у блок-листі.

Статус Asterisk

Відображається інформація про стан Asterisk:

• Версія — версія Asterisk (наприклад, “Asterisk 22.0.0”).
• Поточні дзвінки — кількість активних дзвінків.
• Опрацьовано дзвінків — загальна кількість опрацьованих дзвінків з моменту запуску.
• Uptime — час роботи Asterisk з моменту останнього запуску.

Активні дзвінки та черги

• Active calls — кількість дзвінків, що зараз тривають (об’єднані в мости).
• Queues — список черг із кількістю дзвінків у черзі та доступних агентів.

Графік CDR

Графік показує кількість дзвінків за останні 14 днів із розподілом за статусом (ANSWERED, NO ANSWER, BUSY, FAILED).

4. Дашборд оператора

Дашборд оператора (доступний за адресою /dashboard/ з верхнього меню, або напряму за /dashboard/live/ — обидва посилання відкривають ту саму сторінку) — це інструмент для моніторингу телефонної системи в реальному часі. Він оновлюється автоматично через WebSocket-з’єднання.

Індикатор з’єднання

У верхньому правому куті дашборду знаходиться індикатор:

• Connected (зелений) — WebSocket-з’єднання активне, дані оновлюються в реальному часі.
• Disconnected (червоний) — з’єднання втрачено. Спробуйте перезавантажити сторінку.

Вкладки дашборду

Overview

Загальний огляд системи:

• загальна кількість активних дзвінків;
• кількість дзвінків у чергах;
• кількість доступних агентів;
• кількість активних каналів PJSIP.

Queues

Список черг із детальною інформацією:

• назва черги;
• кількість дзвінків у черзі;
• кількість агентів (доступних / загальна);
• статус агентів (доступний / на павзі / зайнятий).

При натисканні на чергу відкривається модальне вікно з детальною інформацією про дзвінки та агентів у черзі.

Пауза агента: для кожного агента черги доступна кнопка Pause / Unpause, яка ставить його на паузу (або знімає з паузи) в черзі через AMI. Кнопка доступна лише користувачам із правами staff.

PJSIP

Список усіх SIP-абонентів та транків із поточним статусом:

• Online — зареєстрований та доступний.
• Offline — не зареєстрований.

Bridged

Список дзвінків, об’єднаних у мости (розмови, що тривають):

• канали-учасники;
• ідентифікатор мосту.

Channels

Повний список усіх активних каналів із детальною інформацією:

• тип каналу (PJSIP, Local, DAHDI тощо);
• Caller ID;
• статус;
• назва черги (якщо канал у черзі).

Завершення дзвінка

Для завершення активного дзвінка натисніть кнопку Hangup поряд із відповідним каналом або дзвінком. Кнопка доступна лише користувачам із правами staff.

5. Моніторинг ULINE (Parking)

Сторінка Parking (/dashboard/ulines/, у навігаційному меню — пункт Parking) відображає стан паркувальних слотів.

Що таке ULINE

ULINE (Unique Line Number) — це система розподілу паркувальних слотів (номерів 1–199). Кожен слот може бути:

• вільним — доступний для використання;
• зайнятим — у слоті припарковано дзвінок.

Як користуватись

• Сторінка автоматично оновлюється в реальному часі.
• Зайняті слоти підсвічуються кольором.
• Кнопка Flush all дозволяє звільнити всі слоти. Доступна лише користувачам із правами superuser.

6. Звіти

Розділ звітів (/reports/) надає доступ до історії дзвінків та інших даних.

CDR (Call Detail Records)

Сторінка /reports/cdr/ — детальний звіт по всіх дзвінках.

Фільтри:

• Date range — період (від/до).
• Source / Destination number — номер абонента А або Б.
• Source / Destination channel — канал абонента А або Б (окремі поля).
• Disposition — статус: Answered, Busy, No answer, Failed.
• Min / Max duration — тривалість дзвінка (сек).
• Call direction — напрямок: Incoming, Outgoing, Internal, Transit, Unbridged Peers, Unbridged Users.

Колонки звіту:

Експорт: кнопка Export CSV дозволяє вивантажити поточну вибірку звіту у форматі CSV.

Записи розмов (Monitor)

Сторінка /reports/monitor/ — перегляд та прослуховування записів розмов.

• Фільтрація за датою (від/до) та номером абонента А/Б.
• Натисніть кнопку Play / Слухати для відтворення запису.

Журнал черг (Queue Log)

Сторінка /reports/queuelog/ — журнал подій у чергах.

• фільтрація за чергою, датою (від/до), агентом, типом події (Abandoned, Completed by Agent, Completed by Caller, Connected, Enter Queue, Exit with Key, Exit with Timeout, Ring No Answer);
• перемикач Report Type дозволяє обрати вигляд звіту: Summary, Detailed, Agent Performance, Queue Performance, Lost and Found;
• прапорець Exclude known Contacts дозволяє виключити дзвінки від відомих контактів;
• перегляд деталей по кожному дзвінку;
• кнопка Export CSV для вивантаження звіту.

Звіт по колбеках

Сторінка /reports/callback/ — звіт по автоматичних зворотніх дзвінках.

Колонки:

• ID запису;
• Created — дата та час запиту;
• Source — номер, з якого надійшов запит на колбек;
• Destination — номер, на який здійснюється зворотний дзвінок;
• статус (NEW, PENDING, ANSWERED, BUSY);
• Updated — дата та час останнього оновлення статусу;
• Schedule — запланований час дзвінка;
• Service — сервіс/джерело запиту;
• тривалість розмови;
• посилання на запис розмови (якщо є).

Експорт: кнопка Export CSV для вивантаження звіту.

Звіт по маршрутизації

Сторінка /reports/routing/ — записи маршрутизації дзвінків, згруповані по таблицях маршрутизації (назва таблиці — заголовок групи, а не окрема колонка). Для кожного запису показано:

• Prefix — префікс номера;
• Name — назва запису маршрутизації;
• Target Context — контекст призначення.

7. Аналітика

Розділ аналітики (/reports/analytics/) містить 8 видів звітів із графіками Chart.js.

Дзвінки в чергах (Queue Calls)

/reports/analytics/queue-calls/ — кількість дзвінків по чергах за обраний період.

Дзвінки за номером призначення (Destination Calls)

/reports/analytics/destination-calls/ — кількість вхідних зовнішніх дзвінків, згрупованих за набраним номером (B-номер). Показує загальну кількість, відповіді, відсоток відповідей, унікальних абонентів і середній час розмови. Доступні фільтри за номером призначення, виключення контактів і обмеження топ-N, а також експорт у CSV.

Дзвінки агентів (Agent Calls)

/reports/analytics/agent-calls/ — зведення по дзвінках кожного агента.

Вихідні дзвінки (Outbound Calls)

/reports/analytics/outbound-calls/ — статистика вихідних дзвінків.

Пропущені дзвінки (Missed Calls)

/reports/analytics/missed-calls/ — кількість пропущених дзвінків за період.

Пропущені по годинах (Missed by Hour)

/reports/analytics/missed-by-hour/ — розподіл пропущених дзвінків по годинах доби.

Тривалість дзвінків (Call Duration)

/reports/analytics/call-duration/ — розподіл дзвінків за тривалістю.

Активність черг (Queue Activity)

/reports/analytics/queue-activity/ — активність черг по годинах або днях. Доступний фільтр виключення контактів.

Спільні елементи аналітики

• Вибір періоду (від/до дати).
• Фільтрація за чергою або агентом.
• Графіки на основі Chart.js (лінійні, стовпчикові, кругові).

Примітка: на відміну від звітів CDR, Queue Log та Callback (розділ 6), сторінки аналітики не мають кнопки експорту даних.

8. Списки

Розділ Lists (/lists/) надає можливість керувати списками номерів без необхідності доступу до адмін-панелі.

Блок-лист (Blocklist)

/lists/blocklist/ — список номерів, дзвінки з яких блокуються.

Додавання запису:

1. Натисніть Add / Додати.
2. Введіть Caller ID — номер телефону абонента.
3. (Опціонально) Destination — конкретне призначення для блокування.
4. (Опціонально) Reason — причина блокування.
5. (Опціонально) Expiration — дата закінчення блокування.
6. Натисніть Save / Зберегти.

Редагування: натисніть на запис у таблиці — відкриється модальне вікно редагування.

Видалення: натисніть кнопку Delete поряд із записом.

Дозволені номери (Allowlist)

/lists/allowlist/ — список номерів, які мають особливий маршрут обробки.

Інтерфейс аналогічний блок-листу.

Контакти (Contacts)

/lists/contacts/ — довідник, що зіставляє номер телефону з іменем абонента. Використовується для визначення Caller ID Name.

Поля:

• Caller ID — номер телефону.
• Name — ім’я абонента.

Інтерфейс аналогічний блок-листу.

9. Часті питання

Як оновити дашборд в реальному часі?

Дашборд оновлюється автоматично через WebSocket. Якщо з’єднання втрачено (індикатор показує “Disconnected”), перезавантажте сторінку. Якщо проблема повторюється, зверніться до адміністратора.

Чому я не бачу деякі пункти меню?

Видимість пунктів меню залежить від вашої ролі в системі. Якщо ви вважаєте, що вам потрібен доступ до додаткових розділів, зверніться до адміністратора.

Як прослухати запис розмови?

Перейдіть до Reports → Monitor, знайдіть потрібний запис за датою або номером, натисніть Play. Якщо кнопка Play неактивна — запис відсутній.

Як додати номер до блок-листа?

Перейдіть до Lists → Blocklist, натисніть Add, введіть номер та натисніть Save. Зміни набудуть чинності після застосування конфігурації адміністратором (при наступному Apply Changes).

Чи можна експортувати дані звіту?

Так, для звітів CDR, Queue Log та Callback (розділ 6) доступна кнопка Export CSV, яка вивантажує поточну вибірку у форматі CSV. Звіти Monitor, Routing та сторінки Аналітики (розділ 7) кнопки експорту не мають — дані з них можна скопіювати з таблиці вручну.

Що робити, якщо дашборд не завантажується?

1. Перевірте підключення до мережі.
2. Спробуйте перезавантажити сторінку (F5 або Cmd+R).
3. Якщо проблема не зникла, зверніться до адміністратора — можливо, не працює Redis або Dashboard Listener.

Документ створено для PearlPBX2 v2.7.2. Інтерфейс системи може відрізнятися залежно від версії.