# TurboSMS + Krokul CRM

Так. TurboSMS вбудовано в Krokul CRM як SMS-провайдера компанії. Адміністратор вставляє ключ API TurboSMS один раз, і з Krokul ідуть SMS клієнтам з угоди й з автоматизацій, повідомлення Viber з резервним SMS і сповіщення співробітникам на їхні телефони. Статус доставки TurboSMS повертає в Krokul.

**Статус:** Вбудована. **Платформи автоматизації:** Albato.

## Що отримує команда

### SMS клієнту, коли угода змінює етап

У розділі «Автоматизації» адміністратор задає правило з дією «Надіслати клієнту SMS» і шаблоном тексту. Коли угода переходить на потрібний етап, Krokul бере номер контакту, приводить його до формату 380XXXXXXXXX і передає TurboSMS через message/send. Клієнт дізнається, що замовлення відвантажене, без дзвінка менеджера.

### Viber спершу, SMS як запасний шлях

Для повідомлень з кнопкою чи картинкою Krokul надсилає в message/send обидва обʼєкти, viber і sms. TurboSMS доставляє повідомлення у Viber, а якщо воно не дійшло, автоматично відправляє той самий зміст SMS. Менеджер бачить у стрічці угоди, яким каналом клієнт отримав повідомлення.

### Статус доставки в стрічці угоди

Вебхук TurboSMS DLR_SMS_API чи DLR_VIBER_API приносить статус DELIVRD, READ, EXPIRED, UNDELIV або REJECTD за message_id. Krokul ставить його біля повідомлення в стрічці. Недоставлене SMS стає задачею перевірити номер клієнта.

### Відповідь клієнта у Viber потрапляє в тред

Подія INBOX_VIBER_SESSION приходить, коли клієнт відповів на повідомлення Viber. Krokul знаходить контакт за номером і кладе відповідь у тред угоди в «Комунікаціях», де менеджер її й опрацьовує.

### Сповіщення команді без інтернету

Кожен співробітник вказує свій номер у «Мій профіль». Непрочитані сповіщення Krokul, наприклад нова задача чи прострочена оплата, приходять йому SMS через той самий ключ TurboSMS компанії.

## Що передається між системами

| TurboSMS | Krokul | Напрям | Коли |
|---|---|---|---|
| message/send з обʼєктом sms | SMS клієнту з угоди чи з правила автоматизації | Krokul → TurboSMS | Подія правила або натиск менеджера |
| message/send з обʼєктами viber і sms (гібрид) | Повідомлення Viber з резервним SMS | Krokul → TurboSMS | Повідомлення з кнопкою чи картинкою |
| Вебхук DLR_SMS_API або DLR_VIBER_API | Статус доставки біля повідомлення в стрічці | TurboSMS → Krokul | Після доставки чи відмови |
| Вебхук INBOX_VIBER_SESSION | Відповідь клієнта в треді «Комунікацій» | TurboSMS → Krokul | Клієнт відповів у Viber |
| message/send на номер співробітника | Непрочитане сповіщення Krokul | Krokul → TurboSMS | Нове сповіщення, поки його не прочитали |
| user/balance | Перевірка ключа на екрані «SMS-провайдер» | TurboSMS → Krokul | Підключення ключа |

## Як підключити сьогодні

### Увімкнення в Krokul

1. У кабінеті TurboSMS створіть токен для HTTP API і зареєструйте підпис відправника.
2. У Krokul адміністратор відкриває екран «SMS-провайдер», вибирає TurboSMS, вставляє ключ API і підпис відправника. Krokul перевіряє ключ читанням балансу.
3. У «Мій профіль» кожен співробітник вказує номер для SMS-сповіщень.
4. У «Автоматизаціях» додайте правило з дією «Надіслати клієнту SMS» і шаблоном тексту.
5. У розділі «Вебхуки» кабінету TurboSMS вкажіть адресу Krokul для подій доставки й вхідних Viber і задайте секретний ключ.

**Дії:** Send SMS.

### Для інтеграторів

TurboSMS приймає запити до https://api.turbosms.ua з токеном у заголовку Authorization за схемою Bearer. Відповідь приходить у JSON. Вебхуки TurboSMS несуть поля id, signature, type, date, try і data, а підпис рахується як SHA1 від секретного ключа й id. Приймач, що не відповів 200, отримає повтор через 1, 3, 5 хвилин і далі, разом приблизно 4,5 години. Для власних сценаріїв Krokul віддає `card.statusChanged` і `invoice.paid` підписаними вебхуками.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи надсилає Krokul SMS через TurboSMS?

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

### Хто платить за SMS, відправлені з Krokul?

Компанія, з балансу свого кабінету TurboSMS. Krokul використовує ключ компанії й нічого не перепродає.

### У якому форматі має бути номер клієнта для TurboSMS?

Krokul сам приводить номер до формату 380XXXXXXXXX. Номер, який не вдається привести до цього вигляду, Krokul відхиляє одразу, щоб SMS не пропало мовчки.

### Чи можна надсилати через TurboSMS повідомлення Viber?

Так. Krokul передає TurboSMS повідомлення Viber разом із резервним SMS, і клієнт отримує SMS, якщо Viber не доставив повідомлення.

## Обмеження

Підпис відправника реєструється в кабінеті TurboSMS, а Krokul лише вибирає його. Баланс і тарифи повідомлень теж живуть у TurboSMS. Krokul обрізає текст SMS до 300 знаків по межі слова, що для кирилиці дає до п’яти частин.

## Пов’язані сервіси

- [Viber](https://krokul.com/uk/integrations/viber/index.md)
- [Twilio](https://krokul.com/uk/integrations/twilio/index.md)
- [Telegram](https://krokul.com/uk/integrations/telegram/index.md)
- [WhatsApp Business](https://krokul.com/uk/integrations/whatsapp-business/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)

[Месенджери з клієнтами](https://krokul.com/uk/integrations/category/messaging/index.md)

TurboSMS є торговою маркою її власника. Krokul не афілійований із TurboSMS.

Оновлено: 2026-10-14

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs