Интеграция 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 со ссылкой на оплату через ЕРИП
• Сделка закрыта → 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, массовая рассылка на тестовый сегмент