VitalPBX

From VoIP.ms Wiki

Revision as of 23:20, 29 August 2023

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.

Configuring PJSIP using User and Password Authentication

Head into VitalPBX and go to PBX >> 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

Then, in the General Configurations you will omit the field Remote Username and Remote Secret.

Outbound Registration Settings

Additional settings to configure:

• 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, we will need to create an outbound route pointing to the trunk that we’ve created previously. In this case, we will use the main trunk from VoIP.ms.

This will be the outbound route configuration to allow national and international phone calls.

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

For receiving calls, the only thing we need to do is to create an Inbound Route with the number we have purchased previously, just as shown in the following screenshot.

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