Settings Database

VICIdial Settings Database

The complete configuration reference for VICIdial 3.4. Every setting explained with recommended values, impact analysis, and step-by-step configuration guides.

Category:
Impact:
50 settings
adaptive_dl_level High

Adaptive Dial Level

Controls whether VICIdial automatically adjusts the dial level based on real-time agent availability and abandon rate ta...

Campaign View guide →
abandon_rate_target High

Abandon Rate Target

Sets the maximum allowable call abandonment rate as a percentage. The FTC's Telemarketing Sales Rule mandates a maximum ...

Campaign View guide →
agent_pause_codes_active Medium

Agent Pause Codes Active

When enabled, agents must select a pause reason code when placing themselves in a paused state. This enables accurate re...

Agent View guide →
amd_send_to_vmx High

AMD Send to Voicemail Extension

Specifies the dialplan extension or action to execute when the AMD system detects an answering machine. Options include ...

Campaign View guide →
auto_alt_dial High

Auto Alternate Dial

Configures VICIdial to automatically dial alternate phone numbers stored in lead records when the primary number results...

Campaign View guide →
auto_dial_level High

Auto Dial Level

Sets the number of simultaneous outbound call attempts per available agent. A value of 1.0 means one call per agent; 2.0...

Campaign View guide →
available_only_ratio_tally Medium

Available Only Ratio Tally

When enabled, the adaptive dial level calculation uses only agents in AVAILABLE status — not agents on calls, in wrap-up...

Campaign View guide →
call_timeout High

Call Timeout

The maximum number of seconds VICIdial will let an outbound call ring before hanging up and marking the lead as a No Ans...

Campaign View guide →
campaign_allow_inbound Medium

Campaign Allow Inbound

Enables agents in an outbound campaign to also receive inbound calls from specified inbound groups. When enabled, the di...

Campaign View guide →
campaign_recording High

Campaign Recording

