> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roxydesk.com/llms.txt
> Use this file to discover all available pages before exploring further.
# TurboSMS
# Підключення та налаштування 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](https://turbosms.ua/ua/guide.html).
### Отримайте API-ключ
1. У кабінеті TurboSMS відкрийте налаштування API.
2. У блоці «Способи підключення» увімкніть «HTTP API».
3. Після створення унікального ключа автентифікації скопіюйте його.
4. Збережіть ключ у безпечному місці до завершення налаштування.
Ключ можна змінити в кабінеті TurboSMS. Після його зміни потрібно одразу оновити значення в Roxy Desk. Докладний опис доступний в [офіційній документації HTTP API TurboSMS](https://turbosms.ua/ua/api.html).
## 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-ключ у відкритому повідомленні.