node-bandwidth-extras

Helper functions and middlewares for node-bandwidth. Read more documentation here.

Install

Run

npm install @bandwidth/node-bandwidth-extra

Examples

Helpers

const {application, phoneNumber} = require("@bandwidth/node-bandwidth-extra");

const appId = await application.getOrCreateApplication(api, 'My app', 'my.domain.com'); // It will return exisitng application Id or create it otherwise

const number = await phoneNumber.getOrCreatePhoneNumber(api, appId, {name: 'Support', areaCode: '910'}); // It will reserve a linked to this app phone number and assign name to it. If number with such name already exists it returns it.

Middlewares

Koa

const {middlewares} = require("@bandwidth/node-bandwidth-extra");

const app = new Koa();
app.use(middlewares.koa({
    name: 'My app', // application name on Bandwidth server
    auth: {userId: 'bandwidthUserId', apiToken: 'bandwidthApiToken', apiSecret: 'bandwidthSecret'}, // Bandwidth auth data
    phoneNumber: { // Options to reserve phone number
        phoneType: 'local',
        areaCode: '910'
    },
    callCallback: async (data, ctx) => {
        // Handle calls events here
        if(data.eventType === 'answer' && ctx.phoneNumber === data.to){
            console.log('Answered');
        }
    }
}));

app.use(async (ctx, next) => {
    console.log(ctx.phoneNumber); // calls and messages to this phone number will be handled by this web app
    await next();
});

Express

const {middlewares} = require("@bandwidth/node-bandwidth-extra");

const app = express();
app.use(middlewares.express({
    name: 'My app', // application name on Bandwidth server
    auth: {userId: 'bandwidthUserId', apiToken: 'bandwidthApiToken', apiSecret: 'bandwidthSecret'}, // Bandwidth auth data
    phoneNumber: { // Options to reserve phone number
        phoneType: 'local',
        areaCode: '910'
    },
    callCallback: async (data, req) => {
        // Handle calls events here
        if(data.eventType === 'answer' && req.phoneNumber === data.to){
            console.log('Answered');
        }
    }
}));

app.use((req, res, next) => {
    console.log(req.phoneNumber); // calls and messages to this phone number will be handled by this web app
    next();
});