Controls whether and how calls are recorded in this campaign. Options include no recording (NONE), record all calls (ALL...

Campaign View guide →
closer_campaigns Medium

Closer Campaigns

A comma-separated list of inbound groups that agents in this campaign can transfer calls to (hot transfers) or receive c...

Campaign View guide →
concurrent_transfers Medium

Concurrent Transfers

Sets the maximum number of simultaneous call transfers a single agent can initiate at one time. Higher values allow agen...

Campaign View guide →
daily_call_limit High

Daily Call Limit

Sets the maximum number of times a single lead can be called within a single calendar day. A value of 0 means no limit. ...

Campaign View guide →
dead_trigger Medium

Dead Trigger

Specifies the action to take when a call is detected as 'dead' — meaning the far end has hung up but the channel is stil...

Campaign View guide →
default_xfer_group Medium

Default Transfer Group

Defines the default inbound group that calls are transferred to when an agent initiates a transfer without explicitly se...

Campaign View guide →
dial_prefix Medium

Dial Prefix

A prefix added to the beginning of every outbound dial string before it is passed to Asterisk. Commonly used when calls ...

Campaign View guide →
dial_status_filter High

Dial Status Filter

A comma-separated list of lead statuses that VICIdial will include when selecting leads from the hopper for dialing. Onl...

Campaign View guide →
dial_timeout High

Dial Timeout

The Asterisk-level timeout in seconds for outbound dial attempts. This is separate from call_timeout and controls how lo...

Campaign View guide →
drop_action High

Drop Action

Defines what happens when an outbound call is answered but no agent is available to take it (an abandoned call). Options...

Campaign View guide →
drop_exten Medium

Drop Extension

The Asterisk dialplan extension to execute when a call is abandoned (no agent available). Only used when drop_action is ...

Campaign View guide →
drop_lockout_time High

Drop Lockout Time

The number of seconds a lead is locked from being redialed after receiving a dropped/abandoned call. FTC regulations req...

Campaign View guide →
filter_clean_cid_number Medium

Filter Clean CID Number

When enabled, VICIdial strips non-numeric characters from the outbound caller ID before sending to the carrier. This pre...

Campaign View guide →
force_dial_prefix Medium

Force Dial Prefix

Forces a specific prefix to be prepended to every dial string regardless of other settings. Unlike dial_prefix which can...

Campaign View guide →
hopper_level High

Hopper Level

The target number of leads maintained in the dialing hopper (queue) at any given time. VICIdial continuously refills the...

Campaign View guide →
inbound_queue_priority Medium

Inbound Queue Priority

Sets the priority level for an inbound queue when multiple queues compete for available agents. Higher numeric values in...

Campaign View guide →
lead_filter High

Lead Filter

A SQL WHERE clause expression applied to lead records before they enter the hopper. Allows granular filtering by any lea...

Campaign View guide →
lead_order Medium

Lead Order

Controls the order in which leads are loaded into the hopper from your lists. Options include DOWN (descending by lead_i...

Campaign View guide →
lead_recycling High

Lead Recycling

Enables automatic recycling of leads that were previously dispositioned as No Answer, Busy, or other configured statuses...

Campaign View guide →
list_order Medium

List Order

Sets the priority order in which multiple lists assigned to a campaign are dialed. Lists with lower order numbers are di...

Campaign View guide →
manual_dial_cid Medium

Manual Dial Caller ID

The caller ID number presented when agents manually dial numbers outside the normal campaign dialing flow. If left blank...

Campaign View guide →
manual_dial_filter High

Manual Dial Filter

Applies filtering rules when agents attempt to manually dial numbers outside the normal predictive flow. Options include...

Campaign View guide →
max_hopper_calls Medium

Max Hopper Calls

Sets an absolute maximum cap on the number of calls that can be simultaneously active in the hopper queue. This prevents...

Campaign View guide →
no_agent_no_queue Medium

No Agent No Queue

When enabled, the dialer stops placing outbound calls if no agents are logged in and available. This prevents calls from...

Campaign View guide →
omit_phone_code Medium

Omit Phone Code

When enabled, VICIdial strips the country code from the beginning of phone numbers before dialing. Used for domestic-onl...

Campaign View guide →
outbound_cid High

Outbound Caller ID

The caller ID number transmitted when making outbound calls in this campaign. Must be a number registered with your carr...

Campaign View guide →
pause_disposition Low

Pause Disposition

When enabled, requires agents to select a disposition/reason when they pause. Works in conjunction with agent_pause_code...

Agent View guide →
power_dial_mode High

Power Dial Mode

Enables power dialing mode where calls are placed at a fixed ratio regardless of agent availability signals. Unlike pred...

Campaign View guide →
safe_harbor_message High

Safe Harbor Message

The audio file or text-to-speech message played to contacts when a call is abandoned (no available agent). FTC regulatio...

Campaign View guide →
scheduled_callbacks High

Scheduled Callbacks

Enables agents to schedule future callback appointments directly from the disposition screen. When enabled, agents can s...

Campaign View guide →
start_call_url Medium

Start Call URL

A URL that VICIdial calls via HTTP GET when a call connects to an agent. Used to trigger CRM screen pops, log call event...

Campaign View guide →
timezone_filtering High

Timezone Filtering

Enables automatic filtering of leads based on local time zone to ensure calls only reach contacts during allowed calling...

Campaign View guide →
voicemail_message High

Voicemail Message

The audio file path or message to play when AMD detects an answering machine and is configured to leave a voicemail via ...

Campaign View guide →
wait_for_silence Medium

Wait for Silence

The number of milliseconds of silence VICIdial waits for after a call connects before attempting AMD analysis. Setting t...

Campaign View guide →
wait_between_calls Medium

Wait Between Calls

The number of seconds an agent has between completing one call (after disposition) and receiving the next call. This man...

Agent View guide →
wrap_up_seconds Medium

Wrap-Up Seconds

The mandatory time in seconds an agent spends in wrap-up status after a call ends before becoming available for the next...

Agent View guide →
xfer_group_order Low

Transfer Group Order

Sets the display order and priority of transfer destination groups available to agents on the transfer screen. Lower num...

Campaign View guide →
queue_priority Medium

Queue Priority

Determines the priority of calls in this inbound queue relative to calls in other queues when multiple queues share the ...

Campaign View guide →
amd_type High

AMD Type

Selects the answering machine detection algorithm. NONE disables AMD entirely. ASTERISK uses Asterisk's built-in AMD app...

Campaign View guide →
amd_agent_route Medium

AMD Agent Route

Determines where AMD-confirmed human calls are routed. NORMAL routes to the standard agent queue. Options include routin...

Campaign View guide →
drop_rate_group High

Drop Rate Group

A group identifier that links multiple campaigns together for shared abandon rate calculation. When set, VICIdial calcul...

Campaign View guide →