Інтеграція SMS-сервісу МТС SMS (Білорусь) з Бітрікс24

Інтеграція SMS-сервісу МТС SMS (Білорусь) з Бітрікс24

Стандартна картина в білоруській компанії: відділ продажів працює в Бітрікс24, а SMS-сповіщення клієнтам відправляють через особистий кабінет МТС Комунікатор. Менеджер вручну переносить номер з CRM в інтерфейс МТС, набирає текст, натискає «Відправити». Статус доставки залишається в кабінеті МТС — CRM його не бачить. При масштабуванні бізнесу ручна робота стає вузьким місцем. Інтеграція пов'язує Б24 та МТС SMS в єдиний ланцюг: відправка з карточки CRM, автоматичні роботи по етапах воронки, повернення статусів доставки.

МТС SMS API: особливості підключення

МТС Білорусь надає SMS-шлюз через платформу МТС Комунікатор. Доступ до API відкривається після укладення договору на послугу SMS-розсилки. Технічні деталі:

• Протокол — HTTP/HTTPS API (REST). МТС також підтримує SMPP, але для інтеграції з Б24 HTTP API кращий — простіше розгорнути обробник, не потрібен демон з постійним з'єднанням.
• Авторизація — за токеном (API key), виданим в особистому кабінеті МТС Комунікатор після активації послуги.
• Формат номерів — міжнародний: +375XXXXXXXXX. МТС API суворо валідує формат — номери без коду країни або в форматі 80XX відхиляються з помилкою.
• Лімітацію — обмеження на кількість запитів в секунду (rate limit) задається при підключенні. Типове значення — 10–30 SMS/сек. Для масових розсилок через CRM-маркетинг потрібно враховувати цей ліміт.

Реєстрація імені відправника (Sender ID)

МТС Білорусь вимагає обов'язкову реєстрацію латинського імені відправника. Без зареєстрованого Sender ID SMS не будуть відправлені — API повернеме помилку.

Процес реєстрації:

1. Підготовка заяви на бланку організації з указанням бажаного імені (до 11 латинських символів).
2. Копія свідоцтва про реєстрацію юридичної особи.
3. Подання через менеджера МТС або особистий кабінет.
4. Узгодження — від 5 до 14 робочих днів. МТС перевіряє, що імя не збігається з зареєстрованими торговельними марками третіх осіб.
5. Активація — імя з'являється в списку доступних в кабінеті.

Можна зареєструвати кілька Sender ID: один для трансакційних SMS (наприклад, назва компанії), інший для маркетингових розсилок. Обробник указує потрібний Sender ID в залежності від типу повідомлення.

Реєстрація провайдера в Бітрікс24

Підключення через модуль messageservice:

messageservice.sender.add({
  CODE: "mts_sms_by",
  TYPE: "SMS",
  HANDLER: "https://your-domain.com/handler/mts-sms.php"
})

Обробник (HANDLER) виконує роль прошарку між Б24 та МТС SMS API:

1. Приймає POST від Б24: message_to, message_body, message_id.
2. Нормалізує номер телефону в формат +375XXXXXXXXX.
3. Формує запит до МТС API: endpoint, API key, номер отримувача, текст, Sender ID.
4. Отримує відповідь: message_id від МТС, статус постановки в чергу.
5. Зберігає зв'язок message_id (Б24) ↔ message_id (МТС).
6. Відповідає Бітрікс24 підтвердженням.

Після реєстрації МТС SMS доступен: в ручній відправці з карточки контакту/угоди, в роботах CRM, в бізнес-процесах, в CRM-маркетингу.

Статусы доставки: callback та polling

МТС Комунікатор підтримує DLR (Delivery Report) — сповіщення про статус доставки через callback URL.

Статусы МТС:

Callback налаштовується в особистому кабінеті МТС Комунікатор — указується URL обробника на вашому сервері. МТС відправляє POST з message_id та status при кожній зміні.

Додатково реалізуємо polling через метод перевірки статусу МТС API — запит за message_id кожні 60 секунд для повідомлень, по яких callback не прийшов протягом 5 хвилин. Це страховка від втрати callback через помилки мережі.

Автоматизація через роботи CRM

Типові сценарії для білоруського ринку:

Воронка продажів:

• Новий ліда → SMS «{ІМЯ}, ваша заявка прийнята. Менеджер зв'яжеться протягом 15 хвилин»
• Угода на етапі «Рахунок виставлено» → SMS з посиланням на оплату через ERIP
• Угода закрита → SMS з подякою та посиланням на відгук

Сервіс:

• Смарт-процес «Запис» → нагадування за день до візиту
• Пропущений дзвінок → автоматичне SMS «Ми помітили ваш дзвінок»

У тексті робота використовуються поля CRM: #CONTACT_NAME#, #DEAL_TITLE#, #DEAL_OPPORTUNITY#, користувацькі поля #DEAL_UF_XXX#.

Трансакційні та маркетингові SMS

МТС Білорусь може запросити підтвердження наявності згод абонентів на маркетингові розсилки. В Б24 згода фіксуємо в користувацькому полі контакту (UF_CRM_SMS_CONSENT), робот перевіряє значення перед відправкою.

Нормалізація номерів

Обробник приводить усі номери з бази Б24 до формату +375XXXXXXXXX:

• 80291234567 → +375291234567
• 375 29 123-45-67 → +375291234567
• 29 1234567 → +375291234567
• Номери, які не відповідають білоруському формату, позначаються як невалідні

Перед масовою розсилкою рекомендується прогнати базу через нормалізацію та видалити невалідні записи.

Терміни впровадження

Що налаштовуємо

• Реєстрація МТС SMS як провайдера через messageservice.sender.add
• Обробник запитів Б24 → МТС SMS API
• Допомога з реєстрацією Sender ID в МТС Білорусь
• Нормалізація білоруських номерів
• Callback-обробник для статусів доставки (DLR)
• Polling як резервний механізм відслідкування статусів
• Роботи CRM для трансакційних SMS по етапах воронки
• Масові розсилки через CRM-маркетинг з перевіркою згод
• Шаблони SMS з підстановкою полів CRM
• Тестування: ручна відправка, роботи, callback, масова розсилка на тестовий сегмент