Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A Node.js module for interaction with the SMSified API.
JavaScript
tree: 0c20c9fb27

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples
lib
.gitignore
.npmignore
LICENSE.txt
README.md
package.json

README.md

Node.js Module for the SMSified API

A Node.js module for interaction with the SMSified API.

SMSified API Overview

SMSified is a simple REST SMS API, built to uniquely enable developers to create powerful SMS services with minimum effort. Through SMSified, developers can both send and receive SMS messages, as well as track usage and message history through a powerful reporting dashboard. You can use either standard phone numbers or short codes, and best of all, SMSified is backed by Voxeo - the world's largest real-time application cloud.

When you sign up, you automatically receive $20 in credit and one free phone number; this allows you to both receive and send free SMS messages while testing. When the credit runs out, just add a credit card for billing and you're live - but you get to keep the phone number for free! Check out our pricing page for more information.

More info here: SMSified API Docs

Installation

npm install smsified

Usage Examples

The following simple example will send an outbound SMS message from (407) 554-1234 to (518) 476-1234 and write out the JSON response from SMSified to the console:

var sys = require('sys');
var smsified = require('smsified');

var sms = new SMSified('username', 'password');
var options = {senderAddress: '4075541234', address: '15184761234', message: 'Hello world from Node.js'};
sms.sendMessage(options, function(result) {
    sys.puts(sys.inspect(result));
});

Send an outbound SMS message and set a callback URL:

var sms = new SMSified('username', 'password');
var options = {senderAddress: '4075541234', address: '15184761234', message: 'Hello from Node.js with another callback', notifyURL: 'http://path-to-somewhere/'};
sms.sendMessage(options, function(result) {
    sys.puts(sys.inspect(result));
});

Check the status of an SMS message:

var sms = new SMSified('username', 'password');
sms.checkStatus('4075541234', '43d2f75b2bda27006200003e9b7dcf3b', function(result) {
    sys.puts(sys.inspect(result.deliveryInfoList.deliveryInfo));
});

Create a subscription for an account phone number:

var sms = new SMSified('username', 'password');
sms.createSubscription('4075541234', 'outbound', 'http://path-to-somewhere', function(result) {
    sys.puts(sys.inspect(result));
});

View all active subscriptions:

var sms = new SMSified('username', 'password');
sms.viewSubscriptions('4075541234', 'outbound', function(result) {
    sys.puts('Number of subscriptions: ' + result.outboundSubscriptionList.numberOfSubscriptions);
    sys.puts(sys.inspect(result.outboundSubscriptionList.outboundSubscription));
});

Delete a subscription:

var sms = new SMSified('username', 'password');
sms.deleteSubscriptions('6267217aae394b5dc656ba4216082304', 'outbound', function(result) {
    if(result = '204') {
        sys.puts('Subscription delted.');
    }
    else {
        sys.puts('Could not delete subscription.');
    }   
});

Retrieve delivery information on a message:

var sms = new SMSified('username', 'password');
sms.getMessages('02b45e3072ae5e157a12d0408bcede65', null, function(result) {
    sys.puts(sys.inspect(result));
});

Retrieve delivery information on a set of messages, using filters to specify messages:

var sms = new SMSified('username', 'password');
sms.getMessages(null, {status: 'success', direction: 'in'}, function(result) {
    sys.puts(sys.inspect(result));
});
Something went wrong with that request. Please try again.