Многие компании сталкиваются с проблемой: 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-связь с клиентами. Оставьте заявку на сайте, и мы подберем решение под ваш бюджет.