Багато компаній стикаються з проблемою: SMS-повідомлення з Бітрікс24 приходять не всім клієнтам — номери неактуальні, повідомлення губляться, а вартість розсилки зростає. Ми вирішуємо це інтеграцією SMSC — одного з найстаріших SMS-агрегаторів, який пропонує HLR-перевірку та каскадну відправку через Viber. Розберемо, як налаштувати підключення через REST API, налаштувати callbacks та досягти доставки 99% повідомлень. Наш досвід показує, що правильна інтеграція скорочує витрати на розсилку на 30-40% за рахунок виключення невалідних номерів та використання дешевого Viber-каналу. Економія для середнього бізнесу може становити десятки тисяч гривень щомісяця.
Як зареєструвати провайдера SMSC у Бітрікс24?
Для підключення SMSC використовується модуль messageservice. Провайдер реєструється REST-методом messageservice.sender.add з параметрами: CODE="smsc", TYPE="SMS", HANDLER=URL вашого обробника. Обробник приймає запит від Бітрікс24, формує GET-запит до SMSC API:
https://smsc.ru/sys/send.php?login=LOGIN&psw=PASSWORD&phones=NUMBER&mes=TEXT&fmt=3&op=1 Параметр fmt=3 — відповідь у JSON, op=1 — запит статусу доставки. Обробник зберігає зв'язку message_id Бітрікс24 та id SMSC, повертає підтвердження. Це забезпечує повний трекінг відправки. Офіційна документація SMSC API містить повний список параметрів.
Навіщо потрібна HLR-перевірка перед розсилкою?
HLR (Home Location Register) — запит до оператора, який перевіряє активність номера, визначає оператора та регіон. SMSC надає HLR через окремий метод API:
https://smsc.ru/sys/hlr.php?login=LOGIN&psw=PASSWORD&phones=NUMBER&fmt=3 Відповідь містить status (0=активний, 1=недоступний, 2=не існує), operator та region. У контексті Бітрікс24 HLR-перевірка дозволяє:
- Виключити недоступні номери з масових розсилок, заощаджуючи бюджет.
- Автоматично визначати оператора та регіон при створенні ліда через бізнес-процес з HTTP-запитом. Результат зберігається у користувацьких полях
UF_CRM_OPERATORтаUF_CRM_REGION.
Каскадна відправка: SMS + Viber
SMSC підтримує каскадну доставку в одному API-виклику. Логіка: повідомлення надсилається через Viber; якщо абонент не прочитав за заданий час (зазвичай 1-2 години), автоматично надсилається SMS. Параметри API:
https://smsc.ru/sys/send.php?login=LOGIN&psw=PASSWORD&phones=NUMBER&mes=TEXT&fmt=3&viber=1&viber_timeout=3600 viber=1 — спроба доставки через Viber, viber_timeout — тайм-аут у секундах до фолбеку на SMS. Viber-повідомлення зазвичай дешевше за SMS в 1.5-2 рази, що дозволяє доставити повідомлення максимальній кількості отримувачів за мінімальних витрат. У Бітрікс24 каскад налаштовується на рівні обробника: робот CRM викликає стандартну дію «Надіслати SMS», а обробник вирішує, чи надіслати через Viber з фолбеком, чи чистий SMS — залежно від типу повідомлення або сегменту.
Пакетна відправка для масових розсилок
SMSC приймає до 100 номерів в одному запиті (через кому). Для масових розсилок через CRM-маркетинг це критично: замість 10 000 окремих запитів обробник групує номери в пакети по 100 і надсилає 100 запитів. Виграш: швидкість розсилки зростає на порядок, навантаження на сервер та API мінімальне. Реалізація: обробник приймає запити від Бітрікс24 (кожен — один номер), складає в чергу (Redis, БД, файл), cron-задача раз на 5-10 секунд забирає до 100 номерів і надсилає пакетом. Статуси маппяться назад по id кожного повідомлення.
Callback для статусів доставки
SMSC надсилає сповіщення про статуси на вказаний URL. Налаштування — в особистому кабінеті SMSC (розділ «Налаштування → Обробник статусів»). Статуси:
| Код | Опис |
|---|---|
| 1 | Доставлено |
| 2 | Не доставлено (помилка) |
| 3 | Не доставлено (прострочено) |
| 20 | Доставлено через Viber |
| 22 | Не доставлено через Viber, надіслано SMS (каскад) |
Обробник приймає id та status, знаходить пов'язаний message_id Бітрікс24, оновлює статус у CRM. Статус «22» особливо корисний: він показує, що каскад спрацював і клієнт отримав SMS замість Viber. Цю інформацію можна записувати в користувацьке поле контакту — при наступній розсилці одразу надсилати SMS, оминаючи Viber-тайм-аут.
Покрокове налаштування обробника
- Створіть PHP-скрипт на вашому сервері, який приймає POST-запит від Бітрікс24 з полями
message_id,phone,text. - Зареєструйте провайдера через
messageservice.sender.add, вказавши URL скрипта якHANDLER. - Налаштуйте callback-URL в особистому кабінеті SMSC для прийому статусів.
- Перевірте відправку тестового повідомлення з CRM.
- Налаштуйте роботів CRM для автоматичної відправки сповіщень за стадіями.
Типові проблеми
- Обробник не відповідає: перевірте, що сервер доступний по HTTPS і повертає HTTP 200. - Статуси не приходять: переконайтеся, що callback URL вказаний без помилок і сервер приймає POST. - Повідомлення не доставляються: перевірте баланс SMSC та коректність номера.Строки впровадження
| Масштаб | Що входить | Строк |
|---|---|---|
| Базовий | Підключення SMSC, ручна відправка з картки, один робот | 3–5 днів |
| Стандартний | Роботи за стадіями, callback статусів, каскад SMS/Viber | 1 тиждень |
| Розширений | HLR-перевірка бази, пакетна відправка, CRM-маркетинг, аналітика каналів | 1.5–2 тижні |
Що входить у роботу
- Реєстрація SMSC як провайдера через
messageservice.sender.add - Розробка обробника запитів Бітрікс24 → API SMSC з підтримкою каскаду та пакетної відправки
- Налаштування HLR-перевірки бази контактів
- Створення callback-обробника статусів доставки
- Налаштування роботів CRM для транзакційних сповіщень
- Інтеграція з CRM-маркетингом для масових розсилок
- Тестування всіх сценаріїв (SMS, Viber, каскад, HLR)
- Документація та навчання
Ми гарантуємо стабільну роботу інтеграції. Наша команда має 10+ років досвіду з Бітрікс24 та SMS-сервісами. Оцінимо ваш проект і запропонуємо оптимальне рішення. Зв'яжіться з нами для консультації — отримайте стабільний SMS-зв'язок з клієнтами. Залиште заявку на сайті, і ми підберемо рішення під ваш бюджет.