PHPackages                             tipytechnique/laravel-ovh-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. [API Development](/categories/api)
4. /
5. tipytechnique/laravel-ovh-sms

ActiveLibrary[API Development](/categories/api)

tipytechnique/laravel-ovh-sms
=============================

Use the OVH SMS API in your Laravel 5.8 application.

0.1.2(6y ago)047MITPHPPHP >=7.1.0

Since Jul 12Pushed 6y agoCompare

[ Source](https://github.com/tipytechnique/laravel-ovh-sms)[ Packagist](https://packagist.org/packages/tipytechnique/laravel-ovh-sms)[ RSS](/packages/tipytechnique-laravel-ovh-sms/feed)WikiDiscussions master Synced yesterday

READMEChangelog (3)Dependencies (4)Versions (4)Used By (0)

[![Build Status](https://camo.githubusercontent.com/f9d4dad5b045aeb030bf1934bae3ccd23c3bf60c87f9c80524a6c390ce83eca8/68747470733a2f2f7472617669732d63692e636f6d2f74697079746563686e697175652f6c61726176656c2d6f76682d736d732e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/tipytechnique/laravel-ovh-sms)

laravel-ovh-sms
===============

[](#laravel-ovh-sms)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require tipytechnique/laravel-ovh-sms
```

Usage
-----

[](#usage)

### Credentials

[](#credentials)

First you need to set your OVH credentials on your `.env` file :

```
OVHSMS_APP_KEY = "your-app-key"
OVHSMS_APP_SECRET = "your-app-secret"
OVHSMS_CONSUMER_KEY = "your-consumer-key"
OVHSMS_ACCOUNT = "your-sms-account"
OVHSMS_SENDER = "your-sms-sender"

```

To create your credentials, you can visit `https://api.ovh.com/createToken/index.cgi?GET=/sms&GET=/sms/*&PUT=/sms/*&DELETE=/sms/*&POST=/sms/*`

Optionally, you can publish this package's configuration file on your `config` folder by running

```
php artisan vendor:publish --provider="TipyTechnique\LaravelOvhSms\SmsServiceProvider"
```

If you are using the `Themosis` framework, run

```
php console vendor:publish --provider="TipyTechnique\LaravelOvhSms\SmsServiceProvider"
```

### Examples

[](#examples)

#### Dependency injection vs Facade

[](#dependency-injection-vs-facade)

You can either use the depency injection or the Facade to manage your sms.

```
// Using depency injection

use Illuminate\Routing\Controller as BaseController;
use TipyTechnique\LaravelOvhSms\Contracts\Sms;

class SmsController extends BaseController
{
    /**
     * Get all outgoing messages
     *
     * @param Sms $sms
     *
     * @return array
     */
    public function getAllSms(Sms $sms): array
    {
        return $sms->getMessages('incoming');
    }
}
```

```
// Using Facade

use Illuminate\Routing\Controller as BaseController;
use TipyTechnique\LaravelOvhSms\Facades\Sms;

class SmsController extends BaseController
{
    /**
     * Get all outgoing messages
     *
     * @param Sms $sms
     *
     * @return array
     */
    public function getAllSms(Sms $sms): array
    {
        return Sms::getMessages('incoming');
    }
}
```

#### Create a message

[](#create-a-message)

```
/**
 * First parameter  : receivers, can be a single one (string) or multiple (array)
 * Second parameter : isMarketing, true or false
 * Thir parameter   : allowResponse, true or false
 */
$message = Sms::createMessage('+33654213566', false, false);
$message = Sms::createMessage(['+33654213566', '+33652147895'], false, true);
```

#### Send a message

[](#send-a-message)

```
$message = Sms::createMessage('+33654213566', false, false);
$message->send('Hello world');

// Or with a single line
Sms::createMessage('+33654213566', false, false)->send('Hello world');
```

#### Get messages

[](#get-messages)

```
// get ongoing messages
$messages = Sms::getMessages('ongoing');

// get incoming messages
$messages = Sms::getMessages('incoming');

// get planned messages
$messages = Sms::getMessages('planned');

// for ongoing and incoming messages, you can use a second argument to set filters
// all filters are optionals
$messages = Sms::getMessages(
    'ongoing',
    [
        'dateStart' => '2019-07-01 12:00:00',    // using date as a string
        'dateEnd' => new DateTime('2019-08-01'), // using DateTime object
        'sender' => 'your-sender',
        'receiver' => 'a-receiver',
        'tag'  => 'a-tag'
    ]
);
```

#### Handle blacklisted numbers

[](#handle-blacklisted-numbers)

```
// get all blacklisted numbers
$blasklisted = Sms::getBlacklistedNumbers(); // array

// remove a given number from the blacklist
Sms::removeBlacklistedNumber('+33654632544');
```

### Testing

[](#testing)

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Issue

[](#issue)

Please submit your issue using the issue tracker.

Credits
-------

[](#credits)

- [Yannick LEONE](https://github.com/tipytechnique)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

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 ~46 days

Total

3

Last Release

2403d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0763c45ffd29a13647175ea20e1f52c41ea6d2109b97fb4743084ba5643155f6?d=identicon)[technique tipy](/maintainers/technique%20tipy)

---

Top Contributors

[![tipytechnique](https://avatars.githubusercontent.com/u/44948849?v=4)](https://github.com/tipytechnique "tipytechnique (28 commits)")

---

Tags

apilaravelsmsovhlaravel58

### Embed Badge

![Health badge](/badges/tipytechnique-laravel-ovh-sms/health.svg)

```
[![Health](https://phpackages.com/badges/tipytechnique-laravel-ovh-sms/health.svg)](https://phpackages.com/packages/tipytechnique-laravel-ovh-sms)
```

###  Alternatives

[mollie/laravel-mollie

Mollie API client wrapper for Laravel & Mollie Connect provider for Laravel Socialite

3624.1M28](/packages/mollie-laravel-mollie)[ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

457.3k](/packages/ardakilic-mutlucell)[specialtactics/l5-api

Dependencies for the Laravel API Boilerplate package

3672.8k2](/packages/specialtactics-l5-api)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)