The operator's perspective.
On VICIdial, SIP, and call-center ops.
7-day free trial · Cancel anytime · Pay with card, PayPal, or USDT
Page 16
Operator writing, sorted newest first.
Reading the dial hopper with hopper_list
Pull the live contents of a campaign's dial hopper, lead by lead, with the hopper_list API call.
How to feed the dial hopper with hopper_bulk_insert
Push a batch of lead_ids straight into the dial hopper from one API call, with priority and local-time checks.
Editing a phone group with update_phone_alias
Change or delete an existing phone alias over HTTP with update_phone_alias. Required fields, the delete_alias flag, permissions, and responses.
How to create an inbound DID with the add_did API
Create an inbound DID and route it to an in-group, extension or call menu over HTTP with the VICIdial add_did API function.
How to register a SIP phone with the add_phone API
Use the add_phone API to create a SIP extension on your VICIdial server from code instead of clicking through the admin screen.
Exporting inbound-call logs with did_log_export
Pull a single day of inbound calls to a DID with the did_log_export API function — required fields, output format, permissions, and errors.
Reading a list's details with list_info
Pull a lead list's name, campaign, active flag and lead counts straight from VICIdial with the list_info API function.
Editing campaign dial presets with update_presets
Add, edit, list or delete a campaign's quick-dial presets over HTTP using the VICIdial update_presets API function.
Moving a lead back from the archive with lead_dearchive
A walkthrough of the lead_dearchive non-agent API, which pulls one lead out of the VICIdial archive table and back into the active list.
Reading VICIdial server graphs for beginners
A plain-English walkthrough of the four graphs on the VICIdial Server Performance Report and what each line is really telling you.
Deleting and resetting leads with update_lead options
The update_lead call does more than edit fields: it can delete a lead, wipe its custom data, or reset its called flag so the campaign dials it again.
How to set custom fields when you add a lead by API
Turn on custom_fields in the add_lead call and pass your own list-specific data alongside the standard name and phone fields.
Reading an agent's settings with user_details
A short guide to the user_details non-agent API call: what it returns, the permissions it needs, and when to use it over agent_status.
How to change a call's status with update_log_entry
A short guide to using the update_log_entry non-agent API to correct the status on a single call log record in VICIdial.
How to call the VICIdial Non-Agent API over HTTP
A plain walkthrough of building your first VICIdial Non-Agent API call: the URL, the required parameters, and a working example you can paste into a browser.
How to update many leads at once with batch_update_lead
The batch_update_lead call applies one set of field values to a comma-separated list of lead IDs in a single request, ideal for bulk changes.
Adjusting remote-agent lines with update_remote_agent
How to use the update_remote_agent non-agent API call to change a remote agent's line count, campaign, and active status from a script.
How to spot capacity problems before they hit your agents
Use VICIdial's performance graphs and 30-day stats to catch a server running out of headroom before agents start hearing lag and dropped calls.
How to read VICIdial API SUCCESS and ERROR responses
VICIdial API replies are plain text starting with SUCCESS, ERROR, or NOTICE. Here is how to parse them so your code knows what happened.
Pulling a full lead record with lead_all_info
How to use the lead_all_info non-agent API to read every field of a VICIdial lead, including custom fields, from your own app.
How to change an existing lead with the update_lead API
Use the update_lead Non-Agent API call to edit a lead in place, match it by lead ID, vendor code, or phone number, and write back changed fields.
The VICIdial API and AGI guide: every way to integrate VICIdial with outside systems
A beginner map of how VICIdial talks to outside systems: the non-agent API, the agent API, and AGI dialplan scripts, with links to deeper guides.
The Non-Agent API vs the Agent API: which one you need
VICIdial ships two HTTP APIs that look alike but do different jobs. Here is how to tell them apart and pick the right endpoint for your task.
How to change agent settings with the update_user API
A walkthrough of the update_user non-agent API call, the fields it can change, the permissions it needs, and the responses it returns.