Інтеграція SMS-сервісу A1 (Білорусь) з Бітрікс24
Білоруські компанії на Бітрікс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 можна, залишивши заявку на сайті. Наші сертифіковані спеціалісти гарантують коректне налаштування та підтримку після запуску.