{"id":19356709,"url":"https://github.com/savannabits/advantasms","last_synced_at":"2025-10-07T01:22:06.860Z","repository":{"id":62540642,"uuid":"301413885","full_name":"savannabits/advantasms","owner":"savannabits","description":"PHP STK for AdvantaSMS Bulk SMS API, which is 100% compatible with the latest Laravel version as well.","archived":false,"fork":false,"pushed_at":"2021-07-13T04:48:03.000Z","size":31,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-06T17:49:56.658Z","etag":null,"topics":["advantasms","bulk-sms","laravel-sms","php-sms","savannabits","sms-kenya","sms-sdk"],"latest_commit_sha":null,"homepage":"https://savannabits.github.io/advantasms","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/savannabits.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-05T13:14:21.000Z","updated_at":"2023-01-07T16:43:59.000Z","dependencies_parsed_at":"2022-11-02T15:32:28.749Z","dependency_job_id":null,"html_url":"https://github.com/savannabits/advantasms","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savannabits%2Fadvantasms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savannabits%2Fadvantasms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savannabits%2Fadvantasms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savannabits%2Fadvantasms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/savannabits","download_url":"https://codeload.github.com/savannabits/advantasms/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240473143,"owners_count":19807094,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["advantasms","bulk-sms","laravel-sms","php-sms","savannabits","sms-kenya","sms-sdk"],"created_at":"2024-11-10T07:05:21.889Z","updated_at":"2025-10-07T01:22:06.741Z","avatar_url":"https://github.com/savannabits.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Very short description of the package\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/savannabits/advantasms.svg?style=flat-square)](https://packagist.org/packages/savannabits/advantasms)\n[![Build Status](https://img.shields.io/travis/savannabits/advantasms/master.svg?style=flat-square)](https://travis-ci.org/savannabits/advantasms)\n[![Quality Score](https://img.shields.io/scrutinizer/g/savannabits/advantasms.svg?style=flat-square)](https://scrutinizer-ci.com/g/savannabits/advantasms)\n[![Total Downloads](https://img.shields.io/packagist/dt/savannabits/advantasms.svg?style=flat-square)](https://packagist.org/packages/savannabits/advantasms)\n\nThe PHP SDK for the [AdvantaSMS BulkSMS API](https://advantasms.com/bulksms-api)\n## Requirements\n- PHP ^7.1\n- PHP json extension\n- PHP Curl extension\n\n## Installation\n\nYou can install the package via composer:\n\n```bash\ncomposer require savannabits/advantasms\n```\n\n## Usage\n### Credentials\nEnsure you have thhe following required credentials from AdvantaSMS:\n - apiKey\n - Partner ID (e.g 2030)\n - Shortcode (e.g SAVBITS)\n \n### Sending SMS\n```php\nuse \\Savannabits\\Advantasms\\Advantasms;\n$apiKey = \"\";\n$partnerId = \"\";\n$shortcode = \"\";\n$mobile = \"254xxxxxxxxx\";\n//instantiate\n$sms = new Advantasms($apiKey,$partnerId,$shortcode);\n\n//Send and receive response\n$response = $sms-\u003eto($mobile)-\u003emessage(\"Your message right here...\")-\u003esend();\n\n//Schedule sms to be sent at a specific time\n$time = \"2020-10-01 18:00\"; // Y-m-d H:i\n$response = $sms-\u003eto($mobile)-\u003emessage(\"Your message right here\")-\u003eschedule($time);\n```\n\nIf you don't like instantiating class into variables, you can use the init static method instead:\n```php\nuse \\Savannabits\\Advantasms\\Advantasms;\n$apiKey = \"\";\n$partnerId = \"\";\n$shortcode = \"\";\n$mobile = \"254xxxxxxxxx\";\n\n//Send and receive response\n$response = Advantasms::init($apiKey,$partnerId,$shortcode)-\u003eto($mobile)-\u003emessage(\"Your message right here...\")-\u003esend();\n\n//Schedule sms to be sent at a specific time\n$time = \"2020-10-01 18:00\"; // Y-m-d H:i\n$response = Advantasms::init($apiKey,$partnerId,$shortcode)-\u003eto($mobile)-\u003emessage(\"Your message right here...\")-\u003eschedule($time);\n```\n\n### Sample responses\n\n#### Error\n```json\n{\n  \"success\":false,\n  \"message\":\"Low credit units to send message, Current balance 0.00, Required 1\",\n  \"payload\":[\n        {\n          \"response-code\":1004,\n          \"response-description\":\"Low credit units to send message, Current balance 0.00, Required 1\",\n          \"mobile\":\"0708467001\"\n        }\n     ],\n  \"code\":1004\n}\n```\n#### Success\n```json\n{\n  \"success\":true,\n  \"message\":\"Success\",\n  \"payload\":[\n        {\n            \"respose-code\": 200,\n            \"response-description\": \"Success\",\n            \"mobile\": 254712345678,\n            \"messageid\": 8290842,\n            \"networkid\": \"1\"\n        }\n    ],\n  \"code\":200\n}\n```\n\n\n### Testing\n\n``` bash\ncomposer test\n```\n\n### Changelog\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.\n\n## Contributing\n\nPlease see [CONTRIBUTING](CONTRIBUTING.md) for details.\n\n### Security\n\nIf you discover any security related issues, please email maosa.sam@gmail.com instead of using the issue tracker.\n\n## Credits\n\n- [Sam Maosa](https://github.com/savannabits)\n- [All Contributors](../../contributors)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsavannabits%2Fadvantasms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsavannabits%2Fadvantasms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsavannabits%2Fadvantasms/lists"}