Як уникнути втрати транзакційних SMS: інтеграція SMSC

Як уникнути втрати транзакційних SMS: інтеграція SMSC

Кожне п'яте транзакційне SMS-повідомлення не доходить до клієнта через неправильне кодування, відсутність fallback-каналів або ігнорування статусів доставки. Типова картина: після реєстрації користувач не отримує OTP, втрачає доступ до акаунту та йде до конкурентів. Ми вирішували ці проблеми у 30+ проєктах — від інтернет-магазинів до банківських систем. SMSC — російський агрегатор, чиї тарифи на 20% нижчі за середньоринкові, а підтримка мультиканальних каскадів (Viber + SMS) економить до 30% бюджету на розсилки. Без правильної інтеграції ці переваги обертаються головним болем.

Проблеми інтеграції SMSC та їх вирішення

Неправильне кодування кирилиці. Якщо не передати charset=utf-8, SMSC за замовчуванням використовує CP-1251 — текст перетворюється на кракозябри. Рішення: явно вказувати charset у кожному запиті. Згідно з документацією SMSC, параметр charset обов'язковий для кириличних повідомлень. Докладніше про кодування UTF-8.

Перевищення лімітів. SMSC обмежує кількість повідомлень за хвилину на одну IP-адресу. При масовій розсилці без черги частина листів втрачається. Ми додаємо чергу (Laravel Queue або Redis) та налаштовуємо троттлінг з паузами між пачками по 50 повідомлень.

Необроблені помилки. API повертає помилки, але багато розробників не перевіряють відповідь. Ми завжди парсимо JSON, логуємо error_code та відправляємо повтор при таймауті.

Чому важливий charset=utf-8 при відправці кирилиці?

Якщо забути про charset=utf-8, SMSC за замовчуванням кодує текст у CP-1251. Більшість сучасних сайтів працюють у UTF-8 — у результаті абонент бачить нечитабельні символи. Ми в кожному запиті явно передаємо charset=utf-8 і fmt=3 для JSON-відповіді. Це гарантує коректне відображення кирилиці у 100% випадків.

Способи інтеграції

HTTP API

$response = Http::get('https://smsc.ru/sys/send.php', [
    'login'   => env('SMSC_LOGIN'),
    'psw'     => env('SMSC_PASSWORD'),
    'phones'  => $phone,
    'mes'     => $message,
    'charset' => 'utf-8',
    'fmt'     => 3,  // JSON відповідь
    'sender'  => env('SMSC_SENDER_NAME')
]);

$result = $response->json();
// ['id' => 1, 'cnt' => 1] — успіх
// ['error' => 'Помилка', 'error_code' => X] — помилка

Офіційна бібліотека

SMSC надає PHP-клас smsc_api.php:

require 'smsc_api.php';

$smsc = new SMSC_API();
$smsc->init(env('SMSC_LOGIN'), env('SMSC_PASSWORD'));

[$n_phones, $n_sms, $cost, $balance] = $smsc->send_sms(
    $phone,
    $message,
    0,           // translit
    '',          // time (delayed)
    0,           // id
    0,           // format (0=normal)
    env('SMSC_SENDER_NAME')
);

Мультиканальні розсилки та статуси доставки

SMSC підтримує каскадні відправки: спочатку Viber (дешевше), при невдачі — SMS:

Http::get('https://smsc.ru/sys/send.php', [
    // ...
    'viber'    => 1,  // спробувати через Viber
    'vk'       => 1,  // потім VK
    'phones'   => $phone,
    'mes'      => $message
]);

Як обробляти статуси доставки, щоб не втратити повідомлення?

SMS не завжди доходить — абонент поза зоною, телефон вимкнено, номер заблоковано. Без статусів ви не дізнаєтесь, що повідомлення не доставлено. SMSC надає API перевірки статусу та callback (вебхуки). Ми налаштовуємо отримання статусів і при невдачі задіюємо інший канал (Viber, WhatsApp) або повторюємо відправку через 30 хвилин. У 95% випадків повідомлення доставляється з першої спроби, але решта 5% потребують автоматичної обробки.

