PHPackages                             leandro980/skebby-bundle - 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. [HTTP & Networking](/categories/http)
4. /
5. leandro980/skebby-bundle

ActiveSymfony-bundle[HTTP & Networking](/categories/http)

leandro980/skebby-bundle
========================

A bundle to send SMS through Skebby service

v4.0.0(4y ago)15.4kMITPHPPHP >=7

Since May 31Pushed 4y ago1 watchersCompare

[ Source](https://github.com/LeandroLuccerini/skebby-bundle)[ Packagist](https://packagist.org/packages/leandro980/skebby-bundle)[ RSS](/packages/leandro980-skebby-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (13)Used By (0)

Skebby Symfony5 bundle
======================

[](#skebby-symfony5-bundle)

This is an unofficial Symfony5 bundle for the [Skebby](https://www.skebby.it) sms service provider.

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

[](#installation)

The suggested installation method is via [composer](https://getcomposer.org/):

```
$ composer require leandro980/skebby-bundle
```

Configuration
-------------

[](#configuration)

Enable the bundle in `config/bundles.php`

```
return [
    // ...
    // ...
    Szopen\SkebbyBundle\SkebbyBundle::class => ['all' => true],
];
```

In your `config/packages/skebby_bundle.yaml`:

```
skebby:

  # Add your Skebby account credentials
  username: 'yourskebbyusername'
  password: 'yourskebbypassword'

  # Skebby provides two kinds of authentication:
  #   - Getting a Session Id that expires in 5 minutes if no request is sent
  #   - Getting a Token always valid
  # Allowed values are:
  #   - token (default)
  #   - session
  #
  # auth_type: 'token'

  # You can choose which kind of sms send between:
  #   - "GP" for Classic+ (limited to 1530 chars, delivery warranty, delivery report)
  #   - "TI" for Classic (limited to 1530 chars, delivery warranty)
  #   - "SI" for Basic (limited to 160 chars, no delivery warranty)
  #
  # message_type: 'TI'

  # You can also add a default sender alias used to send SMS.
  # This overrides the default alias set in Skebby account but must be one of the alias
  # already registered.
  # If the message type allows a custom TPOA and the field is left empty, the user’s preferred TPOA
  # is used. Must be empty if the message type does not allow a custom TPOA.
  #
  # default_sender_alias: ""
```

Simple Symfony Usage
--------------------

[](#simple-symfony-usage)

You have access to the `SkebbyManager` service in your controller.

#### Check your account status

[](#check-your-account-status)

```
use Szopen\SkebbyBundle\Model\Manager\SkebbyManager;

// ..

/**
 * @Route("/skebby/status", name="skebby.status")
 */
public function statusAction(SkebbyManager $skebby)
{

    $s = $skebby->getStatus();

    return $this->render('skebby/index.html.twig', [
        'status' => $s,
    ]);
}
```

`SkebbyManager::getStatus` returns a [`Szopen\SkebbyBundle\Model\Response\Status`](src/Model/Response/Status.php)

#### Send an SMS

[](#send-an-sms)

```
use Szopen\SkebbyBundle\Model\Manager\SkebbyManager;
use Szopen\SkebbyBundle\Model\Data\Recipient;

// ..

/**
 * @Route("/skebby/send", name="skebby.sendsms")
 */
public function sendSmsAction(SkebbyManager $skebby)
{

    $sms = $skebby->createDefaultSms('Hello, this is a test message',
    [new Recipient('3331234567'), new Recipient('3207654321')]);

    $response = $skebby->sendSms($sms);

    return $this->render('skebby/index.html.twig', [
        'response' => $response,
    ]);
}
```

`SkebbyManager::sendSms` returns a [`Szopen\SkebbyBundle\Model\Response\SmsResponse`](src/Model/Response/SmsResponse.php)

Documentation
-------------

[](#documentation)

The Skebby bundle uses a set of clients classes that perform their specific API calls. The `SkebbyManager` is a service that wraps all the clients methods. Please refer to [Official Skebby Developer Documentation](https://developers.skebby.it/) for further info.

- [Authenticators](#authenticators)
- [UserClient](#userclient)
- [SmsClient](#smsclient)
- [SkebbyManager](#skebbymanager)

#### Authenticators

[](#authenticators)

You can choose which kind of authentication to use by `AuthenticatorFactory` class.

```
use Szopen\SkebbyBundle\Model\Auth\AuthenticatorFactory;

//..

// Token authentication
$auth = AuthenticatorFactory::create('token')
// Session authentication
// $auth = AuthenticatorFactory::create('session')

// Used to authenticate in later API calls
$arrayAccess = $auth->login('username', 'password');
```

Session authentication lasts 5 minutes if no API call is performed.

#### UserClient

[](#userclient)

Class dedicated to the User/Account API calls.

```
use Szopen\SkebbyBundle\Model\Auth\AuthenticatorFactory;
use Szopen\SkebbyBundle\Model\Client\UserClient;

//..

// Token authentication
$auth = AuthenticatorFactory::create('token')

$userClient = new UserClient('username', 'password', $auth);
```

You can read more on methods comments of [`Szopen\SkebbyBundle\Model\Client\UserClient`](src/Model/Client/UserClient.php)

#### SmsClient

[](#smsclient)

Class dedicated to the Sms API calls.

Sending a Simple Sms.

```
use Szopen\SkebbyBundle\Model\Auth\AuthenticatorFactory;
use Szopen\SkebbyBundle\Model\Client\SmsClient;
use Szopen\SkebbyBundle\Model\Data\Recipient;

//..

// Token authentication
$auth = AuthenticatorFactory::create('token')

$smsClient = new SmsClient('username', 'password', $auth);

// Creating an sms
// You must choose which kind of SMS type to send
$sms = new Sms(Sms::SMS_CLASSIC_KEY);

// Add a message
// SmsClient choose wich kind of encoding to use, between UCS2 and GSM,
// authomatically parsing the message.
// It also counts chars available based on encoding, if the ength of the message exceeds the limit
// it raises a MessageLengthException
$sms->setMessage("Hello, this is a GSM encoded message");
// Substitutes message
$sms->setMessage("Hello, this is a UCS2 encoded message because of ç char");

// Set sender
// You can add sender only if your not using BASIC SMS and the aliasis registered to your account
$sms->setSender('YourAlias');

// Creating and adding a Recipient
// When you create a "Recipient" it parses the phone number, if it's not valid it raises
// a \libphonenumber\NumberParseException
$recipient = new Recipient("+393211234567");
$sms->addRecipient($recipient);

// Sending SMS
$smsResponse = $smsClient->sendSms($sms);
// You can choose to allow invalid recipients (that means that an invalid recipient
// won't block the entire operation) and if you want have the remaining sms and credit
$smsResponse = $smsClient->sendSms($sms,
    true, // Allow invalid recipients
    true, // Return remaining
    true, // Return credit
    );
```

You can send Sms to groups. In this case the recipients must be of type Group

```
use Szopen\SkebbyBundle\Model\Auth\AuthenticatorFactory;
use Szopen\SkebbyBundle\Model\Client\SmsClient;
use Szopen\SkebbyBundle\Model\Data\Group;

//..

// Creating and adding a recipient
$recipient = new Group("groupname");
$sms->addRecipient($recipient);

// Sending SMS
$smsResponse = $smsClient->sendGroupSms($sms);
// You can choose to allow invalid recipients (that means that an invalid recipient
// won't block the entire operation) and if you want have the remaining sms and credit
$smsResponse = $smsClient->sendGroupSms($sms,
    true, // Allow invalid recipients
    true, // Return remaining
    true, // Return credit
    );
```

Sending messages with parameters is also possible. You can't send parametric sms to groups

```
// Adds a message with parameters
// The system recognizes the parameters in the text
$sms->setMessage('Hello ${name}, i know your surname is ${surname}');

// Creating and adding a Recipient with parameters
$recipient = new Recipient("+393211234567");
$recipient->addVariable('name', 'John');
$recipient->addVariable('surname', 'Dorian');
$sms->addRecipient($recipient);

// Sending SMS
// If just a Recipient does'nt contains all the parameters defined in message
// it raises a MissingParameterException
$smsResponse = $smsClient->sendSms($sms);
```

You can read more on methods comments of [`Szopen\SkebbyBundle\Model\Client\SmsClient`](src/Model/Client/SmsClient.php)

#### SkebbyManager

[](#skebbymanager)

This class is configured as a Symfony5 service and wraps all the clients methods. It adds the `SkebbyManager::createDefaultSms` that returns an Sms using all the default parameters configured in the yaml file.

```
$sms = $skebby->createDefaultSms('Hello, this is a test message');
$sms->addRecipient(new Recipient("+393211234567"));

// You can also add recipients in constructor
$sms = $skebby->createDefaultSms('Hello, this is a test message',
    [new Recipient('3331234567'), new Recipient('3207654321')]);
```

You can read more on methods comments of [`Szopen\SkebbyBundle\Model\Manager\SkebbyManager`](src/Model/Manager/SkebbyManager.php)

License
-------

[](#license)

MIT License, please see [LICENSE](LICENSE) for more information.

###  Health Score

32

—

LowBetter than 71% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity66

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

Recently: every ~165 days

Total

12

Last Release

1605d ago

Major Versions

V1.1.2 → v2.0.02020-02-05

v2.0.2 → v3.0.02020-07-15

v3.0.1 → v4.0.02021-12-16

### Community

Maintainers

![](https://www.gravatar.com/avatar/d929d9daafbb5705148080ce11f24de9f7f123db0502d2aa2a65297558a5bf5c?d=identicon)[leandro.luccerini](/maintainers/leandro.luccerini)

---

Top Contributors

[![LeandroLuccerini](https://avatars.githubusercontent.com/u/7492724?v=4)](https://github.com/LeandroLuccerini "LeandroLuccerini (53 commits)")

---

Tags

symfony sms skebby gateway

### Embed Badge

![Health badge](/badges/leandro980-skebby-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/leandro980-skebby-bundle/health.svg)](https://phpackages.com/packages/leandro980-skebby-bundle)
```

###  Alternatives

[spatie/crawler

Crawl all internal links found on a website

2.8k16.3M52](/packages/spatie-crawler)[omniphx/forrest

A Laravel library for Salesforce

2724.4M8](/packages/omniphx-forrest)[akamai-open/edgegrid-client

Implements the Akamai {OPEN} EdgeGrid Authentication specified by https://developer.akamai.com/introduction/Client\_Auth.html

482.5M6](/packages/akamai-open-edgegrid-client)[muhammadhuzaifa/telescope-guzzle-watcher

Telescope Guzzle Watcher provide a custom watcher for intercepting http requests made via guzzlehttp/guzzle php library. The package uses the on\_stats request option for extracting the request/response data. The watcher intercept and log the request into the Laravel Telescope HTTP Client Watcher.

98239.8k1](/packages/muhammadhuzaifa-telescope-guzzle-watcher)[ideasoft/http-batch-bundle

Http batch server implementation for symfony via sub requests.

2520.4k](/packages/ideasoft-http-batch-bundle)[ory/hydra-client-php

Documentation for all of Ory Hydra's APIs.

1710.8k](/packages/ory-hydra-client-php)

PHPackages © 2026

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