VICIfast
Glossary

Disposition

The outcome code an agent records at the end of a call in VICIdial.

A disposition is the outcome code an agent records at the end of a call. In VICIdial the agent screen will not release an agent back to the queue until a disposition is chosen, which is why disposition quality is largely a function of how short and unambiguous your list is.

Where dispositions are configured

Dispositions are statuses. The system-wide catalogue is vicidial_statuses; the codes a specific campaign offers its agents live in vicidial_campaign_statuses. A code is six characters or fewer - SALE, NI, WN, CALLBK, DNC - with a longer status_name shown to the agent.

Each status carries behaviour flags, and this is the part people miss. sale = Y makes the code count as a conversion in reporting. dnc = Y makes choosing it add the number to the DNC table. customer_contact, not_interested, unworkable, completed and scheduled_callback drive the equivalent report buckets. A custom code with none of these set still records fine - it just reports as nothing useful.

What happens when a disposition is applied

Two writes, not one. The lead's vicidial_list.status is overwritten with the new code, and a row is appended to vicidial_log for that call attempt. The lead therefore carries only its most recent outcome, while the log carries the whole history.

Hot keys

Each campaign disposition can be bound to a keyboard shortcut on the agent screen. On a high-volume outbound campaign this is worth doing properly: it removes a mouse trip per call from the wrap-up, and it materially improves data quality because agents stop reaching for whatever is nearest the cursor.

Keeping the list short

A practical rule is under a dozen selectable dispositions per campaign. Long lists produce a bimodal distribution - a couple of heavily used codes and a long tail nobody picks deliberately - and that makes funnel analysis unusable. If you need finer detail, capture it in a custom field rather than by splitting the disposition list.

See also