Make a WebRTC-Enabled Call

👍

You're ready for this how-to guide if you've got the following:

A FreeClimb account
A registered application
A configured FreeClimb Number with a running application which will handle a request to the Voice URL. You can verify it is setup correctly by calling the number directly from your phone.

Your language and tools installed:

• pip (included by default)
• Python

Let’s run the example contained in this repository

Step 1: Create an environment file

Create the .env file from the .env.example with your FreeClimb details.

Step 2: Install dependencies

Install Python dependencies using the following command:

pip install -r requirements.txt

If using a Python virtual environment:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Step 3: Run the server

Run the following command:

FLASK_APP=main.py flask run --port 5001

🚧

This is a development server and is not for production use.

Step 4: Connect

1. Open a browser and head to http://localhost:5001/webrtc-calls. The options are comprised of applications in your FreeClimb account that are associated with a phone number.
2. Click on the desired application alias you wish to connect to.
3. And lastly, hangup (if desired).

You have completed the example WebRTC phone call! Continue reading to see how the demo application is configured.

SDK

The SDK, freeclimb-voice.js, provides primitives to interface with the JsSIP Library in a convenient fashion, supporting easy registration of callbacks and a simplified interface.

Example usage of the freeclimb-voice.js SDK:

var config = {
    'user': '< FROM USER >',
    'domain': '< DOMAIN for USERS >',
    'proxy': '< SIP Gateway (often the same as domain) >',
    'port': 443,
    'authorization_jwt': `Bearer < JWT >`,

    // optional hooks to customize functionality
    'call_failed': function () {}
    'call_connected': function () {}
    'call_disconnected': function () {}
    'call_ended': function () {}
    'incoming_call': function () {}
};

engine = new FreeClimbVoice();
engine.start(config);
engine.dial("+1234567890");

FreeClimb WebRTC Flow

Structure of Example Application

This repo contains several components used to generate necessary authentication credentials as well as host a simple website used for demonstrating a WebRTC call.