Skip to content
Docs
Voxbi Cockpit APIs
API Guides

Route outgoing calls

Route outgoing calls are rules that change which caller ID is presented on outbound calls, based on the dialled prefix and who is dialling. A user calling a Belgian number can present a Belgian caller ID. The same user calling within Luxembourg presents the local number.

Overview

Without these rules, every user always presents the same outbound number (their personal line, or the tenant default). With them, the presented caller ID adapts to where the call is going - a local number looks like a local call and is more likely to be answered. Only the recipient sees the change, not the user placing the call.

What it does

Each rule pairs a dialled-number prefix with a caller identity to present, and a scope: either a global rule that covers every user on the PBX, or a rule limited to specific users and groups. The global toggle and the user/group assignment are what you configure here.

At call time the telephony platform applies these rules: when a user dials an external number, it looks for a rule whose prefix matches the start of the dialled number and whose scope includes that user, and presents the matching caller identity instead of the user's default. The exact matching and precedence between overlapping rules is carried out by the telephony platform, not configured on this page.

For example, you can set a global rule that maps +32 to the main office number and a group rule that maps +32 to the Sales hotline, so a Belgian call from a Sales user can present the Sales number while other users present the office number.

See also

  • SIP carriers - the routes the outbound traffic actually uses.
  • Phone numbers - the caller identities these rules pick from.
  • Groups - the team-level scope for group-restricted rules.

Form fields

Fields available in the create and edit forms.

General

Prefix

The dialled number prefix that triggers this rule. Matches from the start of the dialled number (for example +32 matches all calls to Belgium). Longest matching prefix wins among rules at the same scope level.

Caller identity

The outgoing phone number presented to the called party when this rule matches. Grouped by source: users, groups, SIP devices, or the PBX itself.

Global rule

When on, this rule applies to all users on the PBX. When off, you must assign specific users or groups below.

Users

The individual users this rule applies to. Only visible when the global rule is off.

Groups

The groups this rule applies to. All members of the selected groups are covered. Only visible when the global rule is off.

Updated