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 Які основні API-методи МТС Маркетолог?
МТС Маркетолог підтримує два режими, і плутати їх не можна. Транзакційні повідомлення (OTP, статуси замовлень) доставляються в 3 рази швидше, ніж маркетингові, і не вимагають згоди отримувача за договором. Маркетингові (акції, новини) таргетуються за базою МТС, але потрібно дотримуватися 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 у бойовому режимі.
Які помилки виникають при інтеграції?
| Метод | Опис | Приклад використання |
|---|---|---|
| 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 вашого endpoint та події, наприклад: sms.delivered та sms.failed.
Що входить у роботу
Наша інтеграція — не просто вставка коду. Ми передаємо:
- Модуль відправки SMS — виділений клас/сервіс з підтримкою транзакційного та маркетингового режимів.
- Webhook-обробники — отримуємо статуси доставки та пишемо їх у лог або базу.
- Документацію — опис методів, схему інтеграції, інструкцію для адміністратора.
- Тестування в пісочниці — перевіряємо відправку, обробку помилок, ліміти.
- Навчання — показуємо, як запускати кампанії та читати статистику.
Строки та вартість
Базова інтеграція через REST API займає від 1 робочого дня. Якщо потрібна реєстрація альфа-імені (3–5 днів на погодження з МТС), додайте ще 3–5 днів. Повний цикл з тестуванням та документацією — до тижня. Вартість стартує від 15 000 грн (залежить від кількості сценаріїв, необхідності в кастомному таргетингу та обсягу інтеграції). Сервіс МТС Маркетолог забезпечує доставку SMS на 99,9%, що на 0,5% вище середньоринкового показника. Наприклад, для проекту з 10 000 SMS на місяць вартість складе 5 000 грн. Ми завжди називаємо фінальну цифру до початку робіт. Жодних прихованих платежів. Завдяки інтеграції ви скорочуєте витрати на SMS-розсилки до 30% — наприклад, економія від 5000 грн на місяць — за рахунок оптимізації маршрутів та таргетингу.
Наша команда має 5 років досвіду в інтеграції SMS-сервісів і реалізувала понад 50 проектів для e-commerce, банків та логістики. Гарантуємо стабільну доставку та відповідаємо за SLA. Зв'яжіться з нами для детальної оцінки вашого проекту. Замовте консультацію інженера з інтеграції МТС Маркетолог.