VitalPBX
From VoIP.ms Wiki
This article will provide you guidance on configuring your VitalPBX.
Please note that this is a basic guide, and only covers how to connect the trunk with our servers, and configuring your outgoing and incoming calls.
Contents |
Configuring PJSIP using User and Password Authentication
Head into VitalPBX and go to PBX >> Calls Routing >> Trunks to create a trunk with the following parameters:
- Description: Any name to identify your trunk.
- Profile: Optional. Recommended to be set to the “Default PJSIP Profile”. To edit the Default PJSIP profile or create your own go to "Settings >> Technology Settings >> Device Profiles".
- Codecs: Recommended to use G.722* (G.711u, G.729a and GSM are also supported).
-
Trunk CID
- Trunk CID Name: The name you want to display on outbound calls*
- Trunk CID Number: The DID number you want to display on outbound calls
- Overwrite CID: Set to No to control the CID from the extension or outbound route. Can be set to “If not provided” in order to allow external incoming caller ID during call forwards.
*IMPORTANT: The Main and Sub-Accounts use codec G.711u as priority by default. To use G.722 go to the advanced settings of the account you'll configure in the trunk.
*IMPORTANT: - We suggest entering your outbound Caller ID Name must be in CAPITAL LETTERS. This will appears more clearly/visible on some devices. - You must NOT use any special characters, they will not be displayed. - Do not exceed 15 characters max! Some of regular Canadian providers will not show more than 15 characters. We suggest shrinking or adapt your caller ID. - Spaces are allowed in a caller id name.
General Configurations
- Local User: This is the name of your trunk. It can be anything of your liking.
- Remote Host: Your Preferred VoIP.ms server (Recommended to use one near to your location and use the same as the POP of your DIDs). To see the list of servers click here.
- Contacts: SIP URI with one of the multiple servers from VoIP.ms. (E.g. sip:[email protected])
- Match: Same as the Remote Host.
- Remote Username: Your Main or Sub-Account SIP username.
- Remote Secret: Your Main or Sub-Account password.
- From User: Same as Remote Username.
- From Domain: Same as Remote Host.
- Contact Header: Same as Remote Username.
Outbound Registration Settings
- Require Registration: Must be set to “Yes”.
- Permanent Auth Rejection: Must be set to “Yes”.
- Client URI: A SIP URI composed of your Main or Sub-Account username and your preferred VoIP.ms server.
- Server URI: Your preferred VoIP.ms server.
Configuring PJSIP using IP Authentication
In case you would like to use IP authentication instead of a User and Password, here, we will show you how to do it.
This will be the required configuration:
IMPORTANT: Remember, to be able to use IP authentication you will need to create a sub-account. The main account is not capable of handling this type of authentication.
- Description: Any name to identify your trunk
- Profile: Optional. Recommended to be set to the “Default PJSIP Profile”. To edit the Default PJSIP profile or create your own go to "Settings >> Technology Settings >> Device Profiles"
- Codecs:' Recommended to use G.722* (G.711u, G.729a and GSM are also supported)
-
Trunk CID
- Trunk CID Name: The name you want to display on outbound calls*
- Trunk CID Number: The DID number you want to display on outbound calls
- Overwrite CID: Set to No to control the CID from the extension or outbound route. Can be set to “If not provided” in order to allow external incoming caller ID during call forwards.
*IMPORTANT: The Main and Sub-Accounts use codec G.711u as priority by default. To use G.722 go to the advanced settings of the account you'll configure in the trunk.
General Configuration
Here you will omit the Remote Username and the Remote Secret fields.
- Local User: This is the name of your trunk. It can be anything of your liking.
- Remote Host: Your Preferred VoIP.ms server (Recommended to use one near to your location and use the same as the POP of your DIDs). To see the list of servers click here.
- Contacts: SIP URI with one of the multiple servers from VoIP.ms. (E.g. sip:[email protected])
- Match: Same as the Remote Host.
- From User: Same as Remote Username.
- From Domain: Same as Remote Host.
- Contact Header: Same as Remote Username.
Outbound Registration Settings
- Require Registration: Must be set to “No”.
- Permanent Auth Rejection: Must be set to “No”.
Configuring Outbound Routes on VitalPBX
In order to place calls, you will need to create an outbound route pointing to the trunk that was created previously.
To add an Outbound Route go to PBX >> Call Routing >> Outbound Routes.
To allow national and international phone calls you can add the following patterns:
- NXXNXXXXXX
- 1NXXNXXXXXX
- 00.
- 011
- 4XXX (To be able to perform the Sound Quality test and DTMF test)
You can also configure the pattern “4443” to perform a sound quality test, and the pattern “4747” to perform a DTMF test.
Configuring Inbound Routes on VitalPBX
To receive calls, you need to create Inbound Routes for the DID number(s) in your VoIP.ms account.
To add inbound routes in VitalPBX go to PBX >> Call Routing >> Inbound Routes.
Under General set a description and the DID pattern of your DID(s).
Please note that in the DID pattern option, you can define a specific DID or a pattern using wildcards.
Under Inbound Destination make sure to select the feature or extension that will manage the inbound calls received by this route.
Whitelisting VoIP.ms IPs in VitalPBX
With VitalPBX, it is quite easy. Simply proceed into VitalPBX, head into Admin, Firewall Rules, and then Add Rules. From there, you can whitelist VoIP.ms points of presence IPs.
For more information on the IPs related to our servers, click here
For more information on the Elastix setting, click here
