VitalPBX
From VoIP.ms Wiki
| [checked revision] | [checked revision] |
(→Configuring Inbound Routes on VitalPBX) |
Joseanmont (Talk | contribs) (→Configuring PJSIP using User and Password Authentication) |
||
| Line 8: | Line 8: | ||
== Configuring PJSIP using User and Password Authentication == | == Configuring PJSIP using User and Password Authentication == | ||
| - | Head into | + | Head into VitalPBX and go to PBX >> Trunks to create a trunk with the following parameters: |
| + | |||
| + | <ul> | ||
| + | <li>'''Description:''' Any name to identify your trunk</li> | ||
| + | <li>'''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"</li> | ||
| + | <li>''Codecs:''' Recommended to use '''G.722'''* (G.711u, G.729a and GSM are also supported)</li> | ||
| + | <li> | ||
| + | '''Trunk CID''' | ||
| + | <ul> | ||
| + | <li>'''Trunk CID Name:''' The name you want to display on outbound calls*</li> | ||
| + | <li>'''Trunk CID Number:''' The DID number you want to display on outbound calls</li> | ||
| + | </ul> | ||
| + | </li> | ||
| + | <li>'''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.</li> | ||
| + | </ul> | ||
| + | |||
| + | *'''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. | ||
| + | |||
| + | [[File:_Trunk_General_Settings_1.png|border]] | ||
| + | |||
| + | === General Configurations === | ||
| - | |||
| - | |||
| - | |||
| - | |||
* '''Local User:''' This is the name of your trunk. It can be anything of your liking. | * '''Local User:''' This is the name of your trunk. It can be anything of your liking. | ||
* '''Contacts:''' SIP URI with one of the multiple servers from VoIP.ms; You can choose one closer to your location. | * '''Contacts:''' SIP URI with one of the multiple servers from VoIP.ms; You can choose one closer to your location. | ||
| Line 20: | Line 42: | ||
* '''Remote Secret:''' Same password that you use for login into the portal. | * '''Remote Secret:''' Same password that you use for login into the portal. | ||
| + | [[File:1._Trunk_General_Settings_2.png|border]] | ||
| - | + | === Outbound Registration Settings === | |
| - | + | ||
'''Additional settings to configure:''' | '''Additional settings to configure:''' | ||
* '''Require Registration:''' Must be set to '''“Yes”''' | * '''Require Registration:''' Must be set to '''“Yes”''' | ||
* '''Permanent Auth Rejection:''' Must be set to '''“Yes”''' | * '''Permanent Auth Rejection:''' Must be set to '''“Yes”''' | ||
| - | |||
== Configuring PJSIP using IP Authentication == | == Configuring PJSIP using IP Authentication == | ||
Revision as of 22:50, 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.
Contents |
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.
File:Trunk General Settings 1.png
General Configurations
- Local User: This is the name of your trunk. It can be anything of your liking.
- Contacts: SIP URI with one of the multiple servers from VoIP.ms; You can choose one closer to your location.
- Match: Set one of the multiple servers from VoIP.ms. The “DID POP” must be the same server configured in this field.
- Remote Username: Main SIP username
- Remote Secret: Same password that you use for login into the portal.
Outbound Registration Settings
Additional settings to configure:
- Require Registration: Must be set to “Yes”
- Permanent Auth Rejection: Must be set to “Yes”
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. 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.
This will be the required configuration:
- Profile: Optional. Can be set to the “Default PJSIP Profile” for adding NAT configurations and other settings.
- Codecs: ulaw, g729
- Trunk CID: We can set as the CID number one of the DID(s) acquired on the VoIP.ms portal
- Overwrite CID: Can be set to “If not provided” in order to allow external incoming caller ID during call forwards.
- Local User: The name of your trunk. This can be anything of your liking.
- Contacts: SIP URI with one of the multiple servers from VoIP.ms; You can choose one closer to your location.
- Match: Set one of the multiple servers from VoIP.ms. The “DID POP” must be the same server configured in this field.
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
