PHPackages                             savannabits/advantasms - 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. savannabits/advantasms

ActiveLibrary[HTTP & Networking](/categories/http)

savannabits/advantasms
======================

PHP SDK for AdvantaSMS Gateway

v1.3.0(4y ago)243MITPHPPHP ^7.4|^8.0

Since Oct 5Pushed 4y ago1 watchersCompare

[ Source](https://github.com/savannabits/advantasms)[ Packagist](https://packagist.org/packages/savannabits/advantasms)[ Docs](https://github.com/savannabits/advantasms)[ RSS](/packages/savannabits-advantasms/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (5)Dependencies (1)Versions (6)Used By (0)

Very short description of the package
=====================================

[](#very-short-description-of-the-package)

[![Latest Version on Packagist](https://camo.githubusercontent.com/e4907bc601e86818d70a42ffbaa8fbcef4d4c889f2b7b6bd5e0b7b4139ebca54/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736176616e6e61626974732f616476616e7461736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/savannabits/advantasms)[![Build Status](https://camo.githubusercontent.com/86ce036d6ad53b547d7c44fda7d06514504d81cca76ca1a87d422deba1ee84c8/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f736176616e6e61626974732f616476616e7461736d732f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/savannabits/advantasms)[![Quality Score](https://camo.githubusercontent.com/c69c9fd52c5cf782fcfd2126492cb8dac25f5aeb455744f8f2b22e3b0a8d1f2c/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f736176616e6e61626974732f616476616e7461736d732e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/savannabits/advantasms)[![Total Downloads](https://camo.githubusercontent.com/a52ed238aa0f70df9db5153afc1310ed4ce776b8b146d212ee00bff8d0913838/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736176616e6e61626974732f616476616e7461736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/savannabits/advantasms)

The PHP SDK for the [AdvantaSMS BulkSMS API](https://advantasms.com/bulksms-api)

Requirements
------------

[](#requirements)

- PHP ^7.1
- PHP json extension
- PHP Curl extension

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

[](#installation)

You can install the package via composer:

```
composer require savannabits/advantasms
```

Usage
-----

[](#usage)

### Credentials

[](#credentials)

Ensure you have thhe following required credentials from AdvantaSMS:

- apiKey
- Partner ID (e.g 2030)
- Shortcode (e.g SAVBITS)

### Sending SMS

[](#sending-sms)

```
use \Savannabits\Advantasms\Advantasms;
$apiKey = "";
$partnerId = "";
$shortcode = "";
$mobile = "254xxxxxxxxx";
//instantiate
$sms = new Advantasms($apiKey,$partnerId,$shortcode);

//Send and receive response
$response = $sms->to($mobile)->message("Your message right here...")->send();

//Schedule sms to be sent at a specific time
$time = "2020-10-01 18:00"; // Y-m-d H:i
$response = $sms->to($mobile)->message("Your message right here")->schedule($time);
```

If you don't like instantiating class into variables, you can use the init static method instead:

```
use \Savannabits\Advantasms\Advantasms;
$apiKey = "";
$partnerId = "";
$shortcode = "";
$mobile = "254xxxxxxxxx";

//Send and receive response
$response = Advantasms::init($apiKey,$partnerId,$shortcode)->to($mobile)->message("Your message right here...")->send();

//Schedule sms to be sent at a specific time
$time = "2020-10-01 18:00"; // Y-m-d H:i
$response = Advantasms::init($apiKey,$partnerId,$shortcode)->to($mobile)->message("Your message right here...")->schedule($time);
```

### Sample responses

[](#sample-responses)

#### Error

[](#error)

```
{
  "success":false,
  "message":"Low credit units to send message, Current balance 0.00, Required 1",
  "payload":[
        {
          "response-code":1004,
          "response-description":"Low credit units to send message, Current balance 0.00, Required 1",
          "mobile":"0708467001"
        }
     ],
  "code":1004
}
```

#### Success

[](#success)

```
{
  "success":true,
  "message":"Success",
  "payload":[
        {
            "respose-code": 200,
            "response-description": "Success",
            "mobile": 254712345678,
            "messageid": 8290842,
            "networkid": "1"
        }
    ],
  "code":200
}
```

### 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.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Sam Maosa](https://github.com/savannabits)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 68.4% 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 ~70 days

Total

5

Last Release

1815d ago

PHP version history (2 changes)v1.0.0PHP ^7.1

v1.3.0PHP ^7.4|^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5610289?v=4)[Sam Maosa](/maintainers/coolsam726)[@coolsam726](https://github.com/coolsam726)

---

Top Contributors

[![smaosa](https://avatars.githubusercontent.com/u/275793777?v=4)](https://github.com/smaosa "smaosa (13 commits)")[![coolsam726](https://avatars.githubusercontent.com/u/5610289?v=4)](https://github.com/coolsam726 "coolsam726 (6 commits)")

---

Tags

advantasmsbulk-smslaravel-smsphp-smssavannabitssms-kenyasms-sdkphp-sdksavannabitsadvantasmsadvanta smslaravel advanta sms

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/savannabits-advantasms/health.svg)

```
[![Health](https://phpackages.com/badges/savannabits-advantasms/health.svg)](https://phpackages.com/packages/savannabits-advantasms)
```

###  Alternatives

[php-http/cache-plugin

PSR-6 Cache plugin for HTTPlug

25126.1M82](/packages/php-http-cache-plugin)[illuminate/http

The Illuminate Http package.

11937.9M6.8k](/packages/illuminate-http)[rdkafka/rdkafka

A PHP extension for Kafka

2.2k24.3k1](/packages/rdkafka-rdkafka)[httpsoft/http-message

Strict and fast implementation of PSR-7 and PSR-17

87965.9k114](/packages/httpsoft-http-message)[mezzio/mezzio-router

Router subcomponent for Mezzio

265.4M89](/packages/mezzio-mezzio-router)[volt-test/php-sdk

Volt Test PHP SDK - A performance testing tool for PHP Developers

5314.0k2](/packages/volt-test-php-sdk)

PHPackages © 2026

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