In this tutorial, we will set up a new switch. When we are finished, we will be able to:

  1. Register a SIP phone with our switch
  2. Make a call from our SIP phone, to a phone number
  3. View the CDRs from the perspective of the end user, and vendor CDRs from the perspective of the Swicth administrator

In this tutorial, we will configure our switch for the imaginary company 'Call Integrale', We also will use an imaginary vendor called 'Lancia Tele'. These imaginary company are useful when explaining the various concepts and roles of the different parties involved in a call.


To successfully complete this tutorial, we assume you have the following:

  • A SIP termination provider that you can terminate voice calls to
  • A SIP phone

Step 1. Setting up Vendors

The first step will be to create a new Vendor, and Vendor Connection. In our example, we are using the fake company for termination. They have provided us with a SIP gateway called

Creating our first Vendor

  1. Navigate to the Vendors screen by clicking on 'Vendors' in the left hand navigation menu.
  2. Click the 'Add' button.

  1. On the 'Add New Vendor' screen, 
    1. Enter the name of your Vendor into the Vendor Name field.
    2. The Web Login and Web Password fields will automatically be filled in. This optionally allows your vendors to log into your system to see CDRs related to their connections
    3. Set the Base Currency, this should be the currency in which you do business with your Vendor. We will use USD in this tutorial.
    4. Set the Time Zone to the same Time Zone that your vendor bills you in. This will make future reporting and reconciliation with your vendor easier.
    5. The Balance field is used to track your balance with your Vendor. For example, you can leave this at zero, and as you terminate calls, the balance will go negative.
    6. Click Save & Close

The Add New Vendor Screen

Creating Vendor Connections

The next step is to create a Connection under your newly created Vendor record. It is common for a vendor to have multiple connections, but in this guide we will only create one.

  1. On the Vendors screen, click the 'Open Connections' action link for the newly created Vendor.

  1. On the Connections screen, click the Add button

  1. On the Add New Connections screen
    1. Give your connection a meaningful name using the Connection Name field.
    2. Select the protocol of your connection using the Protocol pick-list. We will be using SIP in this guide.
    3. Set the hostname or IP address of your Vendors gateway connection. 
    4. If your vendor requires digest authentication, then fill in the credentials from your vendor using the Username and Password fields. If you do not use digest authentication, then leave these fields blank. Click here for more information on Authentication
    5. Optionally, if you need to add or remove prefixes for your traffic for this connection you can do so in the Number Translation section on this screen. Click here to learn more about Number Translation.
    6. Click the Save & Close button.