VitalPBX

From VoIP.ms Wiki

[checked revision]

[checked revision]

Revision as of 01:12, 30 August 2023 (view source) Joseanmont (Talk | contribs) ← Older edit		Revision as of 01:12, 30 August 2023 (view source) Joseanmont (Talk | contribs) (→Configuring Outbound Routes on VitalPBX) Newer edit →
Line 115:		Line 115:
-	[[File:2._Outbound_Routes.png|border|800px]]	+	[[File:2._Outbound_Routes.png|border|1000px]]

---

Revision as of 01:12, 30 August 2023

This article will provide you with guidance on configuring your VitalPBX.

Contents 1 Configuring PJSIP using User and Password Authentication 1.1 General Configurations 1.2 Outbound Registration Settings 2 Configuring PJSIP using IP Authentication 2.1 General Configuration 2.2 Outbound Registration Settings 3 Configuring Outbound Routes on VitalPBX 4 Configuring Inbound Routes on VitalPBX 5 Adding an Extension 6 Whitelisting VoIP.ms IPs in VitalPBX

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 appear 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 the regular Canadian providers will not show more than 15 characters. We suggest shrinking or adapting 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.

Adding an Extension

Once you have configured the Trunk and the routes you will use with it, you will have to add extensions for your IP phones, softphones, ATAs or any other devices that will be provisioned with the VitalPBX trunk that is registered in VoIP.ms.

To add an extension, in VitalPBX go to PBX >> Extensions. There, enter the following information:

• Extension: Enter the internal extension number.
• Name: Enter a name to identify this extension.
• Internal CID:
• Name: A name to display on internal calls
• Number: A number to display on internal calls (Usually the same as the extension number).
• External CID:
• Name: Set a name to display on external calls.*
• Number: Set the DID number that this extension will use as caller ID.

*IMPORTANT: 
  - We suggest entering your outbound Caller ID Name must be in CAPITAL LETTERS. This will appear 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 the regular Canadian providers will not show more than 15 characters. We suggest shrinking or adapting your caller ID. 
  - Spaces are allowed in a caller ID name.

Whitelisting VoIP.ms IPs in VitalPBX

Whitelisting IP address in VitalPBX is very easy. To whitelist the IP address of the VoIP.ms server or servers you will use, go to Admin >> Firewall >> Access Control.

There, simply click on "+ Whitelist an IP" to add the server(s) that you want to whitelist.

From the Rules section under Firewall you can also create rules depending on your network needs.

For more information on the IPs related to our servers, click here
For more information on the Elastix setting, click here