telstra-messaging v1.0.0

Getting started

The offical Node.js SDK for the Telstra Messaging API!

The Telstra SMS Messaging API allows your applications to send and receive SMS text messages from Australia's leading network operator.

It also allows your application to track the delivery status of both sent and received SMS messages.

How to Build

The generated SDK relies on Node Package Manager (NPM) being available to resolve dependencies. If you don't already have NPM installed, please go ahead and follow instructions to install NPM from here. The SDK also requires Node to be installed. If Node isn't already installed, please install it from here

NPM is installed by default when Node is installed

To check if node and npm have been successfully installed, write the following commands in command prompt:

• node --version
• npm -version

Now use npm to resolve all dependencies by running the following command in the root directory (of the SDK folder):

npm install

This will install all dependencies in the node_modules folder.

Once dependencies are resolved, you will need to move the folder TelstraMessagingAPILib in to your node_modules folder.

Initialization

Example

In this example, app.js will check if the access token has been set in the SDK. If it has been, API calls can be made. Otherwise, client has to be authorized first before making API calls.
This example makes use of node-localstorage for handling data persistence.

app.js

const express = require('express');
const app = express();

const PORT = 1800;

const lib = require('lib');
const oAuthManager = lib.OAuthManager;
const LocalStorage = require('node-localstorage').LocalStorage;
const localStorage = new LocalStorage('./scratch');

lib.Configuration.oAuthClientId = 'oAuthClientId'; // OAuth 2 Client ID
lib.Configuration.oAuthClientSecret = 'oAuthClientSecret'; // OAuth 2 Client Secret

const storedToken = localStorage.getItem('token');
if (storedToken !== null && storedToken !== undefined) {
    lib.Configuration.oAuthToken = storedToken;
}
lib.Configuration.oAuthTokenUpdateCallback = function(token) {
    // token is the updated access_token
    localStorage.setItem('token', token);
};

app.listen(PORT, () => {
    console.log('Listening on port ' + PORT);
});

app.get('/', (req, res) => {
    if (oAuthManager.isTokenSet()) {
        // token is already stored in the client
        // make API calls as required
    } else {
        const scopes = [lib.OAuthScopeEnum.NSMS];
        const promise = oAuthManager.authorize(scopes);
        promise.then((success) => {
            // client authorized. API calls can be made
        }, (exception) => {
            // error occurred, exception will be of type lib/Exceptions/OAuthProviderException
        });
    }
});

See the documentation at Dev.Telstra.com for more information

Class Reference

List of Controllers

• ProvisioningController
• MessagingController

ProvisioningController

Get singleton instance

The singleton instance of the ProvisioningController class can be accessed from the API Client.

var controller = lib.ProvisioningController;

deleteSubscription

Delete Subscription

Example Usage

    controller.deleteSubscription(function(error, response, context) {

    
    });

See the documentation at Dev.Telstra.com for more information

Errors

createSubscription

Create Subscription

Parameters

Example Usage

    var body = new ProvisionNumberRequest({"key":"value"});

    controller.createSubscription(body, function(error, response, context) {

    
    });

See the documentation at Dev.Telstra.com for more information

Errors

getSubscription

Get Subscription

Example Usage

    controller.getSubscription(function(error, response, context) {

    
    });

See the documentation at Dev.Telstra.com for more information

Errors

Back to List of Controllers

MessagingController

Get singleton instance

The singleton instance of the MessagingController class can be accessed from the API Client.

var controller = lib.MessagingController;

createSendSMS

Send SMS

Parameters

The recipient number should be in the format '04xxxxxxxx' where x is a digit |

Example Usage

    var payload = new SendSMSRequest({"key":"value"});

    controller.createSendSMS(payload, function(error, response, context) {

    
    });

See the documentation at Dev.Telstra.com for more information

Errors

getSMSStatus

Get SMS Status

Parameters

Example Usage

    var messageId = 'messageId';

    controller.getSMSStatus(messageId, function(error, response, context) {

    
    });

See the documentation at Dev.Telstra.com for more information

Errors

createSendMMS

Send MMS

Parameters

and MMS message.The recipient number should be in the format '04xxxxxxxx' where x is a digit |

Example Usage

    var body = new SendMMSRequest({"key":"value"});

    controller.createSendMMS(body, function(error, response, context) {

    
    });

See the documentation at Dev.Telstra.com for more information

Errors

getMMSStatus

Get MMS Status

Parameters

Example Usage

    var messageid = 'messageid';

    controller.getMMSStatus(messageid, function(error, response, context) {

    
    });

See the documentation at Dev.Telstra.com for more information

Errors

retrieveSMSResponses

Retrieve SMS Responses

Example Usage

    controller.retrieveSMSResponses(function(error, response, context) {

    
    });

See the documentation at Dev.Telstra.com for more information

Errors

Back to List of Controllers