VoIP:Hardware:3CX: Difference between revisions

From VTX Public Wiki

(→‎Create a VTX SIP Trunk with XML template: add advanced VTX Template if Special Arrangement is activated)
Line 11: Line 11:
== Create a VTX SIP Trunk with XML template ==
== Create a VTX SIP Trunk with XML template ==


* '''Information''': If "Special Arrangement / CLIP No Screening" (advanced feature) got activated on your VTX trunk, you can manually adapt the parameters as described in [[VoIP:Hardware:3CX:Configuration#Outbound_Parameters|Outbound Parameters]] or import the Advanced VTX Template below
* '''Problem''': The "VTX" SIP trunk template has been temporarily deleted from the 3CX SIP trunk template list. We are checking to have it added back
* '''Problem''': The "VTX" SIP trunk template has been temporarily deleted from the 3CX SIP trunk template list. We are checking to have it added back
* '''Workaround''': You can import the VTX Template manually following procedure below
* '''Workaround''': You can import the VTX Template manually following procedure below


# Download the 3CX VTX Template on your PC : https://wiki.vtx.ch/media/3CX_VTX_provider.pv.xml
# Download the 3CX VTX Template on your PC
## ("normal" template) https://wiki.vtx.ch/media/3CX_VTX_provider.pv.xml
## ("Special Arrangement template") : https://wiki.vtx.ch/media/3CX_VTX_provider_advanced.pv.xml
# Connect on your 3CX PBX Admin interface
# Connect on your 3CX PBX Admin interface
# Go in "SIP Trunks" menu and click on the "Import Provider" button
# Go in "SIP Trunks" menu and click on the "Import Provider" button
# Upload the '''"3CX_VTX_provider.pv.xml"''' file
# Upload the '''"3CX_VTX_provider.pv.xml"''' file
# Finish the setup of your trunk using the [[{{FULLPAGENAME}}#Configuration]]
# Finish the setup of your trunk using the [[{{FULLPAGENAME}}#Configuration]]

* '''Information''': If "Special Arrangement / CLIP No Screening" (advanced feature) got activated on your VTX trunk, you can manually adapt the parameters as described in [[VoIP:Hardware:3CX:Configuration#Outbound_Parameters|Outbound Parameters]] or import the Advanced VTX Template.<br>
Download link for 3CX VTX Advanced Template: https://wiki.vtx.ch/media/3CX_VTX_provider_advanced.pv.xml

Revision as of 08:44, 6 June 2023

Introducation[edit | edit source]

FIXME to be written


Configuration[edit | edit source]

SIP Trunks[edit | edit source]

General Tab[edit | edit source]

  • Trunk Details
    • Name = "VTX Service SA"
    • Registrar/Server/Gateway Hostname or IP = s1.XX.trk.ipvoip.ch ( Uniquer per customer, copy paste info from VTX Kiosk ex : s1.238234.trk.ipvoip.ch)
    • Outbound Proxy : 212.147.47.218 ( DNS resolution of the SIP Registrar/Server/Gateway Hostname )
    • Number of SIM Calls : 4 or more ( Depends on the Service Type you have ( Connect_PABX_4 => 4 calls, Connect_PABX_8 => 8 calls, Connnect_PABX_60 => 60 calls, ...) )
  • Authentication
    • Type of Authentication : Register/Account Based
    • Authentication ID (aka SIP User ID) : 41...lbo ( Uniquer per SIP trunk, copy paste info from VTX Kiosk)
    • Authentication Password: ( Uniquer per SIP trunk, copy paste info from VTX Kiosk)
  • Route calls to
    • Main Trunk No: 004121566... ( Warning, by default incoming call routing number are in international format 0041, this can be changed on request to +e164 or National format )

DIDs[edit | edit source]

0041215668340
0041215668341
0041215668342
0041215668343

Caller ID[edit | edit source]

Options[edit | edit source]

  • Advanced
    • PBX Delivers Audio = Yes ( forces the PBX to convert RTP stream, will use resources on the PBX and might trigger problem )
    • Supports Re-Invite = Yes
    • Force Invites to be send to IP of Registrar = Yes
    • Re-Register Timeout = 600
    • Select which IP to use in 'Contact' (SIP) and 'Connection'(SDP) fields = Local IP Address
    • Transport Protocol = TCP (Not to have problem with Firewall that do not accept UDP fragmented packets)
  • Codec Priority
    • G722
    • G711a
    • G729
  • Options
    • Set Contact (SIP) and "Connection" (SDP) with "Local IP"

Inbound Parameters[edit | edit source]

Keep it default or adapt it to fit your needs

Outbound Parameters[edit | edit source]

Here are the parameters that you need to adapt to be able to bill all numbers

SIP Field Variable Impact Explanation
P-Preferred Identity : User Part Leave default value

(old value : "LineNumber")

Will not send P-Preferred-Identify Header anymore

not to always bill your LineNumber all the time

PPI needs only to be used to define the number to be billed

So it is only useful when you wish to display a number out of your range with "Special Arrangement" and bill one specific number of your trunk

P-Preferred Identity : Host Part Leave default value

(old value : "GWHostPort")

Extensions[edit | edit source]

General Tab[edit | edit source]

  • User Information
    • Outbound Caller ID : 0041__ ( Enter here the number to display for outgoing call for this extension from the trunk or external if you have "Special Arrangement / CLIP No Screening" )

Inbound Rules[edit | edit source]

Create a new incoming DID rule with a number added in the SIP trunks DDI

  • Name = "Useful Description"
  • DDI = Select one from the list
  • Route calls to = Set it up according to your needs

Outbound Rules[edit | edit source]

Add the following rules

  • General
    • Rule Name = VTX_Default_Rule
    • Calls to numbers starting with prefix = 0
  • Make outbound calls on
    • Route: "VTX Services SA" + Strip Digits = 0

Usage[edit | edit source]

Create a VTX SIP Trunk with XML template[edit | edit source]

  • Information: If "Special Arrangement / CLIP No Screening" (advanced feature) got activated on your VTX trunk, you can manually adapt the parameters as described in Outbound Parameters or import the Advanced VTX Template below
  • Problem: The "VTX" SIP trunk template has been temporarily deleted from the 3CX SIP trunk template list. We are checking to have it added back
  • Workaround: You can import the VTX Template manually following procedure below
  1. Download the 3CX VTX Template on your PC
    1. ("normal" template) https://wiki.vtx.ch/media/3CX_VTX_provider.pv.xml
    2. ("Special Arrangement template") : https://wiki.vtx.ch/media/3CX_VTX_provider_advanced.pv.xml
  2. Connect on your 3CX PBX Admin interface
  3. Go in "SIP Trunks" menu and click on the "Import Provider" button
  4. Upload the "3CX_VTX_provider.pv.xml" file
  5. Finish the setup of your trunk using the VoIP:Hardware:3CX#Configuration