Bandwidth.com

From Taridium

(Difference between revisions)
Jump to: navigation, search
 
(26 intermediate revisions not shown)
Line 7: Line 7:
===Completely installed ipbx System===
===Completely installed ipbx System===
-
If you have obtained your ipbx system directly from Taridium and have a valid maintenance or managed VoIP service contract, you can ask Taridium to perform this configuration for you. In order for you to configure your trunk you should have your phones, IVRs, call groups, queues etc. already setup. See [[Installing_ipbx|Installing ipbx]] and Initial_Configuration|Initial Configuration]].
+
If you have obtained your ipbx system directly from Taridium and have a valid maintenance or managed VoIP service contract, you can ask Taridium to perform this configuration for you. In order for you to configure your trunk you should have your phones, IVRs, call groups, queues etc. already setup. See [[Installing_ipbx|Installing ipbx]] and [[Initial_Configuration|Initial Configuration]].
===Version Check===
===Version Check===
-
[[Image:warning.gif]] Bandwidth.com trunks require ipbx v. 2.0.1 or higher for proper operation.
+
[[Image:warning.gif]] Bandwidth.com trunks require ipbx v. 2.0.1 or higher for proper operation. Click on '''Diagnostics''' → '''About''' to check your version. Check the [[Upgrading|Upgrade Instructions]] to upgrade your version of ipbx.
===SIP trunking information provided by Bandwidth.com===
===SIP trunking information provided by Bandwidth.com===
Line 30: Line 30:
Enter the following details:
Enter the following details:
-
# '''Trunk Name''' → bandwidth-1
+
# '''Trunk Name''' → bandwidth1
# '''Type''' → friend
# '''Type''' → friend
# '''Host''' → 216.82.225.202
# '''Host''' → 216.82.225.202
 +
 +
