SMS

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

Contents

• 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:

• [x] Test (Use as a test account)
• [x] 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 [email protected] instead of using the issue tracker.

Credits

• Adetola Onasanya

License

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