Providers in depth

A provider is a carrier trunk — where a call goes out, or comes in from. Past the basics in the Quick Start, each provider has its own connection settings, capacity limits, codec order, caller ID and number-rewrite rules.

The Providers list

In the sidebar, go to Routing > Providers.

The Providers list, now with two demo carriers: "Demo Carrier" and the newly added "Demo Backup Carrier".

The Register column shows — for a provider that does not register (most static IP trunks), or Registered / Rejected once it tries.

General settings, connection, and the live PJSIP preview

Open a provider and select Rules / Cause-Rules / Codecs / Server along the top to reach its other pages — the edit page itself opens on General and Authentication & network.

A provider's General and Authentication & network sections, with the generated PJSIP configuration alongside.

Connection and capacity

FieldMeaning
Host modeHostname, IP, or Dynamic (for a carrier with no fixed address — it registers to you instead).
Server IP / hostname / PortWhere this carrier's SIP server is — usually port 5060.
IP authenticationNo login/password: the carrier is identified purely by its IP address instead.
Login / PasswordCredentials your carrier gave you, if it requires them.
Registration active / Registration extensionWhether Voiplix must register with this carrier before it will accept calls, and the account/extension to register as.
Call limit (0 = unlimited)The most simultaneous calls this provider will carry at once.
Ring timeout (min. 30 s) / Call timeout (max. duration, 0 = off)How long a call may ring before giving up, and a hard cap on how long a connected call may last.

Further down the Advanced section adds two more capacity controls not shown above: Time limit per day (s) / Time limit per month (s) (a total-minutes cap, resetting on a chosen day of the month), and a calls-per-second throttle — "Limit up to N calls within M seconds (0 = off)".

Tip

The panel on the right is the actual Asterisk PJSIP configuration Voiplix will generate from these fields — useful to sanity-check host, port and credentials without leaving the page. Passwords in it are masked once a form is read-only.

Provider CallerID

Scroll (or, on a narrower screen, continue) to Provider CallerID — the caller ID Voiplix puts on calls placed out over this provider.

Provider CallerID — a fixed number, or a random one drawn from a number pool.
FieldMeaning
CID name / CID numberThe caller name and number sent on outgoing calls over this provider.
NumberChoose this to always send one fixed number.
Random from number poolDraw a caller ID from a configured Number Pool instead — with a Selection mode (for example pseudorandom) and a Deviation range controlling how it is spread across the pool.

Codecs

Select Codecs to set which audio codecs this provider may use, and in what order.

Provider codecs — none assigned yet on the demo carrier; each Add moves a codec into the priority list.

The order of Assigned codecs becomes the PJSIP allow priority for outgoing calls over this provider — the first one Voiplix and the carrier both support wins.

Provider rules — rewriting numbers and CallerID

Select Rules to cut or add digits on the numbers this provider sees, separately for the destination (called number) and source (CallerID).

Provider rules — number/CallerID rewriting, with a one-click way to copy every rule to another provider.
FieldMeaning
Cut (remove prefix)Digits stripped from the start of the number.
AddDigits added to the start of the number, after cutting.
LengthMinimum and maximum number length the rule applies to.
TariffOptionally switch to a different tariff for numbers this rule matches.

Check

Open the provider and confirm the PJSIP preview shows the host, port and credentials you expect, then select SIP test — a working carrier answers with Connection successful.