system
Non-agent API
The non-agent API is a VICIdial web interface that lets outside systems read data and trigger actions, like adding leads or pulling stats, without an agent logged in.
The non-agent API is VICIdial's web interface for tasks that have nothing to do with a live agent screen. API stands for application programming interface, which is just a defined set of web requests that another program can send to ask for data or to make something happen. The word "non-agent" is the key: these are background actions like adding a lead, updating a list, or pulling a report, all done without a person sitting at a phone.
This matters because most call centers do not live inside VICIdial alone. You probably have a CRM or a website that captures new contacts throughout the day. The non-agent API is how those systems push a fresh Lead into your dialer the moment it arrives, instead of waiting for a nightly batch through the Lead loader. It is the bridge between your other tools and the dialer, and it is what makes a contact who fills out a form get a call back in minutes rather than tomorrow.
How it differs from the agent API
VICIdial has a second interface called the Agent API, and the names tell the story. The agent API controls what a logged-in agent's session does: dial, pause, hang up, set a disposition. The non-agent API handles everything else, the data and management side that runs without a person. A common pattern is a Webhook from your website that calls a non-agent API URL (in VICIdial) to insert a lead, then lets the dialer take over from there and route the call to the next free agent.
Because the non-agent API can read and change real campaign data, you should treat it carefully. Use a dedicated API user with only the permissions it needs, restrict which addresses are allowed to call it, and never paste credentials into public scripts or shared documents. Used well, it quietly keeps your lists fresh and your reports flowing into whatever dashboard your team already watches, with no manual exporting and importing at all.
Related terms
Agent API
A set of VICIdial URL commands that control an agent's session from outside the screen, letting you pause, dial, hang up, or set a disposition programmatically.
CRM
A CRM (customer relationship management system) stores your contact and deal records; VICIdial can hand calls to it or pull data from it through links and the API.
Lead
A single contact record in VICIdial holding a phone number plus fields like name and address, the basic unit your campaigns dial.
Lead loader
The VICIdial tool that imports a file of phone numbers and contact data into a list, mapping each column to the right database field.
URL (in VICIdial)
A web address VICIdial can open automatically during a call, usually to pop a customer record or pass data to an outside system.
Webhook
An automatic HTTP message VICIdial sends to a URL you choose when something happens, so an outside system learns about an event without polling for it.