What the Phone Context field does

Phone Context is one of two context fields on a VICIdial phone entry, and it has a specific job: it sets the dialplan context the phone uses to dial out. When the device places a call on its own, this is the context that call enters. The default value is default, which routes calls the normal way. Most teams never change it, but the few who do usually have a good reason.

Context, in plain terms

A context is a named section of the Dialplan inside Asterisk, the call-routing engine under VICIdial. Each context holds a set of rules that decide what happens to a call that enters it. Phone Context tells the system which of those rule sets applies when this particular phone tries to originate a call by itself. It is the dial-out door for the device.

Because it is a per-phone field, every Extension can point at a different dial-out context, whether it is a desk phone or a SIP (Session Initiation Protocol) softphone. In practice almost everyone leaves it on default and lets the standard routing handle outbound calls.

Where this field gets interesting

The one common reason to change Phone Context is to stop a phone from dialing out on its own. If you set it to a context that does not exist, the phone has no valid path to place a call, so direct dialing from the handset fails. Calls placed through the VICIdial screen still work, because those do not depend on the phone's own dial-out context. That is the whole basis of the lock-down trick used in call centers.

flowchart LR
  A[Phone originates a call] --> B[Enters Phone Context]
  B --> C{Which context?}
  C -->|default| D[Routed and dialed out]
  C -->|fake context| E[No route found]
  E --> F[Direct dialing blocked]

So the same field can do two opposite things depending on its value: enable normal dialing when it points at a real context, or quietly disable it when it points at a missing one.

Phone Context versus Exten Context

These two fields sit next to each other and get mixed up constantly. Phone Context is the context the phone dials out with. Exten Context is the context the phone primarily operates in, the one the client applications assume for the numbers they dial. They are not the same field and changing one does not change the other. If you only need to control whether a phone can dial out by hand, Phone Context is the one to touch.

• Phone Context: how the phone dials out. Default is default.
• Exten Context: the wide context the phone mainly works inside.

Practical advice

Leave Phone Context on default unless you specifically want to block a phone's own dialing, which matters for both outbound agents and inbound reps you do not want making personal calls. If you do change it to a fake context to lock the device, walk through the step-by-step in how to stop agents dialing outside a campaign. To understand the field it is so often confused with, read about the Exten Context field. The VICIdial phones guide puts every phone field in context.

Hand-editing dialplan contexts is exactly the kind of low-level chore a managed dialer removes. With a hosted VICIdial box, the contexts are already wired correctly and you only change them when you mean to. See VICIfast plans to see what a managed setup handles out of the box.