by BandwidthExamples


Bandwidth Call Tracking Node Example

Build StatusXO code style

A Call Tracking app for Bandwidth Voice and Messaging APIs.


Table of Contents

What this Example Does

Landing Page

The call tracking application lets you create trackable phone numbers for all your marketing needs. Create a new number by specifying the area code you'd like and the phone number you want the call to forward to.

Then for each incoming call you'll get a CNAM (caller id) lookup. As well as the duration of the state of any on-going calls.

This app will:


Accounts and Machine Setup

Env Variables

  • BANDWIDTH_USER_ID - Something like u-asdf
  • BANDWIDTH_API_TOKEN - Something like t-asf234
  • BANDWIDTH_API_SECRET - Something like asdf123asdf
  • DATABASE_URL - Connection path to MongoDB

Deploying Locally with ngrok

Ngrok is an awesome tool that lets you open up local ports to the internet.

Ngrok how

Once you have ngrok installed, open a new terminal tab and navigate to it's location on the file system and run:

./ngrok http 8080

You'll see the terminal show you information

ngrok terminal

Installing and running

Once ngrok is up and running. Open a new tab and clone the repo:

git clone
cd node-call-tracking


# Check first if mongodb is started and available
# Use DATABASE_URL to specify location of db collection if need

npm install # to install dependencies
npm start

Via Docker

# fill .env file with auth data first

# run the app (it will listen port 8080)
PORT=8080 docker-compose up -d

Open the app using the ngrok url

When the app runs for the first time, it setups the Bandwidth voice and messaging callbacks for the application for you. It sets the callback urls based on the url visited!

Copy the link and paste it into your browser.

On first run, the application will create the Bandwidth callbacks and voice/messaging application for you. Be sure you visit the ngrok url and not localhost. Bandwidth needs to be able to send callbacks.

Landing Page