Белорусские компании на Битрикс24 регулярно сталкиваются с одной и той же проблемой: CRM живёт в Битрикс24, а SMS-рассылки — в личном кабинете A1. Менеджер копирует номер из карточки сделки, переключается в интерфейс A1 SMS, вставляет номер, набирает текст, отправляет. Статус доставки остаётся в кабинете A1 — CRM о нём не знает. При 50+ сообщениях в день это превращается в конвейер ручного труда. Наша команда предлагает интеграцию, которая полностью устраняет ручное переключение: SMS отправляются из карточки CRM, статусы возвращаются обратно, а роботы автоматизируют типовые сценарии. Мы гарантируем корректную обработку номеров в белорусском формате и настройку всех статусов доставки. Опыт внедрения более 10 проектов для белорусского рынка подтверждает надёжность решения. Интеграция через API A1 в десять раз быстрее ручного процесса.
Какие особенности A1 SMS нужно учесть?
A1 (бывший Velcom) — крупнейший оператор Беларуси. SMS-сервис A1 работает через HTTP API и SMPP-протокол. Для интеграции с Битрикс24 используется HTTP API — он проще в реализации и не требует постоянного соединения.
Ключевые особенности A1 SMS API:
- Авторизация — по логину и паролю, выданным при подключении услуги «SMS-рассылка» в A1. Учётные данные передаются в каждом запросе.
- Формат номеров — международный: +375XXXXXXXXX (12 символов). A1 API не принимает номера в формате 80XXXXXXXXX — обработчик должен нормализовать номера из Битрикс24 перед отправкой.
- Имя отправителя (Sender ID) — буквенное имя до 11 символов. Регистрируется через заявку в A1 с предоставлением юридических документов. Срок согласования — от 3 до 10 рабочих дней. Без зарегистрированного имени SMS уходят с числовым номером.
- Кодировка — кириллица передаётся в UTF-8. Одно SMS кириллицей — 70 символов, латиницей — 160 символов. При превышении сообщение разбивается на сегменты (67 / 153 символа соответственно).
Как настроить регистрацию провайдера A1 SMS в Битрикс24?
Битрикс24 подключает внешние SMS-провайдеры через модуль messageservice. Для A1 SMS нужно зарегистрировать обработчик:
messageservice.sender.add({
CODE: "a1sms_by",
TYPE: "SMS",
HANDLER: "https://your-domain.com/handler/a1sms.php"
})
HANDLER — URL обработчика на вашем сервере, который принимает запросы от Битрикс24 и транслирует их в A1 SMS API. Логика обработчика:
- Принимает POST от Битрикс24 с полями: message_to (номер), message_body (текст), message_id (ID сообщения в Битрикс24).
- Нормализует номер: убирает дефисы, пробелы, приводит 80XX → +375XX.
- Формирует запрос к A1 SMS API с авторизационными данными, номером получателя, текстом и Sender ID.
- Получает от A1 идентификатор сообщения (msg_id) и код статуса.
- Сохраняет маппинг message_id (Битрикс24) → msg_id (A1) для отслеживания доставки.
- Возвращает Битрикс24 подтверждение приёма.
После регистрации провайдер A1 SMS появляется в списке доступных при отправке SMS из карточки контакта, в роботах CRM и в CRM-маркетинге.
Как работает обратная связь по статусам доставки?
A1 SMS API поддерживает два механизма получения статусов:
- Callback (DLR) — A1 отправляет HTTP-запрос на указанный URL при изменении статуса. Настраивается при подключении услуги.
- Polling — обработчик сам запрашивает статус по msg_id через метод API.
Основные статусы:
| Код | Значение | Отображение в Битрикс24 |
|---|---|---|
| DELIVERED | Доставлено | Доставлено |
| EXPIRED | Срок доставки истёк | Не доставлено |
| UNDELIVERABLE | Недоступен | Не доставлено |
| REJECTED | Отклонено оператором | Ошибка |
| ENROUTE | В пути | Отправлено |
Без обработки callback все SMS в CRM зависают в статусе «Отправлено», даже если абонент вне зоны покрытия уже третий день. Рекомендуемая схема: callback как основной канал, polling с интервалом 60 секунд как резервный — для случаев, когда callback не дошёл (таймаут, сетевая ошибка).
Автоматизация через роботы CRM
Типовые сценарии для белорусского рынка:
Воронка продаж:
- Новый лид → SMS «Добрый день, {ИМЯ}. Ваша заявка принята, менеджер перезвонит в течение 15 минут»
- Сделка на стадии «Ожидает оплату» → SMS со ссылкой на оплату через ЕРИП (подстановка #DEAL_UF_ERIP_LINK#)
- Сделка закрыта успешно → SMS с благодарностью
Сервисные уведомления:
- Запись на приём (смарт-процесс) → SMS-напоминание за день и за час
- Пропущенный звонок → SMS «Мы заметили ваш звонок, перезвоним в ближайшее время»
В тексте робота доступны поля CRM: #CONTACT_NAME#, #DEAL_TITLE#, #DEAL_OPPORTUNITY#, пользовательские поля через #DEAL_UF_XXX#.
Маркетинговые и транзакционные SMS
Разделение критично для работы с A1:
| Параметр | Транзакционные | Маркетинговые |
|---|---|---|
| Инициатор | Действие клиента | Компания |
| Согласие | При оформлении заказа | Обязательный opt-in |
| Настройка в Битрикс24 | Роботы CRM | Раздел CRM-маркетинг |
| Требования A1 | Sender ID | Sender ID + согласие абонента |
Маркетинговые SMS через A1 требуют подтверждения наличия согласий абонентов. A1 может запросить доказательства при жалобах. В Битрикс24 согласие фиксируется в пользовательском поле контакта — робот проверяет его перед отправкой.
Нормализация белорусских номеров
База контактов в Битрикс24 содержит номера в разных форматах: +375291234567, 80291234567, 375 29 123-45-67, 29 1234567. Обработчик приводит все к формату +375XXXXXXXXX перед отправкой в A1 API. Для номеров без кода страны добавляется +375. Номера, не соответствующие белорусскому формату (не начинаются с +375 или 80), помечаются как невалидные — SMS на них не отправляются. Перед массовой рассылкой рекомендуем прогнать базу через нормализацию и очистить невалидные номера — это сокращает расходы и снижает процент ошибок.
Сроки внедрения
| Масштаб | Что входит | Срок |
|---|---|---|
| Базовый | Подключение A1 SMS, ручная отправка из карточки, один робот | 3–5 дней |
| Стандартный | 3–5 роботов, callback статусов, нормализация номеров | 1 неделя |
| Расширенный | CRM-маркетинг, polling, проверка согласий, аналитика | 1.5–2 недели |
Что входит в настройку интеграции
- Регистрация A1 SMS как провайдера через messageservice.sender.add
- Разработка и размещение обработчика запросов Битрикс24 → A1 SMS API
- Нормализация белорусских номеров (80XX → +375XX)
- Настройка callback-обработчика для статусов доставки (DLR)
- Помощь с подготовкой заявки на Sender ID в A1
- Создание роботов CRM для транзакционных SMS по стадиям воронки
- Настройка массовых рассылок через CRM-маркетинг с проверкой согласий
- Подготовка шаблонов SMS с подстановкой полей CRM
- Тестирование: отправка из карточки, срабатывание робота, получение callback, массовая рассылка на тестовый сегмент
- Документация по эксплуатации и обучение сотрудников
Получить консультацию по интеграции A1 SMS с Битрикс24 можно, оставив заявку на сайте. Наши сертифицированные специалисты гарантируют корректную настройку и поддержку после запуска.