​

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

TurboSMS — сервіс для надсилання SMS-повідомлень. Після підключення Roxy Desk може використовувати обліковий запис TurboSMS як провайдера для відправлення повідомлень клієнтам. Для налаштування знадобляться активне ім’я відправника та ключ автентифікації HTTP API з кабінету TurboSMS.

Важливо: API-ключ надає доступ до відправлення повідомлень із вашого облікового запису. Не передавайте його стороннім особам і не додавайте до задач, листування або відкритої документації.

​

Перед початком

Переконайтеся, що:

• у вас є активний обліковий запис TurboSMS;
• на балансі TurboSMS достатньо коштів для тестового повідомлення;
• у кабінеті TurboSMS зареєстроване й активоване ім’я відправника;
• ви маєте право редагувати інтеграції в Roxy Desk.

​

Підготуйте ім’я відправника

Якщо активного імені ще немає:

1. Увійдіть до особистого кабінету TurboSMS.
2. Відкрийте розділ «Відправники SMS».
3. Створіть ім’я, яке відповідає назві вашої компанії або бренду.
4. Дочекайтеся перевірки й активації імені сервісом TurboSMS.

Використовуйте в Roxy Desk лише активоване ім’я. Правила TurboSMS обмежують SMS-ім’я відправника 11 символами та дозволяють латинські літери, цифри, пробіл і окремі спеціальні символи. Докладні вимоги наведено в правилах TurboSMS.

​

Отримайте API-ключ

1. У кабінеті TurboSMS відкрийте налаштування API.
2. У блоці «Способи підключення» увімкніть «HTTP API».
3. Після створення унікального ключа автентифікації скопіюйте його.
4. Збережіть ключ у безпечному місці до завершення налаштування.

Ключ можна змінити в кабінеті TurboSMS. Після його зміни потрібно одразу оновити значення в Roxy Desk. Докладний опис доступний в офіційній документації HTTP API TurboSMS.

​

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

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

​

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

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

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

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

​

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

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

​

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

Заповніть усі обов’язкові поля форми. Порожні обов’язкові поля позначаються червоним.

​

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

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

​

Стан

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

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

Для завершення підключення виберіть «Активний».

​

Відправник

Введіть у поле «Відправник» активне SMS-ім’я з кабінету TurboSMS. Ім’я відправника — це назва, яку одержувач бачить замість номера телефону. Зазвичай використовується назва компанії або бренду. Під час заповнення:

• введіть ім’я точно так, як воно активоване в TurboSMS;
• враховуйте регістр символів;
• не додавайте зайві пробіли;
• не використовуйте ім’я, яке ще перебуває на перевірці або було відхилене;
• не використовуйте назву іншої компанії без підтвердженого права на неї.

​

API-ключ інтеграції

Вставте в поле «API-ключ інтеграції» ключ автентифікації, створений після ввімкнення HTTP API в TurboSMS. Щоб уникнути помилки:

• скопіюйте ключ повністю;
• перевірте, що перед ключем і після нього немає пробілів;
• не використовуйте логін або пароль від кабінету замість API-ключа;
• після зміни ключа в TurboSMS обов’язково оновіть його в Roxy Desk.

​

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

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

• тип інтеграції — «SMS»;
• стан — «Активний»;
• ім’я відправника відповідає активному імені в TurboSMS;
• API-ключ скопійований без помилок;
• біля полів немає повідомлень про обов’язкові або некоректні значення.

Натисніть «Зберегти» в нижній частині форми.

​

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

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

​

7. Надішліть тестове SMS

Після активації виконайте сценарій Roxy Desk, який надсилає SMS, і використайте власний номер телефону як тестовий номер одержувача. Перевірте, що:

• повідомлення надійшло на телефон;
• одержувач бачить очікуване ім’я відправника;
• у кабінеті TurboSMS з’явилася інформація про відправлення;
• статус повідомлення змінився відповідно до результату доставки;
• баланс TurboSMS змінився відповідно до вартості повідомлення.

Надсилайте повідомлення лише одержувачам, які надали згоду на їх отримання.

​

Якщо SMS не надсилаються

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

1. Переконайтеся, що картка TurboSMS має стан «Активний».
2. Перевірте, що в налаштуваннях TurboSMS увімкнено «HTTP API».
3. Повторно скопіюйте ключ автентифікації та перевірте, що в полі немає зайвих пробілів.
4. Якщо ключ було змінено, вставте нове значення в Roxy Desk і збережіть форму.
5. Перевірте, що ім’я відправника активоване в TurboSMS і записане без помилок.
6. Перевірте баланс TurboSMS.
7. Перевірте правильність номера одержувача та статус повідомлення в кабінеті TurboSMS.
8. Повторіть тестове відправлення.
9. Якщо проблема залишається, передайте технічній підтримці назву інтеграції, ім’я відправника, номер тестового одержувача, дату й приблизний час спроби. Не надсилайте API-ключ у відкритому повідомленні.