1.1.3 • Published 2 years ago

dialog-sms-service v1.1.3

Weekly downloads
9
License
MIT
Repository
github
Last release
2 years ago

Dialog SMS Service

npm.io

JavaScript library to send SMS through Dialog telecommunication service

This library will handle single or multiple SMS send feature with Dialog telecommunications service.

npm install dialog-sms-service

Usage

const smsGateway = require('dialog-sms-service');

(async () => {
  try {
    // set configuration
    await smsGateway.setConfig({
      digest: 'dialog_msg_digest_here',
      mask: 'dialog_msg_mask_here',
      user: 'dialog_msg_user_here',
      campaignName: 'dialog_msg_campaignName_here', //optional
    });

    //send message
    const result = await smsGateway.sendSMS('07XXXXXXXX', 'Dialog sms test');
    console.log(result);
  } catch (error) {
    console.log(error);
  }
})();

How to work

First needs to contact Dialog Axiata PLC to get credentials for the SMS gateway.

Note:- Please contact Dialog Axiata PLC in order to obtain following fields.

FieldDescription
UsernameUser name for the Dialog SMS gateway account.
PasswordPassword for the Dialog SMS gateway account.
maskText that appears as the sender of the SMS. Eg:- PIZZAHUT

set configurations for the SMS gateway

// set configuration
await smsGateway.setConfig({
  digest: 'dialog_msg_digest_here',
  mask: 'dialog_msg_mask_here',
  user: 'dialog_msg_user_here',
  campaignName: 'dialog_msg_campaignName_here', //optional
});
FieldDescription
userRequired. Username that will provided by Dialog.
maskRequired. A String. SMS sender ID.Mask value provided by Dialog. Eg:- test (For the test account)
digestRequired. md5 encripted values of password. {digest = md5(password provided by dialog)}
campaignNameOptional. Campaign name to be used in reporting.

Send SMS

await smsGateway.sendSMS(Phone Number ,Message);
FieldDescription
Phone NumberRequired. A String. Phone number/s which will need to receive SMS. the phone number needs to either start with 0 or 94 (do not use +94). If there are multiple receivers make sure to add them as comma (,) separated text. Eg :- '0771111111,0712222222'
MessageRequired. A String. The content of the SMS goes here.

Licence

(The MIT License) Copyright (c) 2021 kmkasunmadushanka@gmail.com