Package Exports

@adetoola/sms

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@adetoola/sms) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

SMS

SMS is a succinct and flexible way to add Nigerian SMS providers integration to nodejs apps.

Installation
Configuration
Usage
Contributing
Security
Credits
License

Installation

Getting started with SMS is quite easy, just install using your favourite package manager.

Using Yarn

 yarn add @adetoola/sms

Using NPM

 npm install @adetoola/sms

Available SMS Gateway

You can specify any of the supported sms gateway from the list below:

Test (Use as a test account)
SMS247Live
XWireless
50Kobo
SMSTube

import SMS from '@adetoola/SMS';

const sms = new SMS('SMSLive247');

SMS Gateway Credentials

Each SMS service provider will give authorised users a set of credentials to use when sending SMS or interacting with their services.

# Test
SMS_SENDER='YOUR_SENDER_NAME_HERE'

# SMS247Live
SMS_SENDER='YOUR_SENDER_NAME_HERE'
SMS_SESSION_ID='YOUR_SESSION_ID_HERE'

Usage

Using SMS is quite simple.

const sms = new SMS('SMSLive247');
sms.sender(sender).country(country).credentials(credentials);

const messageId = sms.send('08123456789', 'NG', 'Hi, I am using Adetoola SMS package');

console.log(messageId);

Methods

Method	SMS247LIVE
SMS::send(recipient, msg [, msg_type])	+
SMS::schedule(recipient, msg, datetime[, msg_type])	+
SMS::balance()	+
SMS::charge(msg_id)	+
SMS::status(msg_id)	+
SMS::coverage(recipient)	+
SMS::stop(msg_id)	+
SMS::history()	+

Valid Formats

Input	Description	Accepted Formats
`recipient`	Comma separated numbers, number or array	+2348012345678, 2348012345678, 8012345678, 0812345678
`country`	"Country" is a two-letter ISO country code (like NG)	[AZ]{2}
`msg`	Text message which will be sent to the numbers.	[a-zA-Z0-9+_-."'\s]{1,160}
`sender`	Number to display as sender	[a-zA-Z0-9_-]{1,11}
`msg_type`	Normal SMS, Flash or MMS	TEXT, FLASH, MMS
`datetime`	Datetime in format `Y-m-d H:i:s`.	2016-03-16 22:40:34
`msg_id`	Message ID, provider by gateway	[a-zA-Z0-9]

Example

#coming soon!

Change log

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email adetola.onasanya@gmail.com instead of using the issue tracker.

Credits

Adetola Onasanya

License

SMS is an open-sourced package licensed under the MIT license.

@adetoola/sms