What is a VICIdial agent soundboard?

A Soundboard in VICIdial is a panel of clickable buttons that let a live Agent play pre-recorded audio to the customer instead of, or alongside, speaking themselves. Think of it as a soundboard control screen that sits inside the agent's script frame: each button is wired to one audio file, and clicking it streams that recording down the call. It is one of the more unusual tools on the agent screen, and once you see it in action it is hard to unsee how useful it can be.

What it actually does

There are two common ways teams use soundboards. The light version lets a human agent play a few selected recordings, like legal or contractual disclaimers, while still handling the rest of the conversation live. The heavy version replaces agent speech almost entirely: the agent listens, picks the right button, and the recorded voice does the talking. VICIdial has been tested with control screens carrying over 100 audio buttons and handles many more comfortably, so even sprawling soundboard setups stay responsive. That headroom matters once you start grouping dozens of clips into categories, because a busy board is still a fast board.

Every soundboard is its own admin record. It carries a Soundboard ID, a Soundboard Name shown to the agent at the top of the control screen, admin-only notes, an API user and password that actually trigger the audio events, and an Active flag that defaults to Y. The buttons themselves are added separately as audio entries, each pointing at one recorded file. You also control what text appears on those buttons through the Audio Display setting, which can show the filename, the descriptive name, or hide the button numbers entirely. The default shows both the file and the name. If you are mapping out the wider agent experience, this fits neatly into the broader agent screen configuration guide.

How a click becomes audio

sequenceDiagram
  participant Agent
  participant Screen as Soundboard Screen
  participant API as API User
  participant Call as Customer Call
  Agent->>Screen: Click audio button
  Screen->>API: Trigger audio event
  API->>Call: Play recorded file
  Call-->>Agent: Customer hears audio

The agent never touches the plumbing. They see labelled buttons, click one, and behind the scenes the configured API user fires the audio event that injects the recording into the call. That separation is why the API (application programming interface) credentials matter so much, and why teams usually dedicate a reduced-permission account to the job. The board appears to the agent because you embed it in a script with a small iframe that names the soundboard by its ID, so the script and the soundboard record are always two halves of the same setup.

When a soundboard is the right call

Soundboards shine where wording must be exact and identical every time, such as compliance disclaimers, consent language, or a scripted offer that legal has signed off on word for word. They pair naturally with an Agent script, since the buttons live inside a script you create. If you are still deciding whether scripted text or recorded audio fits your team, start with the basics in our guide to what a VICIdial script is, then layer a soundboard on top once the script structure is clear.

If perfectly consistent, compliant audio is on your roadmap, a soundboard removes a lot of human variability from the call. It also keeps quality steady across shifts and new hires, since the recording sounds the same on call one and call one thousand. Want a hosted VICIdial stack with this already wired up and ready to configure? Take a look at VICIfast pricing to get started.