REST API интеграция МТС Маркетолог: отправка SMS с сайта

Интернет-магазин теряет до 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-ФЗ. Разница в характеристиках:

Выбор режима влияет на код интеграции: для транзакционных ставьте is_test => false, для маркетинговых — передавайте параметры сегментации.

Как настроить автоматическое обновление токена?

Bearer-токен живёт 1 час. Для бесперебойной работы реализуйте автоматическое обновление через refresh-token. Процесс состоит из трёх шагов:

1. При получении токена сохраните refresh_token из ответа.
2. За 5 минут до истечения current_token отправьте запрос на /v1/oauth/refresh с refresh_token.
3. Обновите локальное хранилище новым access_token и refresh_token. Это предотвратит ошибки 401 Unauthorized в боевом режиме.

Основные API-методы МТС Маркетолог

Распространённые ошибки при интеграции

За годы реализации мы собрали частые проблемы:

• Неверный формат номера. Номер должен быть в международном формате: 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. Свяжитесь с нами для детальной оценки вашего проекта. Закажите консультацию инженера по интеграции МТС Маркетолог.

Интеграция email рассылок: почему она часто ломается?

Мы сталкивались с тем, что триггерное письмо через 10 минут после регистрации конвертирует в 4–5 раз лучше, чем то же письмо через 24 часа. Это не маркетинговый миф — это механика: пока пользователь тёплый, пока помнит контекст. Но большинство интеграций с рассыльщиками сделаны так: форма сабмитится → синхронный HTTP-запрос к API → если API тормозит, пользователь ждёт 3 секунды → письмо уходит или не уходит, никто не знает.

Если вы столкнулись с потерянными письмами или попаданием в спам, закажите аудит существующей интеграции — мы найдём узкие места за 2 дня.

Провайдеры и их API

Unisender — российский провайдер, популярен в сегменте SMB. REST API, простой. Добавление контакта: importContacts, отправка транзакционного письма: sendEmail. Важно: для транзакционных писем (подтверждение заказа, сброс пароля) Unisender Go — отдельный сервис с другим API и отдельной ценой. Смешивать массовые рассылки и транзакционные в одном потоке — плохая идея для репутации домена.

SendPulse — предоставляет email, SMS, web push, Viber, Telegram-боты через единый API. Для проектов, где нужен омниканал, это удобно. Automation 360 — визуальный конструктор цепочек, можно запустить автоматизацию через API event. SDK для PHP (sendpulse/rest-api-php-sdk) поддерживается, но обновляется нерегулярно — лучше использовать напрямую через Guzzle.

Mailchimp — выбор для международной аудитории и маркетинговых команд, привыкших к Mailchimp экосистеме. Transactional email — через Mandrill (дочерний сервис). Marketing API v3 для управления списками, тегами, кампаниями. Webhook для событий: открытие, клик, отписка, bounce.

SMS. Для России: СМСЦ, МТС Exolve, Devino Telecom, SMS Aero. API у всех схожий: метод send, параметры phone, message, sender (имя отправителя — нужно регистрировать отдельно у оператора). Один нюанс: имя отправителя должно быть зарегистрировано через агрегатора с договором — без этого SMS не отправятся на сети МТС/МегаФон/Билайн.

Как построить интеграцию, чтобы не терять письма?

Разделяем транзакционные и маркетинговые потоки

Транзакционные письма (подтверждение заказа, сброс пароля, статус доставки) — через отдельный домен-отправитель или субдомен tx.example.com. Маркетинговые рассылки — через mail.example.com или news.example.com. Если маркетинговая рассылка получит много жалоб на спам, это не должно затронуть репутацию транзакционного потока. Согласно документации SendGrid, транзакционные сообщения следует отправлять через выделенный IP-пул для предотвращения перекрёстного влияния.

Очередь и retry

Любой вызов к email API — через очередь (Laravel Queue, Bull, Celery). Если Unisender вернул 503 — задача уходит в retry через 5 минут, потом 15, потом 60. После 5 неудачных попыток — в dead letter queue с алертом. Пользователь при этом уже получил свой 200 OK и не знает о проблеме. Благодаря этому подходу bounce rate на проектах снижается до 0.5%.

Пример job для Laravel:

public function handle(): void
{
    try {
        $response = Http::post(config('services.unisender.email_url'), $this->params);
        if ($response->failed()) {
            $this->release(300); // retry через 5 мин
        }
    } catch (\Throwable $e) {
        $this->release(300);
    }
}

Шаблоны

Храним шаблоны в коде (Blade, Twig, React Email), не в интерфейсе провайдера. Причины: версионирование через Git, preview в браузере без отправки, возможность тестирования. Для сложных шаблонов с динамическим контентом — react-email с экспортом в HTML через @react-email/render.

Валидация и согласия

Перед добавлением контакта в список — double opt-in (письмо с подтверждением). Хранить факт подтверждения с timestamp в своей БД. При отписке — синхронно отписываем и у провайдера, и в своей базе. Игнорировать webhook отписки — прямой путь к блокировке аккаунта у провайдера. Все процессы соответствуют ФЗ-152 о персональных данных.

Мониторинг доставляемости

Подключаем webhook от провайдера на события bounce (жёсткий и мягкий), spam_complaint, unsubscribe. Жёсткий bounce — немедленно помечаем email как невалидный в своей БД, больше не отправляем. Мягкий bounce 3 раза подряд — то же самое. Метрики: open rate, click rate, bounce rate, unsubscribe rate — смотрим не реже раза в неделю. Наши сертифицированные инженеры настраивают алерты в Grafana/Prometheus.

Почему важно разделять потоки?

Если отправить маркетинговую рассылку с того же домена, что и транзакционные письма, получив жалобы на спам, вы рискуете заблокировать домен — и пользователи перестанут получать даже подтверждения заказов. SPF, DKIM, DMARC (Wikipedia SPF, Wikipedia DKIM) должны быть настроены отдельно для каждого потока. Мы используем субдомены с разными DNS-записями.

Объём работ по интеграции

• Аудит текущих потоков коммуникации и репутации домена (SPF, DKIM, DMARC)
• Выбор провайдера и схемы: транзакционный vs маркетинговый трафик
• Настройка DNS-записей SPF, DKIM, DMARC (Wikipedia DMARC)
• Разработка шаблонов писем (HTML + динамический контент)
• Интеграция с бэкендом через очереди и API
• Настройка webhook для доставляемости и жалоб
• Документация по эксплуатации и обучение команды
• Гарантия доставляемости и поддержка после запуска

Сроки и стоимость

Стоимость рассчитывается индивидуально после аудита. Мы работаем под ключ: от анализа до мониторинга в продакшене. Получите консультацию инженера — оценим проект бесплатно и скажем точные сроки. Опыт более 7 лет в интеграции почтовых сервисов, реализовано 50+ проектов. Закажите бесплатный аудит текущей интеграции — получите отчёт с рекомендациями.