cecula
Version:
NodeJS library for sending A2P and P2P SMS over the Cecula API
180 lines (164 loc) • 6.39 kB
Markdown
A NodeJS package for Cecula.
[](https://nodei.co/npm/cecula/)
[](https://travis-ci.org/cecula-sms/node-library)
[](https://www.codacy.com/app/godwin-noah/node-library?utm_source=github.com&utm_medium=referral&utm_content=cecula-sms/node-library&utm_campaign=Badge_Grade)
[](https://codecov.io/gh/cecula-sms/node-library)
[](https://snyk.io/test/github/cecula-sms/node-library)
1. [Introduction](
2. [How to use the library](
3. [Installation](
4. [How to generate an API Key](
5. [Importing cecula Library](
6. [Sending A2P SMS](
7. [Sending P2P SMS](
8. [Checking A2P SMS Balance](
9. [Checking Sync Cloud Balance](
10. [Error Responses](
Cecula SMS Library enables you to quickly integrate and send A2P and P2P Messages from your application.
* Install Cecula SMS from npm or yarn following the instructions in the Installation section or clone from GitHub
* Login to the <a href="https://developer.cecula.com" target="_blank">Cecula Developers Platform</a> register your app and generate an API KEY
* Import/Require the library into your script
Install with NPM:
```sh
npm i cecula
```
Install with Yarn:
```sh
yarn add cecula
```
Clone from GitHub
```sh
git clone https://github.com/cecula-sms/nodejs-library.git
```
Your API Key is first generated when you register an app. To register an app,
<a href="https://developer.cecula.com" target="_blank">Login to the Developers Dashboard</a>, __Navigate to Apps > Add__, Type the name of your app and click *Submit*. The app will be registered and a new API Key will be generated. Copy the API key into your project
If you installed the library using npm or yarn, import the library into your script using the code below
```sh
const cecula = require("cecula");
cecula.apiKey = "<API_KEY>"
```
Otherwise, if you cloned the library from GitHub, import the library into your script using the code below
```sh
const cecula = require("./path/to/cecula");
cecula.apiKey = "<API_KEY>"
```
To send SMS with alphanumeric identity to single or multiple contacts, use the code below:
```sh
const messageData = {
"origin": "LAB",
"message": "It's a good day to be alive. What are you working on?",
"recipients": [
"234809xxxxxxx"
]
}
cecula.sendA2PSMS(messageData, response => {
console.log(response)
})
```
Your response should look like this:
```sh
{
"status": "sent",
"reference": "4982953",
"sentTo": [ "234809xxxxxxx" ],
"invalid": [],
"declined": [],
"declineReason": "234809xxxxxxx",
"code": "1801"
}
```
To send a message using numberic identity, use the code below:
```sh
const messageData = {
"origin": "2348050209037",
"flash": false,
"message": "Testing the power of many",
"recipients": [
"2349090000246",
"2349090000271"
]
};
cecula.sendP2PSMS(messageData, reponse => {
console.log(response);
});
```
Your response should look like this:
```sh
{
"status": "sent",
"code": "1801",
"messageID": "2579",
"sentTo":[
{
"recipient": "2349090000246",
"id": "5990"
},
{
"recipient": "2349090000271",
"id": "5991"
}
],
"declined": []
}
```
To get your A2P SMS Balance, __getA2PBalance__ method is used this way:
```sh
cecula.getA2PBalance(balance => {
console.log(balance)
})
```
You should get a response like this:
```sh
{
"balance": 234.1
}
```
To get your Sync Cloud Balance, __getSyncCloudBalance__ method is used this way:
This method requires no parameter:
```sh
cecula.getSyncCloudBalance(balance=>{
console.log(balance)
})
```
You should get a response like this
```sh
{
"balance": 9513
}
```
In a case where the request fails due to one reason or another you should get an error response from the requested endpoint that looks like this:
```sh
{
"error": "Message cannot be longer than 10 pages",
"code": "CE1005"
}
```
The table below shows a list of error codes and their descriptions:
| Error Code | Description |
|:----------:| :------------------------------------------------------------|
| CE1001 | Missing Fields |
| CE1002 | Empty Fields |
| CE1003 | Origin cannot be longer than 11 characters |
| CE1004 | A2P Message origin must be alphabets only or alphanumeric |
| CE1005 | Message cannot be longer than 10 pages |
| CE1007 | Cannot find the identity on Sync Cloud |
| CE1008 | Origin is pending verification |
| CE1009 | Account Unbound. Please Recharge Account and Contact Sales |
| CE1010 | Numeric Originator must be between 5 - 16 digits long |
| CE1011 | P2P Message originator must be numeric |
| CE1012 | Origin is not registered |
| CE1013 | Sync App is Offline. Please check device |
| CE1014 | Invalid values on returned properties |
| CE1802 | No Valid Recipient |