messagemedia-messages-sdk

MessageMedia Messages NodeJS SDK

The MessageMedia Messages API provides a number of endpoints for building powerful two-way messaging applications.

Installing via NPM

Now install messagemedia-messages-sdk via npm by using:

• npm install messagemedia-messages-sdk

Alternatively, add the following to the dependencies section of your package.json:

• "messagemedia-messages-sdk": "^1.0.0"

Get Started

It's easy to get started. Simply enter the API Key and secret you obtained from the MessageMedia Developers Portal into the code snippet below and a mobile number you wish to send to.

Send an SMS

• Destination numbers (destination_number) should be in the E.164 format. For example, [phone].

const sdk = require('messagemedia-messages-sdk');
const controller = sdk.MessagesController;


// Configuration parameters and credentials
sdk.Configuration.basicAuthUserName = "YOUR_API_KEY"; // Your API Key
sdk.Configuration.basicAuthPassword = "YOUR_SECRET_KEY"; // Your Secret Key


var body = new sdk.SendMessagesRequest({
   "messages":[
      {
         "content":"My first message",
         "destination_number":"YOUR_MOBILE_NUMBER",
      }
   ]
});

controller.createSendMessages(body, function(error, response, context) {
  console.log(response)
});

Get Status of a Message

You can get a messsage ID from a sent message by looking at the message_id from the response of the above example.

const sdk = require('messagemedia-messages-sdk');
const controller = sdk.MessagesController;


// Configuration parameters and credentials
sdk.Configuration.basicAuthUserName = "YOUR_API_KEY"; // Your API Key
sdk.Configuration.basicAuthPassword = "YOUR_SECRET_KEY"; // Your Secret Key


var messageId = "YOUR_MESSAGE_ID";

controller.getMessageStatus(messageId, function(error, response, context) {
  console.log(response)
});

Get replies to a message

You can check for replies that are sent to your messages

const sdk = require('messagemedia-messages-sdk');
const controller = sdk.RepliesController;


// Configuration parameters and credentials
sdk.Configuration.basicAuthUserName = "YOUR_API_KEY"; // Your API Key
sdk.Configuration.basicAuthPassword = "YOUR_API_SECRET"; // Your Secret Key


var messageId = "YOUR_MESSAGE_ID";

controller.getCheckReplies(function(error, response, context) {
  console.log(response)
});

Check Delivery Reports

This endpoint allows you to check for delivery reports to inbound and outbound messages.

const sdk = require('messagemedia-messages-sdk');
const controller = sdk.DeliveryReportsController;


// Configuration parameters and credentials
sdk.Configuration.basicAuthUserName = "YOUR_API_KEY"; // Your API Key
sdk.Configuration.basicAuthPassword = "YOUR_API_SECRET"; // Your Secret Key


controller.getCheckDeliveryReports(function(error, response, context) {
  console.log(response)
});

Documentation

The NodeJS SDK Documentation can be viewed here

Got Stuck?

Please contact developer support at [e-mail] or check out the developer portal at developers.messagemedia.com