@adetoola/sms NPM

SMS

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

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