PHPackages fomvasss/laravel-notification-channel-turbo-sms - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. fomvasss/laravel-notification-channel-turbo-sms ActiveLibrary[Mail & Notifications](/categories/mail) fomvasss/laravel-notification-channel-turbo-sms =============================================== This package makes it easy to send notifications using \[turbosms.ua\](https://turbosms.ua) with Laravel 2.1.0(1mo ago)48.0k—1.1%2MITPHPPHP >=8.1 Since Dec 13Pushed 1mo ago1 watchersCompare [ Source](https://github.com/fomvasss/laravel-notification-channel-turbosms)[ Packagist](https://packagist.org/packages/fomvasss/laravel-notification-channel-turbo-sms)[ Docs](https://github.com/fomvasss/laravel-notification-channel-turbo-sms)[ Fund](https://send.monobank.ua/jar/5xsqtHvVrY)[ Fund](https://ko-fi.com/fomvasss)[ RSS](/packages/fomvasss-laravel-notification-channel-turbo-sms/feed)WikiDiscussions master Synced 2d ago READMEChangelogDependencies (8)Versions (12)Used By (0) TurboSMS — канал сповіщень для Laravel ====================================== [](#turbosms--канал-сповіщень-для-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/aaf2d8c6a87d41430b97e2ae611f7d3cd1149bfa51cda18b2cd54d362f5e4c26/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666f6d76617373732f6c61726176656c2d6e6f74696669636174696f6e2d6368616e6e656c2d747572626f2d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/fomvasss/laravel-notification-channel-turbo-sms)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/b5db5786e8b39b8ca039a0dc1debcf10379d6eaef3f6493007d3dfe6dd958a40/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666f6d76617373732f6c61726176656c2d6e6f74696669636174696f6e2d6368616e6e656c2d747572626f2d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/fomvasss/laravel-notification-channel-turbo-sms) Відправка SMS-сповіщень через [turbosms.ua](https://turbosms.ua/) у Laravel. > 🇬🇧 [Documentation in English](README.en.md) --- Можливості ---------- [](#можливості) - Відправка SMS через [TurboSMS API](https://turbosms.ua/) - Перевизначення відправника для кожного повідомлення - Відкладена відправка (планування) - Тестовий режим — імітація без реального надсилання - Отримання балансу рахунку - Подія `NotificationFailed` при помилках --- Вимоги ------ [](#вимоги) ЗалежністьВерсіяPHP>= 8.1Laravel10, 11, 12, 13--- Встановлення ------------ [](#встановлення) ``` composer require fomvasss/laravel-notification-channel-turbo-sms ``` --- Налаштування ------------ [](#налаштування) Додайте конфігурацію у `config/services.php`: ``` 'turbosms' => [ 'api_token' => env('TURBOSMS_API_TOKEN'), 'sender' => env('TURBOSMS_SENDER', 'TAXI'), 'is_test' => env('TURBOSMS_IS_TEST', false), // Необов'язково: 'timeout' => env('TURBOSMS_TIMEOUT', 15), 'connect_timeout' => env('TURBOSMS_CONNECT_TIMEOUT', 10), ], ``` `.env`: ``` TURBOSMS_API_TOKEN=your_api_token_here TURBOSMS_SENDER=TAXI TURBOSMS_IS_TEST=false ``` > **Безкоштовні тестові відправники:** `TAXI`, `AKCIYA`, `BEAUTY`, `Best-offer`, `Best-Shop`, `BonusShop`, `IT Alarm`, `MAGAZIN`, `Dostavka24`, `SERVIS TAXI`, `BRAND` --- Використання ------------ [](#використання) ### 1. Створіть клас сповіщення [](#1-створіть-клас-сповіщення) ``` use Illuminate\Notifications\Notification; use NotificationChannels\TurboSms\TurboSmsChannel; use NotificationChannels\TurboSms\TurboSmsMessage; class OrderShipped extends Notification { public function __construct(private Order $order) {} public function via(mixed $notifiable): array { return [TurboSmsChannel::class]; } public function toTurboSms(mixed $notifiable): TurboSmsMessage { return TurboSmsMessage::create("Ваше замовлення #{$this->order->id} відправлено!") ->from('MyShop'); // необов'язково: перевизначити відправника } } ``` ### 2. Додайте метод маршрутизації до моделі [](#2-додайте-метод-маршрутизації-до-моделі) ``` // app/Models/User.php public function routeNotificationForTurboSms(): string { return $this->phone; // напр. '380991234567' } ``` ### 3. Надішліть сповіщення [](#3-надішліть-сповіщення) ``` $user->notify(new OrderShipped($order)); // або через фасад: Notification::send($users, new OrderShipped($order)); ``` --- Методи повідомлення ------------------- [](#методи-повідомлення) МетодОпис`content(string $text)`Текст SMS`from(string $sender)`Перевизначити ім'я або номер відправника`time(?int $timestamp)`Запланувати відправку. Наприклад: `time() + 7*60*60` — через 7 годин`test(bool $test = true)`Перевизначити тестовий режим для конкретного повідомлення**Приклад:** ``` TurboSmsMessage::create('Привіт!') ->from('BRAND') ->time(time() + 3600) // відправити через 1 годину ->test(false); ``` --- Пряме використання API ---------------------- [](#пряме-використання-api) Можна використовувати `TurboSmsApi` напряму через сервіс-контейнер: **Отримати баланс:** ``` $balance = app(\NotificationChannels\TurboSms\TurboSmsApi::class)->getBalance(); // float|null — напр. 123.45 ``` **Відправити повідомлення:** ``` use NotificationChannels\TurboSms\TurboSmsApi; use NotificationChannels\TurboSms\TurboSmsMessage; $result = app(TurboSmsApi::class)->sendMessage( '380991234567', TurboSmsMessage::create('Привіт від Laravel!') ); // Повертає: // [ // 'success' => true, // 'result' => [...], // дані відповіді API // 'info' => 'TurboSMS response status: OK', // ] ``` --- Обробка помилок --------------- [](#обробка-помилок) При невдалій відправці канал генерує подію `Illuminate\Notifications\Events\NotificationFailed`. ``` use Illuminate\Notifications\Events\NotificationFailed; use Illuminate\Support\Facades\Event; Event::listen(NotificationFailed::class, function (NotificationFailed $event) { // $event->notifiable — модель отримувача // $event->notification — об'єкт сповіщення // $event->data['exception'] — виняток logger()->error('TurboSMS помилка: ' . $event->data['message']); }); ``` --- Підтримка проекту ----------------- [](#підтримка-проекту) Якщо пакет вам корисний — підтримайте розробку: [![Monobank](https://camo.githubusercontent.com/f4ca1cf4fd0a99ddfed314cb8f65140d8e83e324bd7c1f8476c52fe4ee6b25fd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174652d4d6f6e6f62616e6b2d626c61636b)](https://send.monobank.ua/jar/5xsqtHvVrY)[![Ko-Fi](https://camo.githubusercontent.com/10764ec41c79959f08ccaf3e066c7a76c371961b1b1ff5b5f2a33aceef6e857a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174652d4b6f2d2d66692d4646354535423f6c6f676f3d6b6f2d6669266c6f676f436f6c6f723d7768697465)](https://ko-fi.com/fomvasss)[![USDT TRC20](https://camo.githubusercontent.com/214b4dc05bedda1c5129726b4450ef7f672ce6637865f8a8be83c03582bfdce8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174652d5553445425323054524332302d3236413137423f6c6f676f3d746574686572266c6f676f436f6c6f723d7768697465)](https://link.trustwallet.com/send?coin=195&address=THLgp6DxiAtbNHvgnKV56vk1L38UuUagKf&token_id=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t) USDT TRC20: `THLgp6DxiAtbNHvgnKV56vk1L38UuUagKf` --- Changelog --------- [](#changelog) Дивіться [CHANGELOG](CHANGELOG.md). Безпека ------- [](#безпека) Повідомляйте про вразливості на , а не через публічний issue. Участь у розробці ----------------- [](#участь-у-розробці) Дивіться [CONTRIBUTING](CONTRIBUTING.md). Автори ------ [](#автори) - [fomvasss](https://github.com/fomvasss) - [Всі учасники](../../contributors) Ліцензія -------- [](#ліцензія) MIT — дивіться [LICENSE.md](LICENSE.md). ### Health Score 51 — FairBetter than 95% of packages Maintenance89 Actively maintained with recent releases Popularity29 Limited adoption so far Community9 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~124 days Recently: every ~32 days Total 11 Last Release 57d ago Major Versions 1.x-dev → 2.0.02026-05-07 PHP version history (2 changes)1.0.0PHP >=7.2 2.0.0PHP >=8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/4f99b460639e7d6871597882226b1e0d9e3055992eac8b22bfcd4f90fbdac95c?d=identicon)[fomvasss](/maintainers/fomvasss) --- Top Contributors [![fomvasss](https://avatars.githubusercontent.com/u/19834478?v=4)](https://github.com/fomvasss "fomvasss (16 commits)") --- Tags laravelnotificationssmsturbosmsturbo-sms ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/fomvasss-laravel-notification-channel-turbo-sms/health.svg) ``` [![Health](https://phpackages.com/badges/fomvasss-laravel-notification-channel-turbo-sms/health.svg)](https://phpackages.com/packages/fomvasss-laravel-notification-channel-turbo-sms) ``` ### Alternatives [spatie/laravel-health Monitor the health of a Laravel application 87512.0M164](/packages/spatie-laravel-health)[fleetbase/core-api Core Framework and Resources for Fleetbase API 1235.9k20](/packages/fleetbase-core-api)[salamwaddah/laravel-mandrill-driver Mandrill notification channel for Laravel 9, 10, 11, 12, 13 1177.4k](/packages/salamwaddah-laravel-mandrill-driver) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)