Інтеграція сервісу SMS.ru з Bitrix24
Типова ситуація: компанія відправляє трансакційні SMS через SMS.ru — підтвердження замовлень, коди авторизації, сповіщення про доставку. CRM працює у Bitrix24. Менеджери перемикаються між двома системами, маркетингові розсилки живуть окремо від воронки продаж, а статуси доставки ніхто не відстежує. Інтеграція зводить усе в один вікно: SMS відправляються прямо з CRM, статуси повертаються, аналітика збирається в одному місці.
Реєстрація провайдера через messageservice.sender.add
Bitrix24 працює з SMS-провайдерами через модуль messageservice. Щоб SMS.ru з'явився у списку доступних сервісів, його потрібно зареєструвати через REST API:
messageservice.sender.add({
CODE: "smsru",
TYPE: "SMS",
HANDLER: "https://your-domain.com/handler/smsru.php"
})
HANDLER — URL скрипту, який отримує запити від Bitrix24 та перенаправляє їх у API SMS.ru. Bitrix24 відправляє POST-запит з полями: номер одержувача (message_to), текст повідомлення (message_body), ідентифікатор повідомлення (message_id).
Обробник на вашій стороні:
- Отримує дані від Bitrix24.
- Формує запит до API SMS.ru:
https://sms.ru/sms/send?api_id=YOUR_KEY&to=NUMBER&msg=TEXT&json=1. - Отримує відповідь від SMS.ru з
sms_idта статусом. - Зберігає маппінг
message_id(Bitrix24) →sms_id(SMS.ru) для подальшого відстеження доставки. - Повертає підтвердження Bitrix24.
Після реєстрації провайдер доступний у роботах CRM, у ручній відправці SMS з карточки та у CRM-маркетингу.
Webhook для статусів доставки
SMS.ru підтримує callback-сповіщення про зміну статусу повідомлення. У особистому кабінету SMS.ru встановлюється URL обробника, який буде отримувати POST-запити при зміні статусу:
- 100 — повідомлення в черзі
- 101 — передано оператору
- 102 — доставлено
- 103 — не доставлено (просрочено)
- 104 — не доставлено (помилка)
Обробник отримує sms_id та status, знаходить пов'язаний message_id із Bitrix24 та викликає метод оновлення статусу в Bitrix24. Без цього механізму усі повідомлення в CRM показуватимуть статус «Відправлено», навіть якщо абонент насправді недоступний.
На практиці callback від SMS.ru приходить із затримкою від кількох секунд до хвилини. Для критичних сценаріїв (підтвердження оплати) додатково налаштовуємо поліцинг через метод sms.ru/sms/status з перевіркою за sms_id кожні 30 секунд.
Трансакційні та маркетингові SMS
Розділення принципово важливо — і технічно, й юридично.
Трансакційні SMS — сповіщення, пов'язані з дією клієнта: підтвердження замовлення, зміна статусу доставки, нагадування про запис. Відправляються автоматично через роботи CRM:
- Угода переходить на стадію «Підтверджено» → робот «Відправити SMS» → текст з номером замовлення та сумою
- Запис у смарт-процесі «Запис на приймання» перейшов на стадію «За день до» → SMS-нагадування
Для трансакційних SMS у SMS.ru використовується стандартний маршрут відправки. Ім'я відправника (буквено-цифровий ID відправника) реєструється у особистому кабінету SMS.ru та підтверджується документами.
Маркетингові SMS — розсилки по базі: акції, спеціальні пропозиції, реактивація. Відправляються через CRM-маркетинг Bitrix24: сегмент контактів → створення SMS-розсилки → вибір провайдера SMS.ru → відправка.
Ключові відмінності:
| Параметр | Трансакційні | Маркетингові |
|---|---|---|
| Ініціатор | Дія клієнта (замовлення, запис) | Компанія (розсилка по базі) |
| Згода | Припускається при оформленні замовлення | Обов'язкове явне дозволення |
| Вартість | Стандартний тариф SMS.ru | Тариф SMS.ru (той же, але більший обсяг) |
| Налаштування в Bitrix24 | Роботи CRM / бізнес-процеси | Розділ CRM-маркетинг |
| Обмеження | Немає ліміту за кількістю | SMS.ru може обмежувати частоту |
Автоматизація через роботи CRM
Роботи — основний інструмент автоматичної відправки. Налаштовуємо типові сценарії:
Воронка продаж:
- Новий ліда → SMS «Дякуємо за звернення, менеджер зв'яжеться протягом 15 хвилин»
- Угода на стадії «Очікує оплату» → SMS з посиланням на оплату (підстановка
#DEAL_UF_PAYMENT_LINK#) - Угода закрита успішно → SMS із подякою та проханням залишити відгук
Автоматизація поза воронкою:
- Пропущений дзвінок (тригер) → SMS «Ми помітили ваш дзвінок, перезвоним»
- День народження контакту (бізнес-процес за розкладом) → поздоровне SMS
У тексті робота доступні поля CRM: #CONTACT_NAME#, #DEAL_TITLE#, #DEAL_OPPORTUNITY#, користувальницькі поля через #DEAL_UF_XXX#.
Оптимізація витрат
SMS.ru тарифікує за кількістю сегментів (1 SMS = 70 символів кирилицею або 160 латиницею). Способи зменшити витрати:
- Короткі шаблони. Кожен лишній символ після 70 — це другий сегмент. Шаблон «Ваше замовлення #{ORDER} на суму {SUM} грн. підтверджено. Доставка {DATE}.» — 80 символів, два сегменти. Видаляємо «грн.», скорочуємо — 68 символів, один сегмент. Економія 50% на кожному повідомленні.
-
Фільтрація дублів. Робот може спрацювати двічі при відкату стадії. Додаємо умову у робот: відправляти тільки якщо користувальницьке поле
UF_CRM_SMS_SENTпусто, після відправки записуємо дату. -
Перевірка номерів. SMS.ru повертає помилку при відправці на невалідний номер, але тарифікує спробу. Перед масовою розсилкою запускаємо базу через
sms.ru/sms/cost— метод повертає вартість без відправки, дозволяючи виявити невалідні номери.
Терміни впровадження
| Масштаб | Що входить | Термін |
|---|---|---|
| Базовий | Підключення SMS.ru, один робот, ручна відправка з карточки | 3–5 днів |
| Стандартний | 3–5 роботів за стадіями, callback статусів, шаблони з підстановкою | 1 тиждень |
| Розширений | Масові розсилки через CRM-маркетинг, поліцинг статусів, фільтрація дублів, аналітика | 1.5–2 тижні |
Що налаштовуємо
- Реєстрація SMS.ru як провайдера через
messageservice.sender.add - Обробник запитів Bitrix24 → API SMS.ru
- Callback-обробник для статусів доставки
- Буквено-цифровий ID відправника (ім'я відправника)
- Роботи CRM для трансакційних SMS за стадіями воронки
- Масові розсилки через CRM-маркетинг
- Шаблони SMS з підстановкою полів CRM
- Перевірка та нормалізація телефонних номерів у базі
- Тестування: відправка з карточки, спрацювання робота, отримання callback, масова розсилка на тестовий сегмент