VICIfast
Glossary

Campaign

VICIdial's top-level container for a dialing program - lists, agents, dial method, dispositions and pacing.

A campaign is VICIdial's top-level container for one dialing program. It is the row in vicidial_campaigns that ties together the leads you dial, the agents who take the calls, how fast the dialer paces, and what outcomes agents can record.

What a campaign owns

  • Lists - one or more lead lists point at the campaign via their campaign_id
  • Dial method - MANUAL, RATIO, the ADAPT_* family, INBOUND_MAN and the SHARED_* variants
  • Auto Dial Level - the calls-per-agent multiplier used by the ratio and adaptive methods
  • User group - which agents are allowed to log into it
  • Dispositions - the campaign's own selectable status codes, in vicidial_campaign_statuses
  • Local Call Time - local_call_time defaults to 9am-9pm in the lead's own time zone
  • Compliance settings - use_internal_dnc, drop_call_seconds, drop_action, safe_harbor_exten
  • Recording policy - campaign_recording is one of NEVER, ONDEMAND, ALLCALLS, ALLFORCE

The campaign_id column is only 8 characters, so campaign IDs are short codes like SALES01, not descriptive names. The human-readable name lives in campaign_name.

Why the boundary matters

Almost everything in VICIdial is scoped to a campaign. Reporting, recycling rules, caller ID, dial prefixes, hopper contents and the agent's disposition list all follow the campaign. That is why you run separate campaigns for outbound sales, collections and inbound rather than one big campaign with conditional logic - there is nowhere to put the conditional.

The practical consequence: cloning a campaign to test a new dial level or a new script is cheap and safe, and changing a live campaign's pacing affects every agent logged into it on the next dial decision.

A sensible starting shape

For a first outbound campaign, set the dial method to MANUAL while you validate the list and the script, confirm calls connect and dispositions save, then switch to RATIO at a dial level of 1.0 and raise it from there.

See also