The operator's perspective.
On VICIdial, SIP, and call-center ops.
7-day free trial · Cancel anytime · Pay with card or USDT
Page 17
Operator writing, sorted newest first.
Removing a number from DNC with delete_dnc_phone
Call the delete_dnc_phone API to pull a phone number back off a campaign or internal DNC list when it was added by mistake.
Cloning a DID with copy_did
Duplicate an existing inbound DID's routing onto one or more new numbers in a single API call with copy_did.
Reading live call-status counts with call_status_stats
Get per-campaign and per-ingroup call counts with hourly and status breakdowns from the call_status_stats API - fields, filters, and output format.
How to add a number to the DNC list with add_dnc_phone
Use the add_dnc_phone API to push a phone number onto a campaign or internal DNC list without opening the admin screen.
How to create a calling list with the add_list API
Create a new VICIdial calling list over HTTP with the add_list function. Required fields, optional settings, copying custom fields, and responses.
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.
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.
Cloning an agent account with copy_user
How to use the copy_user non-agent API to clone an existing VICIdial agent account to a new login in one call.
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.
How to create an agent account with the add_user API
A step-by-step guide to the add_user non-agent API, which creates a new VICIdial agent account from your own application.
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.
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 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 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.
What to watch on your VICIdial server every day
A short daily routine for VICIdial: the four numbers and one report that tell you whether your dialer is healthy before agents log in.
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.
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.
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.
What the API source parameter is for
Every VICIdial API call takes a source parameter. It does not change behavior, but it is the label that makes your API logs readable.
How to secure the VICIdial API with HTTPS and a dedicated user
Two simple steps protect your VICIdial API: serve it over HTTPS so credentials are not exposed, and call it from a narrow, purpose-built user account.
Looking up leads from your app with lead_search
How to use the lead_search non-agent API to find lead IDs by phone number from your own application or CRM.
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.
Stopping duplicate leads with add_lead duplication checks
How the add_lead duplicate_check options keep the same number from landing in your dialer twice, with the scope flags and X-day variants explained.
How to push a lead into VICIdial with the add_lead API
A walkthrough of the add_lead Non-Agent API call: required fields, an example HTTP request, and how to drop a new lead into a dialing list.