Configuring Trixbox ce 2.8.0.3 for Spitfire SIP Trunks

This document is a guideline for configuring Spitfire SIP trunks onto Trixbox and includes the settings required for Inbound DDI routing and Outbound CLI presentation. The settings contained within have been tested and are known to work at the time of testing. SIP trunk details such as account number and password will be provided separately.

Provisioning a SIP trunk: Page 2 Outbound Routing – Reference only: Page 8 Inbound Routing – Reference only: Page 10 Outgoing CLI – Reference only: Page 14

2

Add SIP Trunk Additional code is required to parse the inbound DDI from the To header. In this example I have used the extensions.conf file but you should use config file is appropriate for your particular installation. Select “PBX, Config File Editor”.

Select “extensions.conf

3

Add SIP Trunk continued Paste the following into the appropriate file (I have used extensions.conf) as highlighted below. This will allow the trixbox to read & route incoming DDI calls. Please note that the goto step may need to be changed to suit your programming. Although this code was tested as working in this installation it comes with no warranty from Spitfire. [ParseDDI_from_ToHeader] exten => _.,1,Set(parseDDI=${SIP_HEADER(To)}) exten => _.,n,Set(parseDDI=${CUT(CUT(parseDDI,@,1),:,2)}) exten => _.,n,Goto(from-trunk,${parseDDI},1) Select “Update”. Please ensure that you add context=ParseDDI_from_ToHeader in the Outgoing Peer Details of the trunk (page 6)

4

Add SIP Trunk continued Select “PBX, PBX Settings”.

Select “Add SIP Trunk”

5

Add SIP Trunk continued General Settings

1. Outbound Caller ID: Enter the User name as supplied by Spitfire without the leading 44.

Please note that this is just the number and DOES NOT include @spitfiretsp.net. This is the number that will be presented if there is no individual CLI presentation per extension

2. Never Override ID: Determined by the installer 3. Maximum Channels: As specified by Spitfire 4. Disable Trunk: Determined by the installer. I would suggest No 5. Monitor Trunk Failures:Determined by the installer

Outgoing Dial Rules (Reference Only)

1. Dial Rules: Not strictly necessary – it is dependant on the routing applied 2. Dial Rules Wizards: Determined by the installer, but normally blank on Spitfire trunks 3. Outbound Dial Prefix: Determined by the installer, but normally blank on Spitfire trunks

6

Add SIP Trunk continued Outgoing Settings

1. Trunk Name: Give the trunk a logical name 2. PEER Details: Enter the details below in the PEER Details area.

Please Note: Not all the details required are shown in the screenshot – they are listed below with a brief description. There are also other settings available for use in the PEER Details, but the ones below are those required to work with Spitfires SIP trunks. Other settings may have a negative impact on the SIP trunks, but this will need to be determined by the system installer.

type=peer

host=83.218.143.16 (or spitfiretsp.net) outboundproxy=mproxy3.spitfiretsp.net

username=your username as supplied by Spitfire (i.e. 442031410020) secret=password as supplied by Spitfire fromuser= your username as supplied by Spitfire (i.e. 442031410020) fromdomain=spitfiretsp.net

sendrpid=yes insecure=invite disallow=all allow=alaw qualify=no canreinvite=no

progressinband=yes this setting is required only if you are using call forward/divert to an off-switch destination. Without this setting, the call will establish but you may not hear any speech. context=ParseDDI_from_ToHeader

7

Add SIP Trunk continued Incoming Settings

1. User Context: Leave blank 2. User Details: Leave blank

Registration

1. Register String: Enter the Register string in the following format:

Format: Username:password@83.218.143.16/DDI Number or Username:password@spitfiretsp.net/DDI Number

Example as below: 442031410020:xxxxxxxxxx@83.218.143.16/442031410020

Select “Submit Changes” when finished

You will be returned to the “Add a Trunk” page. You can see the new trunk on the right of the page, but you need to apply the configuration changes before it can be used. Select “Apply Configuration Changes” and then “Continue with Reload”

8

Outbound Routing – Reference only Note: In this example I am simply modifying an existing “Dial 9” route to use our newly created trunks. The installer may add or amend routes as necessary. Select “Outbound Routes” on the “Setup” panel on the left of the screen.

Select “0 9_outside” on the right hand side of the “Add Route” screen.

9

Outbound Routing continued – Reference only Go to “Trunk Sequence” and use the drop-down box to select your newly created SIP trunk (Spitfire in this case) to route calls through, and “Submit Changes”

10

Inbound Routing – Reference only Please Note: There are many fields available in the Inbound Routes field. This guide is only intended to demonstrate an incoming DDI call only. The installer will determine if any of the other fields are required for each DDI programmed. Select “Inbound Routes” on the “Setup” panel on the left of the screen.

11

Inbound Routing continued – Reference only Add Incoming Route

1. Description: Give the incoming route a logical name. 2. DID Number: Enter the DDI number in the format 44xxxxxxxxxx (as below) 3. Caller ID Number: Determined by the installer 4. CID Priority Route: Determined by the installer

Options

1. Alert Info: Determined by the installer 2. CID name prefix: Determined by the installer 3. Music On Hole: Determined by the installer 4. Signal Ringing: Determined by the installer 5. Pause Before Answer: Determined by the installer

12

Inbound Routing continued – Reference only Privacy

1. Privacy Manager: Leave at No Fax Handling

1. Fax Extension: Determined by the installer 2. Fax Email: Determined by the installer 3. Fax Detection Type: Determined by the installer 4. Pause after Answer: Determined by the installer

CID Lookup Source

1. Source: Determined by the installer Set Destination Determined by the installer. In this case I have selected “Extensions”

and the selected the extension “<201> Terry” from the drop-down box

Select “Submit” when finished

13

Inbound Routing continued – Reference only You can now see the new DDI on the right, and as before you need to “Apply Configuration Changes” and then “Reload”

14

Outgoing CLI – Reference only This reference shows how to modify the outbound Caller ID on a single extension. This will over-ride the “Outbound Caller ID” in the SIP trunk (Page 3) Select the extension you wish to modify. Go to “Outbound CID” under “Extension Options”

1. Enter the CLI number in the format below (i.e. drop the leading 44 from the DDI number) and “Submit”

2. “Apply Configuration Changes” and then “Reload”