Що дає мультиканальний каскад Viber+SMS?

Viber — дешевий канал з високою відкриваністю, але не всі абоненти ним користуються. SMSC дозволяє налаштувати каскад: спочатку відправка через Viber, при невдачі — SMS. Це знижує витрати на розсилку в середньому на 30% і підвищує доставляємість до 99%. У налаштуваннях достатньо передати параметр viber=1.

Як уникнути перевищення лімітів при масовій розсилці?

Масова розсилка — основна причина блокувань. SMSC встановлює ліміт 100 повідомлень за секунду для тарифу «Індивідуальний». Якщо перевищити, API поверне помилку error_code=6. Рішення: розбити відправку на пачки по 50 повідомлень і робити паузу між ними.

$batch = array_chunk($phones, 50);
foreach ($batch as $chunk) {
    $response = Http::get('https://smsc.ru/sys/send.php', [...]);
    if ($response['error'] ?? false) {
        // логуємо і чекаємо 1 секунду
        sleep(1);
    }
}

Як ми налаштовуємо SMSC

Наш стандартний стек: Laravel (PHP 8.3), Guzzle для HTTP-запитів, Redis для черг. Конфіги виносимо в .env. Ми використовуємо офіційну PHP-бібліотеку smsc_api.php, але обертаємо її в service-клас з обробкою помилок. Для мультиканальних каскадів (спочатку Viber, при невдачі SMS) використовуємо параметр viber=1.

Процес роботи

1. Аналітика — вивчаємо вашу архітектуру, визначаємо точки відправки SMS (реєстрація, підтвердження замовлення, сповіщення).
2. Проєктування — обираємо метод інтеграції (HTTP API або бібліотека), налаштовуємо чергу та троттлінг.
3. Реалізація — пишемо код, обробляємо всі кейси помилок, налаштовуємо callback для статусів.
4. Тестування — відправляємо тестові повідомлення, перевіряємо доставку на різні номери, імітуємо збої.
5. Деплой — запускаємо на продакшені, налаштовуємо моніторинг (логи, алерти).

Терміни та вартість інтеграції

Базова інтеграція (один канал, без черг) займає кілька годин. Якщо потрібні мультиканальні розсилки, черги та кастомні звіти — до двох днів. Точну вартість розраховуємо після аналізу вашого проєкту. Отримайте консультацію для оцінки. Зв'яжіться з нами, щоб обговорити деталі.

Типові помилки при інтеграції SMSC

Також поширені помилки:

• Не вказано charset=utf-8 — кирилиця перетворюється на кракозябри.
• Пароль або логін передаються у відкритому вигляді — використовуйте змінні оточення.
• Не обробляється відповідь API — пропущені помилки, повідомлення не доходять.
• Відсутній fallback на інший канал — при збої SMS клієнт залишається без сповіщення.
• Не налаштовано чергу — при масовій розсилці перевищуєте ліміти SMSC.

Що входить у роботу

• Повна інтеграція SMSC з вашим сайтом на Laravel або іншому фреймворку.
• Налаштування черг і троттлінгу для масових розсилок.
• Обробка статусів доставки через callback або HTTP-запити.
• Документація з інтеграції та доступів.
• Навчання вашої команди роботі з системою.
• Гарантія 30 днів після запуску — оперативно виправляємо будь-які проблеми.

За час роботи ми провели понад 30 успішних інтеграцій із SMSC для інтернет-магазинів, банків і сервісів доставки. Якщо вам потрібна надійна відправка транзакційних SMS, замовте консультацію — ми оцінимо ваш проєкт і запропонуємо оптимальне рішення. Отримайте безкоштовну оцінку вартості вже сьогодні.

Інтеграція 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+ проєктів. Замовте безкоштовний аудит поточної інтеграції — отримайте звіт з рекомендаціями.