nimbow-client

Nimbow node.js Client

This is the official node.js client for the Nimbow API (http://www.nimbow.com).

You find the complete API documentation here: https://www.nimbow.com/sms-api/nimbow-api/

NPM-Package: https://www.npmjs.com/package/nimbow-client

Install

npm install nimbow-client

Usage

Simple SMS sending

var apiKey = "YOUR-API-KEY";
var protocol = "https"; // or http
var testMode = false; // optional; set to true if you want to send a test messages (no delivery, no cost, but visible in your portal)

require("nimbow-client")
	.create(apiKey, protocol, testMode)
	.sendTextMessage("Sender", "491771234567", "Hello World!");

Send flash SMS

var apiKey = "YOUR-API-KEY";
var protocol = "https"; // or http

require("nimbow-client")
	.create(apiKey, protocol)
	.sendTextMessage("Sender", "491771234567", "Hello World!", {Flash: true});

Set a client reference

var apiKey = "YOUR-API-KEY";
var protocol = "https"; // or http

require("nimbow-client")
	.create(apiKey, protocol)
	.sendTextMessage("Sender", "491771234567", "Hello World!", {ClientRef: "My Campaign"});
	
// in your Nimbow portal you can configure a DeliveryReport Callback URL; this will receive the ClientRef from above...

Unicode SMS sending

var apiKey = "YOUR-API-KEY";
var protocol = "https"; // or http

require("nimbow-client")
	.create(apiKey, protocol)
	.sendUnicodeTextMessage("Sender", "491771234567", "привет");

Inspect response

var apiKey = "YOUR-API-KEY";
var protocol = "https"; // or http

require("nimbow-client")
	.create(apiKey, protocol)
	.sendTextMessage(
		"Sender",
		"491771234567", 
		"Hello World!",
		{GetMessageId: true},
		function(error, apiResponse) {
			console.log("StatusCode: " + apiResponse.StatusCode + " MessageId: " + apiResponse.MessageId)
		}
	);