​

Підключення та налаштування Ringostat

Ringostat — сервіс телефонії та аналітики дзвінків. Після підключення Roxy Desk може отримувати інформацію про вхідні й вихідні дзвінки, фіксувати їхній стан і пов’язувати дзвінки з клієнтами. Для налаштування знадобляться Auth-key і Project id із вашого проєкту Ringostat.

Важливо: не передавайте Auth-key стороннім особам і не додавайте його до задач, повідомлень або відкритої документації.

​

1. Відкрийте розділ «Інтеграції»

У лівому меню розгорніть розділ «Адміністрування» і натисніть «Інтеграції». Відкриється сторінка зі списком доступних інтеграцій. У верхній частині сторінки показано:

• загальну кількість інтеграцій;
• кількість активних інтеграцій;
• кількість неактивних інтеграцій.

Кожна інтеграція відображається окремою карткою з назвою, коротким описом і поточним станом.

​

2. Знайдіть інтеграцію Ringostat

Знайдіть у списку картку «Ringostat». У картці відображається поточний стан інтеграції:

• «Активний» — інтеграція ввімкнена;
• «Неактивний» — інтеграція вимкнена або ще не налаштована.

Праворуч від стану розташоване меню дій із трьома крапками.

​

3. Відкрийте форму редагування

Натисніть кнопку з трьома крапками в картці Ringostat і виберіть «Редагувати». Відкриється форма «Редагування інтеграції Ringostat». Якщо потрібно лише перевірити поточні налаштування без внесення змін, у меню картки виберіть «Переглянути».

​

4. Заповніть налаштування Ringostat

Заповніть або перевірте поля у верхній частині форми.

​

Тип інтеграції

Переконайтеся, що в полі «Тип інтеграції» вибрано значення «Телефонія». Воно визначає, що Ringostat використовується для роботи з дзвінками.

​

Стан

Виберіть потрібний стан:

• «Активний» — щоб увімкнути інтеграцію після заповнення налаштувань;
• «Неактивний» — щоб зберегти налаштування, але тимчасово не використовувати інтеграцію.

​

Auth-key

Вставте в поле «Auth-key» ключ авторизації з кабінету Ringostat. Ключ використовується для перевірки доступу під час обміну даними між Ringostat і Roxy Desk. Щоб уникнути помилки:

• скопіюйте ключ повністю;
• не додавайте пробіли перед ключем або після нього;
• використовуйте ключ саме того проєкту Ringostat, який підключаєте.

​

Project id

Вставте в поле «Project id» ідентифікатор вашого проєкту Ringostat. Значення має відповідати проєкту, з якого отримано Auth-key.

​

Посилання для інтеграції

Roxy Desk формує посилання для інтеграції автоматично. За цією адресою система приймає від Ringostat інформацію про дзвінки. Натисніть кнопку копіювання праворуч від поля, якщо посилання потрібно додати до налаштувань Ringostat або передати спеціалісту, який виконує підключення. Не змінюйте адресу вручну. Посилання є унікальним для вашого підключення.

​

5. Ознайомтеся з партнерськими умовами

Під полями налаштування розташований інформаційний блок зі спеціальними умовами Ringostat для клієнтів Roxy Desk. Станом на 24 вересня 2026 року пропозиція містить:

• повне налаштування системи спеціалістами Ringostat;
• номери для колтрекінгу;
• 5 USD на баланс для дзвінків;
• 14 днів безкоштовного використання;
• додатковий бонус 50 USD на рахунок після підключення.

Для отримання бонусу використовується промокод Ringostat_RoxyDesk. Натисніть кнопку копіювання біля промокоду, щоб скопіювати його без помилки.

Примітка: партнерські умови можуть змінюватися. Перед підключенням перевірте актуальну інформацію у формі або уточніть її у представника Ringostat.

​

6. Збережіть налаштування

Перед збереженням перевірте:

• тип інтеграції — «Телефонія»;
• потрібний стан інтеграції;
• правильність Auth-key;
• правильність Project id;
• наявність сформованого посилання для інтеграції.

Після перевірки натисніть «Зберегти» в нижній частині форми.

​

7. Перевірте стан інтеграції

Поверніться до картки Ringostat у списку інтеграцій і перевірте її стан. Якщо під час налаштування було вибрано «Активний», картка також має показувати стан «Активний». Це означає, що налаштування збережені й інтеграція ввімкнена в Roxy Desk. Для додаткової перевірки відкрийте меню картки, виберіть «Переглянути» та переконайтеся, що Project id і стан збережені правильно.

​

8. Завершіть підключення на стороні Ringostat

Якщо спеціалісти Ringostat ще не налаштували передавання дзвінків до Roxy Desk:

1. Відкрийте форму Ringostat у Roxy Desk.
2. Скопіюйте значення з поля «Посилання для інтеграції».
3. Передайте посилання спеціалісту Ringostat або додайте його як адресу webhook відповідно до налаштувань вашого проєкту Ringostat.
4. Повідомте, що події про дзвінки потрібно передавати до Roxy Desk.
5. Після налаштування виконайте тестовий дзвінок і перевірте, що інформація про нього з’явилася в Roxy Desk.

Не передавайте Auth-key у відкритому листуванні. Якщо ключ потрібен спеціалісту для налаштування, використовуйте погоджений захищений канал.

​

Як змінити або вимкнути інтеграцію

1. Відкрийте Адміністрування → Інтеграції.
2. Знайдіть картку Ringostat.
3. Натисніть кнопку з трьома крапками та виберіть «Редагувати».
4. Змініть потрібні дані або встановіть стан «Неактивний».
5. Натисніть «Зберегти».

Після вимкнення збережені налаштування залишаються у формі, але Roxy Desk не повинен використовувати інтеграцію до повторної активації.

​

Якщо інтеграція не працює

Перевірте налаштування у такому порядку:

1. Переконайтеся, що стан інтеграції — «Активний».
2. Повторно скопіюйте Auth-key із Ringostat і перевірте, що в полі немає зайвих пробілів.
3. Перевірте, що Project id належить тому самому проєкту Ringostat, що й Auth-key.
4. Переконайтеся, що в Ringostat використано посилання для інтеграції, сформоване саме для цього підключення Roxy Desk.
5. Виконайте тестовий дзвінок і перевірте, чи передав Ringostat подію до Roxy Desk.
6. Збережіть форму ще раз і перевірте стан картки Ringostat.
7. Якщо проблема залишається, передайте в технічну підтримку назву інтеграції, Project id і опис проблеми. Не надсилайте Auth-key у відкритому повідомленні.