Table of Contents

Telephony: Quick Start

This is a quick start guide intended to help configuring Comms Mundi™ Telephony for the first time. For advanced configurations, please refer to the reference manual, or ask us at support@wirelessmundi.com.

Call flow

A new call can be generated from an account, from a TDM or VoIP line or directly from an internal application. The call flow is the following:

Directory

The directory is the place where you can add, modify or delete domains, accounts and groups. Domains help you organize accounts and groups under a single logical structure, facilitating the configuration when sharing Comms Mundi™ between multiple companies or departments. An account is the combination of a SIP endpoint, Voice mailbox, FAX mailbox and Recording mailbox under a single name, any of which can be enabled.

This guide will help configuring two SIP accounts under a single domain.

Modifying the domain

The default domain is named commsmundi.com, it should be changed to one that representing the company or department owning the accounts.

To change a domain go to the page Directory → Domain:

  1. Click in the domain name, commsmundi.com
  2. In the page, Domain: commsmundi.com, change the Name to one representing your structure (ex: mycompany.org).
  3. Click Modify

Adding accounts

No accounts are defined in the default installation. In order to connect SIP phones, a couple of accounts will be created.

To add a new account go to the page Directory → Domain:

  1. In the accounts table (where the configured accounts are listed), click Add
  2. Set the value for the userid, for example, 300
  3. Click in the upper tab, Endpoint
  4. Select SIP endpoint
  5. At the section, SIP Account, set the Password value, for example, 3o0passwd
  6. Click Add

Repeat the above steps to add another account, for example the account 301.

Lines

The line section is where you can configure all your TDM and VoIP lines. If you have TDM cards plugged in your server the ports will be added automatically then you have to configure the TDM parameters for the correspondent technology (analog, ISDN,… ). For VoIP (SIP) lines you need to add them.

Add the VoIP SIP line

To add a SIP line go to the page Telephony → Lines:

  1. In the lines table (where the configured lines are listed), click Add
  2. Set the value for the name, for example, operator1
  3. Set the value for the context, for example, incoming
  4. For the gateway parameters, choose:
    • Account
    • Select you Local IP, is the ip address from where you will connect to the operator, for example, 10.10.1.1
    • Domain : port, the operator domain or ip address and SIP port, for example, your.operator.sip.ip.address.com 5060
    • User ID, for example, your operator username
    • Password, for example, your operator passwor
    • option: if you need to register against you operator check Register option, and set your extension, normally the same as you username.
  5. For the parameters parameters, choose:
    • check Template, and then default sip line
  6. Click Add

Dialplan

The dialplan is the section where call handling is defined. Multiple dialplans called contexts can be configured, each containing ordered rules to be followed when an incoming call is received by the softswitch. Those contexts are assigned to lines and endpoints (configured in domains or accounts), allowing you to define which rules are to be executed by calls received by different devices or lines (local phones, public network, …).

Two contexts are defined by default: the incoming context can be assigned to lines, applying to calls coming from the outside world, and the outgoing context, assigned to the default domain and defining rules for calls coming from local endpoints.

Modifying the outgoing context

In order to enable calls between the two accounts previously created, a new rule will be created in the outgoing context. This rule will run a bridge action on incoming calls if the destination is one of the configured account in the previously configured domain.

To add the rule, go to the page Telephony → Dialplan:

  1. Select the outgoing context by clicking in the folder icon, near its name on the contexts table.
  2. In the extensions table (Context 'outgoing': Extensions), click Add
  3. Set the Name parameter, for example local calls
  4. Set the Priority parameter, first
  5. For the Conditions parameters, choose:
    • Custom
    • Check Destination number, select Local and choose the previously configured domain
  6. For the actions parameters, choose:
    • Custom
    • Bridge Local
    • Type: select Account
    • Destination: set the Domain to the previously configured domain, set the Number to ${destination_number}
  7. Click Add

Modifying the incoming context

All the incoming calls from the line will go to the incoming context. In order to received the call directly to one account previously created, a new rule will be created in the incoming context. This rule will run a bridge action placing the call into the account selected, in this example will be the account 300.

To add the rule, go to the page Telephony → Dialplan:

  1. Select the incoming context by clicking in the folder icon, near its name on the contexts table.
  2. In the extensions table (Context 'incoming': Extensions), click Add
  3. Set the Name parameter, for example reception
  4. Set the Priority parameter, first
  5. For the Conditions parameters, choose:
    • Any
  6. For the actions parameters, choose:
    • Custom
    • Bridge Local
    • Type: select Account
    • Destination: set the Domain to the previously configured domain, set the Number to 300
  7. Click Add