The operator's perspective.
On VICIdial, SIP, and call-center ops.
7-day free trial · Cancel anytime · Pay with card or USDT
Page 16
Operator writing, sorted newest first.
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.
Pulling every call to a number with phone_number_log
Export every inbound and outbound call placed to one or more phone numbers with the phone_number_log API - fields, filters, and the indexing caveat.
Exporting agent stats with agent_stats_export
Pull agent activity statistics for a date range with the agent_stats_export API - talk time, pauses, sessions, and per-campaign grouping.
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.
Validating a number before dialing with check_phone_number
Check that a phone number is the right length, in a dialable area code, and not on a DNC list before you dial it.
Changing a registered phone with update_phone
Edit or delete an existing extension over HTTP with the update_phone Non-Agent API function, including required fields, permissions, and responses.
Finding a call recording with the recording_lookup API
Use the recording_lookup function on the Non-Agent API to find call recording URLs by agent, date, or lead id, with format and permission notes.
Listing your campaigns with campaigns_list
Dump every campaign's ID, dial method, dial level and dial prefix in one read-only call with the VICIdial campaigns_list API.
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.
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.
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.
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.
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.
API user levels and permissions explained
Why some VICIdial API calls return a permission error and others do not, and how user_level plus a few checkboxes decide what each account can do.
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.
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.
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.
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.
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.
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.
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.
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 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.
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.