VitalPBX

This guide outlines the steps to configure Vital PBX to make and receive phone calls using the didlogic trunks. Before placing or receiving a call, ensure you have an active phone number and a SIP account created on your didlogic account.

Option A: Digest Authentication

Use this configuration method if your VitalPBX deployment relies on a dynamic external IP or standard background registration cycles.

Start with the trunk setup. Navigate to PBX → Trunks → SIP Trunks and establish the initial profile parameters:

• Description: It can be any alphanumeric string for identifying the trunk.
• Profile: It can be any UDP PJSIP Profile (usually the "Default PJSIP Profile").
• Codecs: select "ulaw", "alaw", or "g729".
• Trunk CID: for the name field, you can use any alphanumeric string, but for the number, you must provide the DID purchased in the initial steps using the +E.164 format (e.g., +1652221111).
• Overwrite CID: we will select the value "If not provided" to use the value of the field "Trunk CID" as the fallback value in case the extensions don't have an External CID defined.

Next, in General Configurations and Outbound Registration Settings, define the following fields:

• Local Username: can be any alphanumeric string without spaces.
• Remote Host: regional SIP gateway closest to your location, e.g., sip.nl.didlogic.net.
• Identify By: select the "Username" and "Auth Username" options.
• Remote Username: use the "SIP account ID" (30662 in this case) value from the SIP accounts list.
• Remote Secret: enter the password defined during the SIP account creation.
• Require Registration: set the value of this field to "Yes."

After saving the trunk and applying changes, you can monitor the trunk status by navigating to Reports → PBX Reports → PJSIP Endpoints. Once there, select the Trunks tab.

Additionally, you can check the trunk registration status by selecting the Outbound Registrations tab in the PJSIP Endpoints module.

Outbound Routes

After ensuring the trunk is up and running, create the outbound route to place calls using our PJSIP trunk.

The following options are available:

• X: Represents a single digit from 0 to 9.
• Z: Represents any digit from 1 to 9.
• N: Represents a single digit from 2 to 9.
• .: Wildcard, matches one or more characters.
• !: Wildcard, matches zero or more characters immediately.
• [1237-9]: Matches any digit or letter in the brackets (in this example, 1,2,3,7,8,9)
• [a-z]: Matches any lower-case letter
• [A-Z]: Matches any Upper-case letter

success

All destination phone numbers must be in the E.164 international format. E.164 numbers can have up to fifteen digits and are usually formatted as follows: [+][country code][subscriber number including area code]. An example of a US number in E.164 format is +16561223344. The didlogic platform rejects calls to numbers without country codes or carrying national access codes.

Below are typical examples of incorrectly formatted phone numbers

Inbound Routes

To receive inbound calls, you need to configure Inbound Routes.

To route calls to your VitalPBX instance, log in to your didlogic account, select PURCHASED in the top menu, and click on the DID's Destination link.

1. Select the destination SIP account in the Forward To section.
2. Click Add to add the destination for the DID.
3. Click Save to save the settings.

Option B: IP Authentication

The didlogic platform supports IP authentication for dedicated IP addresses. Use this layout for high-concurrency architectures.

To activate the IP authentication on the didlogic platform, submit a request to the didlogic Support Team via the didlogic Portal by clicking on the Support button, or via Email to [email protected] with a request "Please enable IP authentication on IP XXX.XXX.XXX.XXX"

warning

After submitting the IP authentication request, you'll not be able to update your IP address or change the authentication method.

Then, complete the steps below in your Vital PBX:

1. Open your VitalPBX SIP Trunk settings → General Configurations and Outbound Registration Settings.
2. Set the Identify By to the IP.
3. Set the Require Registration to No.
4. Click Save to apply changes.

warning

SIP trunks with IP authentication enabled cannot be used for inbound call routing, as they do not maintain registration with didlogic regional gateways. To set up inbound routing for your numbers, you must use a valid SIP URI address when setting up routing for your number on the didlogic portal, e.g. [email protected]:5060;transport=udp

Troubleshooting

Issue	Likely Cause	Solution
603 Declined	Registration Failed	Verify that Registration Required is checked and credentials match.
603 Declined	Max Rate Limit	Ensure the destination rate doesn't exceed your account's "Max Rate" setting. If you would like to increase it, please contact [email protected].
No Audio	Firewall/NAT	Ensure UDP ports 10000-20000 are open for RTP traffic.
Calls Fail	Wrong Format	Use E.164. Never dial 00 or + unless your ARS handles the conversion.
Inbound Calls Don't Come Through	Firewall/NAT or Setup Issue	Make sure IP addresses of didlogic regional gateways are allowed on the firewall. Verify Line Group ID: Ensure the correct Line Group ID is assigned to both the trunk and the route. Use System Monitor in IP Office to see how the call is being presented. This can help you verify the format of the incoming DID and troubleshoot mismatches.