Интернет-магазин теряет до 30% заказов, если подтверждение не приходит вовремя. Каждая секунда задержки стоит клиентов. МТС Маркетолог решает эту задачу: его REST API обеспечивает доступ к базе абонентов МТС с гарантией доставки 99,9% и таргетингом по геолокации, полу и интересам. Согласно официальной документации МТС Маркетолог, среднее время доставки транзакционных SMS составляет менее 1 секунды, маркетинговых — до 5 секунд. За 5 лет мы выполнили 50 интеграций для e-commerce, банков и логистики. При корректной настройке вы получаете доставку 90% сообщений в течение 3 секунд. Мы подключаем сервис к вашему сайту — от простых уведомлений до сложных маркетинговых кампаний. Ниже — пример отправки на PHP с Laravel.
// Авторизация через Bearer-токен $token = Http::post('https://api.mts-marketer.ru/v1/oauth/token', [ 'grant_type' => 'client_credentials', 'client_id' => env('MTS_CLIENT_ID'), 'client_secret' => env('MTS_CLIENT_SECRET') ])->json()['access_token']; // Отправка SMS $response = Http::withToken($token) ->post('https://api.mts-marketer.ru/v1/sms/send', [ 'from' => env('MTS_SENDER_NAME'), 'to' => [$phone], 'text' => "Код подтверждения: {$code}", 'is_test' => false ]); После отправки API возвращает идентификатор сообщения. По нему можно получить статус доставки:
$status = Http::withToken($token) ->get("https://api.mts-marketer.ru/v1/sms/status/{$messageId}") ->json(); // status: QUEUED | SENT | DELIVERED | FAILED Почему стоит разделять транзакционные и маркетинговые рассылки?
МТС Маркетолог поддерживает два режима, и путать их нельзя. Транзакционные сообщения (OTP, статусы заказов) доставляются быстрее, не требуют согласия получателя по договору. Маркетинговые (акции, новости) таргетируются по базе МТС, но нужно соблюдать 152-ФЗ. Разница в характеристиках:
| Параметр | Транзакционные | Маркетинговые |
|---|---|---|
| Скорость доставки | < 1 секунды (в среднем) | 1–5 секунд |
| Согласие получателя | Не требуется (по договору) | Требуется (opt-in) |
| Таргетинг | По номеру телефона | Гео, демография, интересы |
| Лимиты | Стандартные | Настраиваются под кампанию |
| Юридические основания | Договор оказания услуг | Согласие на рекламу |
Выбор режима влияет на код интеграции: для транзакционных ставьте is_test => false, для маркетинговых — передавайте параметры сегментации.
Как настроить автоматическое обновление токена?
Bearer-токен живёт 1 час. Для бесперебойной работы реализуйте автоматическое обновление через refresh-token. Процесс состоит из трёх шагов:
- При получении токена сохраните refresh_token из ответа.
- За 5 минут до истечения current_token отправьте запрос на /v1/oauth/refresh с refresh_token.
- Обновите локальное хранилище новым access_token и refresh_token. Это предотвратит ошибки 401 Unauthorized в боевом режиме.
Основные API-методы МТС Маркетолог
| Метод | Описание | Пример использования |
|---|---|---|
| POST /v1/sms/send | Отправка SMS | to: ["+71234567890"], text: "Код: 1234" |
| GET /v1/sms/status | Получение статуса | ?messageId=abc123 |
| POST /v1/sms/campaign | Запуск маркетинговой кампании | с параметрами сегментации |
| GET /v1/stats | Статистика по рассылкам | за период, по типам |
Распространённые ошибки при интеграции
За годы реализации мы собрали частые проблемы:
-
Неверный формат номера. Номер должен быть в международном формате: 7XXXXXXXXXX. Иначе API возвращает
INVALID_PHONE. - Превышение лимитов по сегментам. Если вы отправляете маркетинговую кампанию на 100 000 номеров за раз, убедитесь, что ваш тариф поддерживает такой объём (обратитесь в поддержку МТС).
- Истечение токена. Bearer-токен живёт 1 час. В боевом коде мы реализуем автоматическое обновление через refresh-token.
- Отсутствие альфа-имени. Без зарегистрированного имени отправителя (3–5 рабочих дней) API блокирует отправку.
- Игнорирование статусов доставки. Не настраивайте polling каждые 5 секунд — используйте вебхуки для получения уведомлений о доставке.
Как обеспечить безопасность интеграции?
Храните client_secret в переменных окружения, не передавайте в коде. Используйте HTTPS. Ограничьте права доступа — создайте отдельного пользователя с правами только на SMS-отправку. Включайте логирование всех запросов. Проверяйте статусы доставки через вебхуки: настройте endpoint для получения уведомлений — это снизит нагрузку на polling.
Пример конфигурации вебхука
{ "url": "https://your-site.com/webhook/mts-status", "events": ["sms.delivered", "sms.failed"] } Что входит в работу
Наша интеграция — не просто вставка кода. Мы передаём:
- Модуль отправки SMS — выделенный класс/сервис с поддержкой транзакционного и маркетингового режимов.
- Webhook-обработчики — получаем статусы доставки и пишем их в лог или базу.
- Документацию — описание методов, схему интеграции, инструкцию для администратора.
- Тестирование в песочнице — проверяем отправку, обработку ошибок, лимиты.
- Обучение — показываем, как запускать кампании и читать статистику.
Сроки и стоимость
Базовая интеграция через REST API занимает от 1 рабочего дня. Если требуется регистрация альфа-имени (3–5 дней на согласование с МТС), добавьте ещё 3–5 дней. Полный цикл с тестированием и документацией — до недели. Стоимость рассчитывается индивидуально: зависит от количества сценариев, необходимости в кастомном таргетинге и объёма интеграции. Мы всегда называем финальную цифру до начала работ. Никаких скрытых платежей. Благодаря интеграции вы сокращаете затраты на SMS-рассылки до 30% за счёт оптимизации маршрутов и таргетинга.
Наша команда имеет 5 лет опыта в интеграции SMS-сервисов и реализовала более 50 проектов для e-commerce, банков и логистики. Гарантируем стабильную доставку и отвечаем за SLA. Свяжитесь с нами для детальной оценки вашего проекта. Закажите консультацию инженера по интеграции МТС Маркетолог.