Модуль Ringostat для OkayCMS

Модуль підключає OkayCMS до Ringostat: передає контакти в Ringostat Smart Phone, підтягує журнал дзвінків і показує список “кому потрібно передзвонити” після пропущених вхідних.

Можливості

Синхронізація контактів (Ringostat Smart Phone)

• При створенні замовлення — модуль бере телефон (і email, якщо є) та відправляє контакт у Ringostat.
• При реєстрації користувача — модуль відправляє контакт за телефоном або email.
• Як буде виглядати ім’я контакту (обирається в адмінці):
  • ім’я + прізвище
  • ім’я + #номер замовлення
  • тільки #номер замовлення

Журнал дзвінків

• Завантажує дзвінки з Ringostat і зберігає їх у магазині (у таблиці модуля).
• Оновлює “активні” дзвінки (які ще тривають/додзвонюються) — щоб підтягнути фінальний статус.
• Можна завантажити вручну з адмінки за обраний період (є опція “всі записи”).
• Фільтри в адмінці: дата, номер, статус, напрямок, сортування.
• Запис розмови — відкривається по посиланню record_url (якщо воно є).
• Показує клієнта та замовлення за номером телефону (якщо в базі є такі дані).

Черга передзвону (пропущені)

• Автоматично формує список номерів для передзвону на основі журналу:
  • вхідні NO ANSWER/VOICEMAIL — додає номер у список (і рахує, скільки разів не додзвонилися)
  • PROPER/ANSWERED — прибирає номер зі списку
• Можна позначати записи як оброблені вручну в адмінці.
• Якщо є VOICEMAIL із записом — буде посилання на прослуховування.

Вимоги

• OkayCMS v4.5.2
• Акаунт Ringostat
• Auth-key та Project id з кабінету Ringostat
• Щоб дзвінки підтягувались автоматично — має працювати планувальник задач OkayCMS (scheduler/cron)

Встановлення

Варіант 1: Скачування з GitHub

1. Скачайте останню версію модуля з останнього релізу на GitHub.
2. Розпакуйте архів на сервері в каталог: {OkayCMS_root}/Okay/Modules/

Варіант 2: Встановлення через Git

1. Виконайте команду в директорії {OkayCMS_root}/Okay/Modules/Sviat:

   git clone https://github.com/devSviat/Ringostat-OkayCMS.git Ringostat

Результат встановлення

Шлях до модуля має бути таким:

{OkayCMS_root}/Okay/Modules/Sviat/Ringostat/

Після встановлення перейдіть в адмін-панель → Модулі → Знайдіть «Ringostat» → Натисніть «Встановити».

Налаштування

1. Перейдіть в адмін-панель → Модулі → Ringostat.
2. Заповніть обов'язкові поля:
   • Auth-key — ключ з кабінету Ringostat
   • Project id — ID проєкту (часто є в URL кабінету)
3. Увімкніть потрібні опції:
   • ✅ Синхронізувати контакт у Ringostat при створенні замовлення
   • ✅ Синхронізувати контакти у Ringostat (при замовленні / зміні телефону)
   • ✅ Показувати інфо замовлення в Ringostat Smart Phone (якщо використовуєте Smart Phone)
4. Оберіть формат імені контакту для передачі в Ringostat.
5. Натисніть «Зберегти».
6. Натисніть «Перевірити з'єднання», щоб перевірити доступ до API.

Використання

Синхронізація контактів

Модуль автоматично намагається синхронізувати контакт у Ringostat:

• після створення замовлення (якщо увімкнено синхронізацію);
• після реєстрації користувача (якщо увімкнено синхронізацію).

Журнал дзвінків

Журнал можна наповнювати двома способами:

• автоматично — через планувальник задач OkayCMS (модуль періодично синхронізує дзвінки);
• вручну — в адмін-панелі → Ringostat → «Журнал дзвінків» → «Завантажити з Ringostat».

Черга “Передзвонити”

В адмін-панелі → Ringostat → «Передзвонити» показуються необроблені пропущені дзвінки. Якщо по цьому номеру пізніше відбувся успішний дзвінок (статус PROPER/ANSWERED), він автоматично зникає з черги. Також можна прибрати запис вручну кнопкою «Позначити обробленим».

Важливо

• Для всіх запитів до API використовуються Auth-key та Project id з налаштувань модуля.
• Ringostat API має обмеження на кількість дзвінків за один запит — модуль завантажує їх частинами.
• Опція «Всі записи» при ручному завантаженні може займати більше часу.

Ліцензія

Модуль розповсюджується за вільною ліцензією MIT