How to assign a script to a single VICIdial list

Why you might want a list-level script

Most campaigns run a single script for all leads. But sometimes one Lead list within a campaign needs different talking points — a special product offer, a regional variation, or a compliance-specific disclosure. Rather than duplicating the campaign, you can assign a separate script directly to that list.

When an agent dials a lead from that list, VICIdial substitutes the list's Script for the campaign's default script. Leads in every other list in the same campaign continue to use the campaign script unchanged.

Where to find the list Script field

Navigate to Admin > Lead Lists and click the list you want to modify. In the List Detail page you will see a Script drop-down. By default this is set to empty, meaning the campaign's Script field controls what agents see. Selecting a script here activates the list-level override.

Step-by-step assignment

1. Go to Admin > Lead Lists.
2. Click the list name you want to configure.
3. Locate the Script drop-down in the List Detail page.
4. Select the script you want agents to see for leads in this list.
5. Click Submit to save. The override is active immediately.

How the override works at dial time

flowchart TD
  A[Agent dials lead] --> B{List has a Script set?}
  B -- Yes --> C[Load list Script in SCRIPT tab]
  B -- No --> D[Load campaign camp_script in SCRIPT tab]
  C --> E[Agent sees list-specific script]
  D --> F[Agent sees campaign script]

VICIdial checks the list's Script field first. If it is populated, that value overrides the camp_script for this call. If the list Script field is empty, the campaign's Script field is used. The Agent never has to choose — the right script appears automatically.

Good use cases

• Spanish-language leads in an otherwise English campaign — a translated script on a single list keeps agents on the right track.
• High-value Lead source segments that need a premium pitch different from the standard script.
• State-specific disclosures required by Two-party consent rules — isolate those leads in their own list and attach the compliant script.

For the broader picture of how scripts are assigned across campaigns, lists, and in-groups, see the VICIdial agent screen configuration guide. If you want to understand when a campaign script and an in-group script both apply to the same call, read camp script vs in-script.

Things to keep in mind

• The list Script drop-down only shows scripts with Active set to Y — inactive scripts will not appear.
• Clearing the Script field on the list (setting it back to blank) immediately reverts to the campaign script for new calls.
• This setting does not affect inbound calls routed through an in-group — those follow the in-group Script field instead.

Want managed hosting that makes list and script management easier across your whole call center? See pricing for VICIfast plans.