:{|
 +
|! style="background:#efefef; width: 650px; padding: 5px;" |[[Image:warning.gif]] If the Taridium ipbx is sitting behind a Bandwidth.com approved [[wikipedia:Application-level_gateway|ALG]] or Bandwidth.com's BoxSet bundles, it will need to point to the '''LAN side''' of the ALG and not directly to the Bandwidth.com Proxy Address.
 +
|}
 +
# '''Context''' → incoming (default)
# '''Context''' → incoming (default)
# '''Can Re-Invite''' → no
# '''Can Re-Invite''' → no
Line 52: Line 57:
_+ZXXXXXX. This will accept any numbers that match the [[wikipedia:E.164|E.164]] pattern and send them to bandwidth.com
_+ZXXXXXX. This will accept any numbers that match the [[wikipedia:E.164|E.164]] pattern and send them to bandwidth.com
 +
 +
or
 +
 +
_+1NXXXXXX. This will accept any North American numbers that match the [[wikipedia:E.164|E.164]] pattern and send them to bandwidth.com
 +
 +
See also [[Routes#Pattern_Matching|Route Pattern Matching]] for Syntax and special characters.
[[Image:bw-outbound.gif]]
[[Image:bw-outbound.gif]]
 +
 +
You might also want to add 911 and 411 dialing. Simply add the number as is: '''Destination''' → 911 and select the bandwidth.com trunk etc.
== Transformation Configuration ==
== Transformation Configuration ==
-
Since bandwidth.com requires numbers to be dialed as fully qualified [[wikipedia:E.164|E.164]] numbers you will need to add number transformations before sending your calls out.
+
Since bandwidth.com requires numbers to be dialed as fully qualified [[wikipedia:E.164|E.164]] numbers you will need to add number transformations before sending your calls out. Otherwise you would have to dial numbers as bandwidth.com expects them, something most phones will not support due to the lack of the '''+''' sign. The examples below show how to add transformations that allow you to dial numbers as usual.
Click on '''Configuration''' →  '''Routing''' →  '''Transformations'''
Click on '''Configuration''' →  '''Routing''' →  '''Transformations'''
 +
 +
=== Long Distance/Domestic Dialing ===
Add a new rule of type '''before outbound routing''' with Pattern _1NXXNXXXXXX and Output +${EXTEN} - This rule will transform any North American numbers to E.164.
Add a new rule of type '''before outbound routing''' with Pattern _1NXXNXXXXXX and Output +${EXTEN} - This rule will transform any North American numbers to E.164.
 +
 +
=== International Dialing ===
Add a new rule of type '''before outbound routing''' with Pattern _011ZXXXXX. and Output +${EXTEN:3} - This rule will transform any international prefix numbers to an E.164 pattern.
Add a new rule of type '''before outbound routing''' with Pattern _011ZXXXXX. and Output +${EXTEN:3} - This rule will transform any international prefix numbers to an E.164 pattern.
 +
 +
=== Local Dialing ===
 +
 +
Further transformations could for example, allow you to dial 7 digit numbers within a preset area code:
 +
Add a new rule of type '''before outbound routing''' with Pattern _NXXXXXX and Output +1212${EXTEN} - This rule will transform any 7 digit numbers to an E.164 pattern within the 212 area code prefixed. Note that this will only work with a single area code, there is no way ipbx can know about which calls are local and which not.
[[Image:bw-transform.gif]]
[[Image:bw-transform.gif]]
-
If desired you can also add inbound transformations '''before inbound routing''' which for example could strip the '''+''' sign for further matching in your inbound routes.
+
If desired you can also add inbound transformations '''before inbound routing''' which for example could strip the '''+''' sign for further matching in your inbound routes. Make sure you add your DIDs to the inbound routes first, though. See below.
== DID Configuration ==
== DID Configuration ==
Line 77: Line 99:
[[Image:bw-inbound.gif]]
[[Image:bw-inbound.gif]]
-
Enter your DIDs as specified by bandwidth.com e.g. +12125552200 and select a local destination for your DID.
+
Enter your DIDs as specified by bandwidth.com e.g. +12125552200 and select a local destination for your DID. It is important that you include the '''+''' sign and '''1'''.
 +
See also [[Routes#Pattern_Matching|Route Pattern Matching]] for Syntax and special characters.
== Testing ==
== Testing ==
Line 90: Line 113:
'''Test Plans'''
'''Test Plans'''
-
 
-
If you run into an issue with any of these tests, consult the troubleshooting chart bellow:
 
# Test an Outbound call to a Local Number. Check for Ringback, 2-way Audio, and Quality.
# Test an Outbound call to a Local Number. Check for Ringback, 2-way Audio, and Quality.
Line 100: Line 121:
# Test an Outbound Call to Operator '''0'''
# Test an Outbound Call to Operator '''0'''
# Test an Outbound Call to Directory Assistance '''411'''
# Test an Outbound Call to Directory Assistance '''411'''
-
# Test a 911 Call ([[Image:warning.gif]] PLEASE IDENTIFY TO THE OPERATOR THAT THIS IS A TEST!)
+
# Test a 911 Call [[Image:warning.gif]] ''LET THE OPERATOR KNOW IMMEDIATELY THAT THIS IS A NON-EMERGENCY TEST CALL!''
-
# Test an Inbound call to one of your DIDs. Check for Ringback, 2-way Audio, and Quality.
+
# Test an Inbound call to one of your DIDs. Check for Ringback tone, 2-way Audio, and Quality.
# Test an Inbound call to an IVR. Check [[wikipedia:DTMF|DTMF]] and Audio Quality.
# Test an Inbound call to an IVR. Check [[wikipedia:DTMF|DTMF]] and Audio Quality.
# Test Transferring calls off-site.
# Test Transferring calls off-site.
# Test an Outbound call to an Auto-Attendant and verify [[wikipedia:DTMF|DTMF]].
# Test an Outbound call to an Auto-Attendant and verify [[wikipedia:DTMF|DTMF]].

Latest revision as of 15:53, 6 August 2010

Bandwidth.gif

This page describes how to configure your Taridium ipbx system with Bandwidth.com SIP Trunking Service.

Contents

Prerequisites

Completely installed ipbx System

If you have obtained your ipbx system directly from Taridium and have a valid maintenance or managed VoIP service contract, you can ask Taridium to perform this configuration for you. In order for you to configure your trunk you should have your phones, IVRs, call groups, queues etc. already setup. See Installing ipbx and Initial Configuration.

Version Check

Warning.gif Bandwidth.com trunks require ipbx v. 2.0.1 or higher for proper operation. Click on DiagnosticsAbout to check your version. Check the Upgrade Instructions to upgrade your version of ipbx.

SIP trunking information provided by Bandwidth.com

Trunk Configuration

Navigate and login to the ipbx administrator interface (you will need admin class permissions). E.g.

http://[ip address of your pbx]/ipbx/

Click on ConfigurationVoIP Trunksadd SIP Trunk

Enter the following details:

  1. Trunk Name → bandwidth1
  2. Type → friend
  3. Host → 216.82.225.202
Warning.gif If the Taridium ipbx is sitting behind a Bandwidth.com approved ALG or Bandwidth.com's BoxSet bundles, it will need to point to the LAN side of the ALG and not directly to the Bandwidth.com Proxy Address.
  1. Context → incoming (default)
  2. Can Re-Invite → no
  3. Insecure → very
  4. Disallow → all (enter or select all)
  5. Allow → ulaw (enter or select ulaw)

Leave all other configuration details as per default.

Bw-trunk.gif

Click on add trunk to add your trunk to the configuration.

Click on ConfigurationRoutingOutbound Routing

Enter your destination patterns and select the newly created SIP/bandwidth-1 trunk to terminate your calls.

Examples destination pattern:

_+ZXXXXXX. This will accept any numbers that match the E.164 pattern and send them to bandwidth.com

or

_+1NXXXXXX. This will accept any North American numbers that match the E.164 pattern and send them to bandwidth.com

See also Route Pattern Matching for Syntax and special characters.

Bw-outbound.gif

You might also want to add 911 and 411 dialing. Simply add the number as is: Destination → 911 and select the bandwidth.com trunk etc.

Transformation Configuration

Since bandwidth.com requires numbers to be dialed as fully qualified E.164 numbers you will need to add number transformations before sending your calls out. Otherwise you would have to dial numbers as bandwidth.com expects them, something most phones will not support due to the lack of the + sign. The examples below show how to add transformations that allow you to dial numbers as usual.

Click on ConfigurationRoutingTransformations

Long Distance/Domestic Dialing

Add a new rule of type before outbound routing with Pattern _1NXXNXXXXXX and Output +${EXTEN} - This rule will transform any North American numbers to E.164.

International Dialing

Add a new rule of type before outbound routing with Pattern _011ZXXXXX. and Output +${EXTEN:3} - This rule will transform any international prefix numbers to an E.164 pattern.

Local Dialing

Further transformations could for example, allow you to dial 7 digit numbers within a preset area code: Add a new rule of type before outbound routing with Pattern _NXXXXXX and Output +1212${EXTEN} - This rule will transform any 7 digit numbers to an E.164 pattern within the 212 area code prefixed. Note that this will only work with a single area code, there is no way ipbx can know about which calls are local and which not.

Bw-transform.gif

If desired you can also add inbound transformations before inbound routing which for example could strip the + sign for further matching in your inbound routes. Make sure you add your DIDs to the inbound routes first, though. See below.

DID Configuration

In order for ipbx to know about your DIDs, you will have to add inbound routes:

Click on ConfigurationRoutingInbound Routing

Bw-inbound.gif

Enter your DIDs as specified by bandwidth.com e.g. +12125552200 and select a local destination for your DID. It is important that you include the + sign and 1. See also Route Pattern Matching for Syntax and special characters.

Testing

Remember that Bandwidth.com wants to see a + and a 1 on all outgoing calls, so this must be planned for in the Trunk and Outbound Routing and Transformations. Also, we will be sending you a + and a 1 on every call, so make sure to plan for this when setting up your ipbx system.

Test Plans

  1. Test an Outbound call to a Local Number. Check for Ringback, 2-way Audio, and Quality.
  2. Test an Outbound call to a Long Distance Number. Check for Ringback, 2-way Audio, and Quality.
  3. Test an Outbound call to an International Number. Check for Ringback, 2-way Audio, and Quality.
  4. Test a Long Outbound call past 15 minutes.
  5. Test multiple call concurrencies on Outbound calls. Setup multiple calls to PSTN
  6. Test an Outbound Call to Operator 0
  7. Test an Outbound Call to Directory Assistance 411
  8. Test a 911 Call Warning.gif LET THE OPERATOR KNOW IMMEDIATELY THAT THIS IS A NON-EMERGENCY TEST CALL!
  9. Test an Inbound call to one of your DIDs. Check for Ringback tone, 2-way Audio, and Quality.
  10. Test an Inbound call to an IVR. Check DTMF and Audio Quality.
  11. Test Transferring calls off-site.
  12. Test an Outbound call to an Auto-Attendant and verify DTMF.
Personal tools
Namespaces
Variants
Actions
Toolbox