PHPackages daaner/turbosms - 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. daaner/turbosms ActiveLibrary[Mail & Notifications](/categories/mail) daaner/turbosms =============== TurboSMS for Laravel 7+ 1.40(3y ago)2333.6k↓35.2%8[2 PRs](https://github.com/daaner/turbosms/pulls)MITPHPPHP >=7.2.5 Since May 30Pushed 3y agoCompare [ Source](https://github.com/daaner/turbosms)[ Packagist](https://packagist.org/packages/daaner/turbosms)[ RSS](/packages/daaner-turbosms/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (9)Dependencies (3)Versions (9)Used By (0) Laravel TurboSMS API gateway ============================ [](#laravel-turbosms-api-gateway) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/2d8dd281db939a1bd9a46a49ca37cff07f552926879901f9fde05442779a403b/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6461616e65722f747572626f736d732f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/daaner/turbosms/?branch=master)![Laravel Support](https://camo.githubusercontent.com/fbc119104d8453364eafe3a86c665435559ba15b43ee034a9402dd07240f92d6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d372b2d627269676874677265656e2e737667)![PHP Support](https://camo.githubusercontent.com/8dacc37fd25ea278eb9ad374ce45dcf7b2b2f2b827e739e328484dc02a112d26/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e322e352b2d627269676874677265656e2e737667)[![Latest Stable Version](https://camo.githubusercontent.com/3737061d989b80706f0b6c58cc8acbd815ac09ccfae1a2d89294d4c5a332e6dc/68747470733a2f2f706f7365722e707567782e6f72672f6461616e65722f747572626f736d732f76)](//packagist.org/packages/daaner/turbosms)[![Official Site](https://camo.githubusercontent.com/77ec09c1db987a627e42c45da24c4dbebae18b75d320bf4b8a5093ed5e8933a0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f6666696369616c2d736974652d626c75652e737667)](https://turbosms.ua/)[![Total Downloads](https://camo.githubusercontent.com/1bef88b1c4f054a725198d1ab1272135568d9d0cfece6eb1f9b8c49792f6882a/68747470733a2f2f706f7365722e707567782e6f72672f6461616e65722f747572626f736d732f646f776e6c6f616473)](//packagist.org/packages/daaner/turbosms)[![License](https://camo.githubusercontent.com/c564160a797ed49d466c047f6b5bd4191e873a4882b10b9bc4498b778337bd5d/68747470733a2f2f706f7365722e707567782e6f72672f6461616e65722f747572626f736d732f6c6963656e7365)](//packagist.org/packages/daaner/turbosms) Send SMS and Viber message via TurboSMS ([turbosms.ua](https://turbosms.ua/)) using this Laravel framework package ([Laravel](https://laravel.com)). Удобный пакет для отправки и проверки SMS и Viber сообщений через сервис TurboSMS.ua #### Laravel > 7, PHP >= 7.2.5 [](#laravel--7-php--725) Минимальная версия Laravel `7.0`, для более низкой версии нужно использовать `guzzle/guzzle` Установка --------- [](#установка) Установите пакет через композер. ``` composer require daaner/turbosms ``` Если вы НЕ используете autodiscover - добавьте сервис провайдер в конфигурационный файл `config/app.php`. ``` Daaner\TurboSMS\TurboSMSServiceProvider::class, ``` Добавьте фасад `TurboSMS` в массив в `config/app.php`: ``` 'TurboSMS' => Daaner\TurboSMS\Facades\TurboSMS::class, ``` Выполните публикацию конфига и локализационных файлов командой: ``` php artisan vendor:publish --provider="Daaner\TurboSMS\TurboSMSServiceProvider" ``` Конфигураци ----------- [](#конфигураци) После публикации ресурсов поправьте файл `config/turbosms.php` и заполните `.env` новыми полями. - Создайте аккаунт на сайте [turbosms.ua](https://turbosms.ua) - Скопируйте `HTTP API` в настройках шлюза и добавьте в соответствующий параметр в `config/turbosms.php` **NOTE**На странице настройки шлюза обязательно нужно получить токен API и включить галочку `HTTP API` Использование и API ------------------- [](#использование-и-api) ### API [](#api) - `setApi($apiKey)` - `string` указываем API ключ, отличный от значения в конфиге ``` TurboSMS::setApi('MY_TURBOSMS_API_KEY_2'); ``` - `setSMSSender($smsSender)` - `string` указываем отправителя SMS, отличного от значения в конфиге ``` TurboSMS::setSMSSender('TAXI'); ``` - `setViberSender($viberSender)` - `string` указываем отправителя Viber, отличного от значения в конфиге ``` TurboSMS::setViberSender('Mobibon2'); ``` - `setStartTime($startTime)` - `carbon|string` дата и время отправки сообщения. В конфиге задается режим сна и промежуток времени. В режиме сна, сообщения будут откладываться ``` TurboSMS::setStartTime('2020-10-10 08:22'); //or TurboSMS::setStartTime(Carbon\Carbon::now()->addMinutes(5)); ``` Настройки для отправки через **Viber** или для **гибридной** отправки ([Более детально](https://turbosms.ua/api.html)) - `setViberText($viberReplaceText)` - `string` замена текста в Вайбер при гибридных отправках (заменяет текст и при простых отправках в Viber) ``` TurboSMS::setViberText('Этот текст будет получен только в Viber'); ``` - `setTTL($ttl)` - `int` срок жизни сообщения (60 - 86400) ``` TurboSMS::setTTL(86400); ``` - `setImageURL($image)` - `string` полный URL адрес изображения, которое будет отображено в сообщении ``` TurboSMS::setImageURL('http://lorempixel.com/400/400/'); ``` - `setCaption($caption)` - `string` текст на кнопке в сообщении ``` TurboSMS::setCaption('Открыть сайт'); ``` - `setAction($action)` - `string` URL адрес, куда перейдёт получатель сообщения при нажатии на кнопку ``` TurboSMS::setAction('https://www.google.com'); ``` - `setCountClicks($countClicks)` - `string|int` Флаг статистики переходов (1 - да, остальное - нет) ``` TurboSMS::setCountClicks(1); ``` - `setTransactional($isTransactional)` - `string|int` Флаг транзакционного сообщения (1 - да, остальное - нет) ``` TurboSMS::setTransactional(1); ``` ### Methods [](#methods) #### `getBalance(): return int` - получение баланса. При ошибке возвращает `null` [](#getbalance-return-int----получение-баланса-при-ошибке-возвращает-null) ``` $balance = TurboSMS::getBalance(); //or TurboSMS::setApi('MY_TURBOSMS_API_KEY_2'); $balance = TurboSMS::getBalance($otherApiKey); dd($balance); //100500.22 or null ``` #### `getBalanceJson(): return array` - получение баланса в JSON [](#getbalancejson-return-array----получение-баланса-в-json) ``` $balance = TurboSMS::getBalanceJson(); //or TurboSMS::setApi('MY_TURBOSMS_API_KEY_2'); $balance = TurboSMS::getBalanceJson($otherApiKey); dd($balance); ``` #### Получение статуса `message_id` принимает `array | string` [](#получение-статуса-message_id-принимает-array--string) ``` $status = TurboSMS::getItemsStatus($messageId); //or $arr = collect(); $arr->push('FIRST_MESSAGE_ID'); $arr->push('SECOND_MESSAGE_ID'); $arr->push('XXX_MESSAGE_ID'); $status = TurboSMS::getItemsStatus($arr); dd($status); ``` ``` [ "success" => true "result" => [ 0 => [ "message_id" => "c91a1593-****-0cd0-****-a41c8a9a22c1" "response_code" => 0 "recipient" => "*****" "sent" => "2020-01-01 00:00:01" "updated" => "2020-01-01 00:00:02" "status" => "Delivered" "type" => "sms" "response_status" => "OK" ], 1 => [ "message_id" => "c91a1593-****-0cd0-****-a41c8a9a22c2" "response_code" => 414 "response_status" => "NOT_ALLOWED_MESSAGE_ID" ] ... ] "info" => "Запрос обработан успешно" ] ``` #### Отправка сообщения(ий). Значения отправителей (телефоны) очищаются от лишних символов [](#отправка-сообщенияий-значения-отправителей-телефоны-очищаются-от-лишних-символов) `TurboSMS::sendMessages($array_or_one_phone, $text, enum['sms' || null, 'viber', 'both'])` ``` $sended = TurboSMS::sendMessages('+38(066) 777-88-99', 'Отправляем SMS'); $sended = TurboSMS::sendMessages('+38(066) 777-88-99', 'Отправляем SMS', 'sms'); // or $sended = TurboSMS::sendMessages('+38(066) 777-88-99', 'Отправляем Viber', 'viber'); $sended = TurboSMS::sendMessages('+38(066) 777-88-99', 'Гибридная отправка. Сразу в Viber, при ошибке - SMS', 'both'); ``` #### Полностью кастомная отправка. Позволяет самому сформировать URL и тело запроса. [](#полностью-кастомная-отправка-позволяет-самому-сформировать-url-и-тело-запроса) `TurboSMS::getResponse($url, $body)` ``` $url = 'https://api.turbosms.ua/NEW_MODULE/NEW_METHOD'; $body = [ ... ]; TurboSMS::setApi('MY_TURBOSMS_API_KEY_2'); $custom = TurboSMS::getResponse($url, $body); ``` Примеры использования --------------------- [](#примеры-использования) ``` use TurboSMS; ... //простая отправка $sms = TurboSMS::sendMessages('380667778899', 'TurboSMS приветствует Вас!'); $viber = TurboSMS::sendMessages('380667778899', 'TurboSMS приветствует Вас!', 'viber'); //отправка с параметрами //если сообщение будет получено в Вайбере, SMS отправки не произойдет //если Вайбер на номере не доступен - будет отправлена только SMS $ph = collect(); //массив номеров телефонов $ph->push('+38(066) 666-55-44'); //валидный номер $ph->push('+38 (099)a999-88-77 '); //валидный номер $ph->push(' телефон правильный, отправится даже с этим текстом: +38-099-11122-33 '); //валидный номер $ph->push('телефон с ошибкой (без кода страны): 099-111-22-33'); //невалидный номер $ph->push('лишние цифры после номера: 38-099-333-44-33 добавочный 5'); //невалидный номер $ph->push('лишние цифры до номера: 55 улица, 38-099-333-44-33'); //невалидный номер TurboSMS::setViberSender('Mobibon'); TurboSMS::setSMSSender('TAXI'); TurboSMS::setTTL(86400); TurboSMS::setImageURL('http://lorempixel.com/400/400/'); TurboSMS::setCaption('Открыть сайт с котиками'); TurboSMS::setAction('https://www.google.com'); TurboSMS::setCountClicks(1); TurboSMS::setTransactional(1); TurboSMS::setStartTime('lalala'); //проигнорируется TurboSMS::setStartTime('2020-10-10 08:22'); //установит дату и время отправки, если она больше текущей TurboSMS::setViberText('Этот текст будет получен только в Viber'); $sended = TurboSMS::sendMessages($ph, 'Привет в SMS. В Вайбере не отправится', 'both'); ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Credits ------- [](#credits) - [Daan](https://github.com/daaner) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 35 — LowBetter than 80% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity39 Limited adoption so far Community9 Small or concentrated contributor base Maturity56 Maturing project, gaining track record 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 ~150 days Recently: every ~185 days Total 8 Last Release 1127d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/ab7685d68b0a7a826663193b526e128552ed0993708eda185d25118745641e84?d=identicon)[Daaner](/maintainers/Daaner) --- Top Contributors [![daaner](https://avatars.githubusercontent.com/u/9641698?v=4)](https://github.com/daaner "daaner (44 commits)") --- Tags laravellaravel-turbosmsphpsmsturbosmsturbosms-apismsturbosmslaravel-smsdaaner ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/daaner-turbosms/health.svg) ``` [![Health](https://phpackages.com/badges/daaner-turbosms/health.svg)](https://phpackages.com/packages/daaner-turbosms) ``` ### Alternatives [tzsk/sms A robust and unified SMS gateway integration package for Laravel, supporting multiple providers. 320244.3k6](/packages/tzsk-sms)[nutnet/laravel-sms Package for sending SMS form your Laravel app, includes pre-installed sms providers and your custom. 2526.6k](/packages/nutnet-laravel-sms)[siam-yon/sms php实现的极简短信发送功能，基于阿里云、腾讯云最新短信发送api 142.1k](/packages/siam-yon-sms)[juanparati/brevosuite Complete Brevo integration with Laravel 1010.8k](/packages/juanparati-brevosuite) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)