Мы объединили две услуги — Умную проверку номеров и отправку SMS — в API-метод SendMessage: в одном запросе проверяем активность номера получателя и отправляем SMS только при высокой оценке активности. В этой инструкции рассказываем, как отправить умную SMS-рассылку, чтобы снизить затраты и увеличить конверсию.
— — —
Что такое умная проверка и активность номера
Умная проверка номеров (УПН) — услуга, которая оценивает, насколько номер клиента активен в сети оператора.
Активность рассчитывается по шкале от 0 до 1: чем выше значение, тем чаще абонент пользуется номером и тем выше вероятность того, что он получит и прочитает SMS.
С помощью этого показателя вы можете регулировать отправку SMS: укажите порог в теле запроса SendMessage — отправим SMS, только если фактическая оценка активности выше или равна этому порогу. Рекомендуем отправлять SMS на номера с оценкой активности ≥ 0.6.
Важно: оценка — рекомендация по вероятности контакта, а не гарантия доставки.
— — —
Чем умная отправка отличается от обычной отправки SMS
| Функция | SendSms | SendMessage (канал УПН → SMS) |
|---|---|---|
| Отправка SMS с моб.номера / от имени компании | Да | Да |
| На какие номера отправляются SMS | На все номера из списка получателей | Только на номера с оценкой активности выше заданного вами порога |
| Умная проверка номеров | Нет — проверку нужно сделать отдельно через Number Lookup API или в ЛК | Да — встроена в отправку SMS |
| Cтатистика SMS | GetList и в ЛК | GetList и в ЛК |
Как работает умная отправка SMS
- Вы вызываете SendMessage, передав номер получателя и порог его активности для отправки SMS (
activity_score) - МТС Exolve проверяет активность этого номера и формирует оценку (
activity_result) - МТС Exolve отправляет SMS, если оценка выше или равна порогу. Если оценка ниже порога, SMS не отправляется
Пример №1
Ваш порог активности номера (activity_score): 0.5. Полученная оценка активности номера (activity_result): 0.6. Результат: SMS отправлено
Пример №2
Ваш порог активности номера (activity_score): 0.5. Полученная оценка активности номера (activity_result): 0.4 Результат: SMS не отправлено
Что нужно сделать перед отправкой рассылки
- Подпишите договор как юрлицо или ИП — инструкция
- Создайте приложение
- Зарегистрируйте имя компании (или купите номер) для отправки SMS — инструкция
- Зарегистрируйте шаблоны для отправки SMS (если нужно) — инструкция
- Подключите услугу «Умная проверка номеров» в настройках приложения
Как отправить рассылку в канале УПН → SMS
В теле запроса к SendMessage передайте:
channel— 5 (канал УПН → SMS)activity_score— порог активности номера получателя от 0 до 1number— номер или имя отправителяdestination— мобильный номер получателяtext— текст SMS
Подробное описание параметров и примеры запросов — в справочнике метода.
Какие могут быть результаты проверки номера и отправки SMS
| Кейс | SMS отправлено? | Что получено в ответе |
|---|---|---|
| Оценка ≥ порога | Да | ID сообщения, оценка активности |
| Оценка < порога | Нет | ID сообщения, оценка активности, ошибка "message not sent: recipient activity result is below the configured activity score" |
| Нет данных по номеру | Нет | Ошибка "no information on this number" |
Результат проверки активности номера также доступен:
- В ответе на запрос к SendMessage (
activity_result) - В статистике сообщений через GetList
- В статистике умных проверок с через GetHLRListActivityScore
- В разделе приложения «Проверка номеров» в Личном кабинете
Как оплачивается умная отправка SMS?
| Услуга | Тарифицируется | Не тарифицируется |
|---|---|---|
| Проверка номера | Если получена оценка активности | Если по номеру нет данных — ошибка "no information on this number" |
| Отправленные SMS | Если оценка выше порога | Если оценка активности ниже порога — SMS не отправлено |