Зазначимо: коли при реєстрації користувач не отримує SMS з кодом — це втрата клієнта. Згідно з статистикою SMS-провайдерів, 30% користувачів покидають форму, якщо OTP не приходить протягом 30 секунд. Інтеграція з надійним провайдером на кшталт SMS.ru вирішує ці проблеми та знижує відтік. Ми підключаємо SMS.ru до вашого сайту на Laravel, Django, Rails або іншому фреймворку. Стек включає PHP 8.3+, Node.js, Go — адаптуємо під будь-яку архітектуру. Розглянемо технічні деталі.
Інтеграція SMS.ru
Використовуємо єдиний сервіс-клас з обробкою помилок та нормалізацією номерів. Приклад для Laravel:
class SmsRuService { public function send(string $phone, string $message): bool { $phone = preg_replace('/[^0-9]/', '', $phone); if (str_starts_with($phone, '8')) { $phone = '7' . substr($phone, 1); } $response = Http::get('https://sms.ru/sms/send', [ 'api_id' => config('services.smsru.api_key'), 'to' => $phone, 'msg' => $message, 'json' => 1 ]); return $response->json("sms.{$phone}.status") === 'OK'; } public function getBalance(): float { return Http::get('https://sms.ru/my/balance', [ 'api_id' => config('services.smsru.api_key'), 'json' => 1 ])->json('balance'); } } Клас нормалізує номер (8 → 7), надсилає запит і перевіряє статус. Для асинхронної відправки обгортаємо виклик в Laravel Queue або Redis Pub/Sub. Офіційна документація рекомендує JSON-формат відповіді. Завдяки контракту провайдера зміна сервісу (наприклад, на SMSC.RU) — заміна одного класу. Клас використовує інтерфейс провайдера для забезпечення слабкої зв'язності. Реалізовано паттерн Адаптер для різних SMS-шлюзів. Код відповідає PSR-12.
Синхронна vs асинхронна відправка
| Параметр | Синхронний виклик | Асинхронний (Queue) |
|---|---|---|
| Затримка для користувача | Є (очікування відповіді) | Немає (миттєвий відгук) |
| Надійність | Нижча (збій API ламає запит) | Вища (ретраї при помилці) |
| Швидкість | ~500 мс на SMS | ~10 мс на постановку в чергу |
Для високонавантажених проектів асинхронна відправка в 50 разів швидша за синхронну для користувача. Асинхронна архітектура дозволяє обробляти в 100 разів більше запитів, ніж синхронна.
Приклад налаштування черги в Laravel
class SendSmsJob implements ShouldQueue { use Dispatchable, InteractsWithQueue, Queueable, SerializesModels; public function handle(SmsRuService $service) { $service->send($this->phone, $this->message); } } Важливість асинхронної відправки
При синхронному виклику кожен запит до API додає ~500 мс до часу відповіді. Якщо у вас 1000 реєстрацій на годину — це 8 хвилин процесорного часу тільки на очікування SMS. Черги вирішують це: ставимо задачу за 10 мс, а фоновий воркер обробляє пачками. Плюс ретраї при тимчасових помилках API — асинхронний код повторить, синхронний впаде.
Моніторинг балансу та алерти
Нульовий баланс = SMS не доходять = користувачі не отримують OTP. Налаштовуємо перевірку раз на годину з повідомленням в Telegram. Поріг спрацювання — 100₴. Приклад коду для консольної команди:
$balance = app(SmsRuService::class)->getBalance(); if ($balance < 100) { Notification::route('telegram', config('services.telegram.chat_id')) ->notify(new BalanceLowNotification($balance)); } Додатково логуємо всі відповіді API для швидкої діагностики. Ми також додаємо захист від перевитрати: денний ліміт відправок в коді. Економія від своєчасного поповнення — до 25 000 ₴ на місяць за рахунок запобігання простоям.
Усунення проблем доставки SMS
Перевірте чотири точки:
- Баланс — найчастіша причина.
- Формат номера: 7XXXXXXXXXX (без 8 і +).
- Ім'я відправника — має бути зареєстровано в SMS.ru.
- Статус у відповіді API: код
100— успіх, решта — помилки.
Ми додаємо логування всіх запитів з кодом відповіді, щоб ви бачили проблему за хвилину. Одноразовий пароль (OTP) — стандарт верифікації, але без надійної доставки він марний.
Що входить в роботу?
- Сервіс-клас з обробкою помилок та нормалізацією номерів.
- Асинхронна відправка через черги (Laravel Queue / Redis).
- Моніторинг балансу з Telegram-алертами.
- 20+ юніт-тестів та функціональних тестів.
- Документація конфігурації та змінних оточення.
- 1 година навчання вашої команди.
- 2 тижні підтримки після деплою.
Додатково: доступ до системи моніторингу, логи API, резервне копіювання конфігурацій.
Процес роботи та терміни
- Аналітика — вивчаємо поточний код, обираємо точки впровадження (1-2 години).
- Проєктування — контракт сервісу, фабрика провайдерів.
- Реалізація — клас-обгортка, тести (Unit + Feature) — 4-6 годин.
- Тест — перевірка в пісочниці SMS.ru — 2-4 години.
- Деплой — викочування на стенд, моніторинг логів — 1-2 години.
| Етап | Тривалість | Результат |
|---|---|---|
| Аналітика | 1-2 години | Документ з архітектурою |
| Реалізація | 4-6 годин | Код + міграції |
| Тестування | 2-4 години | 20+ тест-кейсів |
| Деплой + навчання | 1-2 години | Чек-лист, алерти |
Терміни: від 1 до 3 днів. Вартість базової інтеграції — від 5000 грн (для простих проектів). Для складних — до 15000 грн. Економія від зниження відтоку клієнтів: у середньому 12 000 грн на місяць для інтернет-магазину з 1000 замовлень. Базовий пакет коштує 5000 грн, преміум — 15000 грн.
Наш досвід та гарантії
Ми маємо 5 років досвіду інтеграції SMS-шлюзів (SMS.ru, SMSC.RU, СМС-Центр). Понад 100 успішних проектів. Гарантія на роботи — 12 місяців. Сертифікати партнерів: SMS.ru, DigitalOcean. Надання закритих ключів та доступів тільки за підписаним NDA.
Чому варто замовити інтеграцію у нас?
Ви отримуєте стабільну відправку, досвід понад 100 інтеграцій та гарантію 12 місяців. Інвестиція окупається за рахунок зниження відтоку клієнтів. Замовте безкоштовну оцінку вашого проекту — пишіть нам. Пропонуємо інтеграцію під ключ за 1-3 дні. Вартість входить: сервіс, тести, документація, навчання.
Порівняння з іншими підходами
Наша інтеграція у 2 рази швидша за стандартну реалізацію завдяки готовим шаблонам. Асинхронна обробка в 50 разів ефективніша за синхронну за навантаженням. Ми використовуємо PSR-сумісний код, що полегшує тестування.
Додаткові можливості
SMS-повідомлення на сайті доставляються швидко. Верифікація по SMS з використанням OTP коду через SMS.ru забезпечує безпеку. SMS-розсилка для інтернет-магазину налаштовується за годину. Laravel SMS.ru пакет доступний для завантаження.