Як підключити TurboSMS за токеном і іменем відправника та надсилати SMS з картки клієнта. Що потрібно налаштувати в кабінеті TurboSMS і які права потрібні.

Що це і навіщо

Український сервіс TurboSMS займається розсилкою SMS. Після підключення ви можете надсилати SMS клієнтам прямо з картки в Silium: нагадати про оплату, повідомити про відправку, уточнити деталі. Повідомлення йдуть з вашого імені відправника (так званого alpha-name) через ваш акаунт у TurboSMS, тому гроші за SMS списуються з вашого рахунку в TurboSMS, а не з Silium.

Silium не створює акаунт у TurboSMS. Спершу зареєструйтесь на turbosms.ua, поповніть рахунок, зареєструйте ім'я відправника й випустіть ключ доступу (токен).

Де знайти

Підключення: Налаштування → Інтеграції (/settings/integrations), плитка TurboSMS («SMS та Viber розсилки клієнтам напряму з системи»), кнопка «Налаштувати». Відкриється бічне вікно «TurboSms».
Відправлення: у картці контакта, контрагента, ліда та деяких документів у вкладці зв'язків, блок «SMS повідомлення».

Сторінка «Інтеграції»

Що підготувати в TurboSMS

У самому вікні є коротка підказка, що зробити. Розшифруємо простіше:

У кабінеті TurboSMS відкрийте Шлюз API → налаштування API і випустіть токен HTTP API авторизації. Це і є значення поля «Token».
Перегляньте, які імена відправників вам дозволено використовувати (розділ з іменами у кабінеті TurboSMS).
Рекомендовано: відкрийте Шлюз API → Вебхуки, додайте новий вебхук з адресою, яку показує вікно (вона має вигляд https://ваша-компанія…/ajax/integration/turbo-sms-webhook), події «Отримання статусу доставки SMS, відправленого по HTTP API» та «Отримання статусу доставки Viber, відправленого по HTTP API», формат даних JSON.

Також у вікні є застереження: підключення може бути автоматично відключено з боку TurboSMS, якщо воно не використовується більше ніж 6 місяців.

Поля підключення

Поле	Обов'язкове	Що вводити
Відправник (через крапку з комою, якщо декілька)	Так	Ім'я, від якого підуть SMS. Якщо імен кілька, перелічіть їх через крапку з комою без пробілів, наприклад `MyShop;MyShop2`. Написання має точно збігатися з тим, що зареєстровано в TurboSMS.
Token	Так	Токен HTTP API з кабінету TurboSMS.

Натисніть «Зберегти». Система одразу перевіряє токен запитом до TurboSMS (просить баланс). Якщо токен правильний, з'явиться тост «Дані успішно збережені», і вікно закриється. Якщо ні, побачите повідомлення «Невалідний токен». Порожні поля підсвічуються червоним.

Інші відповіді: «Інтеграція вже додана. Видаліть існуючу і додайте ще раз.» означає, що підключення вже є (підключення лише одне на компанію).

Що ви побачите, коли TurboSMS уже підключено

Повторно відкривши вікно, ви побачите імена відправників і замаскований токен (видно лише початок, решта прихована зірочками). Поля недоступні для редагування. Змінити дані не можна, тому потрібно натиснути кнопку «Видалити інтеграцію», підтвердити, побачити тост «Інтеграція успішно видалена» й підключити знову з новими даними. Кнопка «Зберегти» у цьому стані просто закриває вікно.

Як надіслати SMS

Відкрийте картку, наприклад контакта. У вкладці зв'язків знайдіть блок «SMS повідомлення» з кнопкою «Відправити SMS» (+).
Відкриється вікно «Відправити SMS повідомлення».
Заповніть поля:
- Відправник: вибір зі списку імен, які ви вказали при підключенні. Підставляється перше.
- Номер телефону: обов'язково. Якщо в картці є телефон, він підставляється автоматично. Пишіть у міжнародному форматі з кодом країни, наприклад 380671234567.
- Текст повідомлення: обов'язково, до 1000 символів.
Натисніть «Зберегти». Якщо все добре, з'явиться тост «Повідомлення успішно відправлене».

Блок «SMS повідомлення» містить таблицю з колонками Телефон, Статус, Текст (перші 50 символів), Дата.

Де є блок «SMS повідомлення»: картки контакта, контрагента, ліда, рахунка, а також закупівлі й надходження, де відомий телефон контрагента.

Важливо: поточна версія не гарантує, що кожне відправлене SMS потрапляє у таблицю «SMS повідомлення» в картці, а статуси доставки з вебхука в картці не відображаються. Якщо треба точно дізнатись, чи дійшло повідомлення, дивіться звіт доставки в кабінеті TurboSMS.

Що відбувається в обліку

Нічого фінансового: SMS не створює проводок, не змінює баланс кас і не рухає склад. Витрати на SMS ви бачите тільки в кабінеті TurboSMS. Якщо хочете враховувати їх у витратах компанії, внесіть їх вручну як звичайну витрату (див. Операції).

Права доступу

Щоб підключати, змінювати та видаляти інтеграцію, потрібне право «Інтеграції: редагування». Плитка «Інтеграції» видна в налаштуваннях лише тим, у кого є доступ до інтеграцій.
Блок «SMS повідомлення» в картках показується, тільки якщо ви маєте обидва права: «SMS: перегляд» і «Інтеграції: редагування» (список імен відправників береться з налаштувань інтеграції, а вони закриті цим правом). Якщо ви бачите картку без блоку SMS, найімовірніше, не вистачає одного з цих прав або TurboSMS не підключено.
Для відправки SMS потрібне право «SMS: створення», для читання історії «SMS: перегляд».

Як їх видати, див. Ролі та права доступу.

Автоматичні SMS

У конструкторі бізнес-процесів дія «Надіслати SMS» позначена як «Скоро» і поки недоступна. Тому автоматично (наприклад, «SMS клієнту після створення замовлення») SMS зараз не надсилаються, лише вручну з картки.

Типові питання і помилки

«Невалідний токен» при збереженні. Скопіюйте токен із кабінету заново (без пробілів на початку й у кінці). Переконайтесь, що це токен саме HTTP API.
Не бачу блоку «SMS повідомлення». Перевірте, що TurboSMS підключено і що у вашої ролі є права, описані вище. Поле телефону в картці порожнє? Блок усе одно відкриється, але номер доведеться ввести вручну.
Відправник не підходить. Ім'я в полі «Відправник» має збігатися з дозволеним у TurboSMS до символу. Якщо ні, TurboSMS відхилить відправлення.
SMS не дійшло. Перевірте баланс у TurboSMS, формат номера й журнал відправлень у їхньому кабінеті.
Як змінити токен? «Видалити інтеграцію» і підключити з новим токеном.

TurboSMS: SMS клієнтам