How to assign a script to a VICIdial campaign

Where the campaign script setting lives

Every outbound Campaign in VICIdial has a Campaign Detail page — the same screen where you configure dial method, caller ID, and call times. Scroll to the Script section and you will find a drop-down labeled Script. Selecting a script here stores it as the camp_script value for that campaign. From that moment on, every agent who dials from this campaign will see that script loaded in their SCRIPT tab.

The drop-down only lists scripts whose Active flag is set to Y. If a script you built does not appear, go to Admin > Scripts, open the script, and confirm the Active field is enabled.

Step-by-step assignment

1. Log in to the VICIdial admin panel.
2. Go to Admin > Campaigns and click the campaign name you want to update.
3. Scroll to the Script section and open the Script drop-down.
4. Select the script you want agents to see on calls.
5. Click Submit at the bottom of the Campaign Detail page to save.

Changes take effect for new calls immediately. Agents already on a live call will not see the new script until the next call.

How the script reaches the agent screen

flowchart TD
  A[Campaign Detail - Script field saved] --> B[camp_script stored on campaign]
  B --> C[Agent dials from campaign]
  C --> D[VICIdial loads camp_script]
  D --> E[SCRIPT tab appears in agent browser]

When an Agent connects to a call, VICIdial passes the camp_script value to the agent interface. The interface renders the script HTML — including any Custom field variables you embedded — inside the SCRIPT tab. If the script contains iframes or external URLs, the agent's browser fetches those at call time, so make sure they are accessible from agent workstations.

One script per campaign, with overrides possible

The Campaign Detail Script field sets the default for every lead in the campaign. You can override that default at the Lead list level — a specific list within the campaign can carry its own Script setting that replaces camp_script just for leads from that list. That pattern is covered in detail in assigning a script to a VICIdial list.

For a full picture of how the agent screen is configured — not just scripts but dispositions, hotkeys, and web forms — see the VICIdial agent screen configuration guide.

Tips before you save

• Preview the script first. Go to Admin > Scripts, open the script, and use the Preview button to see exactly what agents will read.
• Keep script IDs under 20 characters and avoid spaces or punctuation — VICIdial enforces this limit and will reject longer IDs.
• If you need inbound calls handled by a different script, set that on the in-group instead of the campaign.
• Agents on a blended Ingroup may see two SCRIPT tabs when both camp_script and in_script are set. Plan your script content accordingly.

Ready to streamline how you manage campaigns and scripts across your whole operation? See pricing for VICIfast hosted plans.