Posted by kingasterisk

A VICIdial AI call summary layer solves a problem: it takes the recording VICIdial already produces and turns it into a short written recap that sits next to the lead, without changing how agents dial or how campaigns are built.

A supervisor running an outbound campaign with a few hundred leads a day does not have time to sit through every recorded call. Agents move from one conversation to the next, notes get shorter as a shift wears on, and by the time a lead needs a follow-up call, nobody quite remembers what was actually said the first time.

This guide walks through what that setup looks like in practice, how it fits into a VICIdial and Asterisk install, and where it runs into the same kind of configuration and data questions that come up with any custom addition to a dialer.

What is the purpose of VICIdial

VICIdial is an open source contact center platform built on Asterisk. It handles outbound dialing (predictive, progressive, or manual), inbound queues, campaign management, agent screens, and reporting, and it stores everything in a MySQL or MariaDB backend. A campaign like US_SOLAR ties together a lead list, a set of dial rules, and a group of agents; the hopper pulls leads from the list, Asterisk originates the call, and the agent’s screen updates once a call connects.

Because the whole system is open, teams add their own layers on top of it all the time, whether that is a custom lead field, a webhook into a CRM, or, in this case, a summary written back into the lead record after each call ends.

Why call summaries matter as campaigns scale

A single agent handling calls all day generates dozens of recordings. Multiply that across five, ten, or fifty agents, and a supervisor reviewing conversations for quality or compliance is choosing between listening to a small sample and missing everything else, or falling permanently behind. 

A written summary attached to each lead gives a supervisor something they can scan in a few seconds, and it gives the next agent who picks up that lead a starting point instead of a blank slate.

It also helps close the loop on details that live only inside the conversation itself: a customer’s stated preference, an objection raised, or a date they asked to be called back. Right now, that information exists only as audio unless someone writes it down.

How a VICIdial AI call summary pipeline actually works

The pieces already exist in a standard VICIdial and Asterisk install. Adding a summary layer means connecting them rather than replacing them.

Asterisk records the call, typically through MixMonitor, and writes the audio file to the recording path defined in the campaign. VICIdial logs the call metadata separately: lead ID, campaign, start and end time, length in seconds, and the termination reason, in tables such as vicidial_log and vicidial_close_call_log. Neither of those steps needs to change.

What gets added is a small process that watches for newly closed calls, either by polling those log tables on an interval or by triggering off the agent’s disposition event. When a call closes, that process picks up the matching recording file, sends it to a transcription and summarization service, and waits for a short text summary back. 

That summary is then written into a custom lead field, so it shows up on the same lead screen an agent already uses, right next to the phone number and disposition history.

None of this touches the SIP trunk, the PJSIP configuration, or the dial plan. The summary layer sits alongside the call flow and reads from it after the fact, which keeps it low risk to add to a live campaign

Setting up an AI call summary layer on your VICIdial install

A rollout that avoids disrupting live campaigns usually follows this order.

• Confirm the database schema version matches your VICIdial release and that lead import and dialing are both working normally before adding a new dependency on top.
• Add a custom lead field for the summary text so it renders on the standard lead view without a separate screen.
• Build a script that watches vicidial_log or vicidial_close_call_log for calls that have just closed, keyed by lead ID and call date.
• Route the matching recording to a transcription and summarization endpoint of your choice.
• Write the returned summary back to the lead record with a scheduled database update.
• Pilot on a single campaign with a small agent group before turning it on everywhere.

How to monitor calls on VICIdial

VICIdial’s built-in monitoring covers a different need: watching a call as it happens. From the admin or supervisor screen, a manager can listen in on a live agent, whisper coaching to the agent without the customer hearing, or barge in and join the conversation directly. The live agent screen shows each agent’s current status and campaign in real time, which is where a supervisor decides who to monitor next.

A call summary does not replace that. It picks up after the call ends, giving a supervisor a written record to check without needing to have been listening at the time. Teams that use both together tend to reserve live monitoring for coaching in the moment and use summaries for after-the-fact review and lead handoffs.

Is AI calling illegal?

Summarizing a call is not illegal on its own, but it inherits the same rules that already apply to recording the call in the first place. Many places require some form of consent before a conversation is recorded, and that requirement does not disappear because the recording is later summarized rather than played back in full. 

Some jurisdictions require both parties to agree to recording, others only require one party to know, and outbound campaigns calling across state or country lines can be subject to more than one set of rules at once.

A campaign like US_SOLAR calling into the USA, for example, sits under different disclosure requirements than a domestic US campaign would. Before adding any summarization step, it is worth checking recording consent rules for every region a campaign touches, disclosing the recording to customers as required, and confirming with legal counsel how long summaries and recordings can be retained.

What to look for in AI call summary services for virtual receptionists

Virtual receptionist services and stand-alone summarization tools vary quite a bit in how well they actually fit onto an existing dialer. A few things are worth checking before picking one.

• Accuracy on real call audio, including accents, background noise, and crosstalk, not just clean sample recordings.
• A plain API or webhook interface, so it can plug into a script rather than requiring agents to change screens.
• Clear data retention and deletion policies for both the audio and the resulting text.
• Reasonable turnaround time between a call ending and a summary being available.
• Per-minute or per-call pricing that scales sensibly with actual call volume.

Services built specifically for virtual receptionists are often tuned for short, single-topic calls. An outbound sales or collections conversation runs longer and covers more ground, so it is worth testing any service against a handful of real recordings from your own campaigns before committing to it.

Pairing AI Asterisk tooling for a fuller setup

Some teams choose to connect a transcription or summarization tool directly to Asterisk, through AGI or ARI, rather than through VICIdial’s own lead and campaign tables. That approach can make sense for larger, multi-application Asterisk deployments where VICIdial is only one of several things running on top of the same telephony layer. 

For a single-platform VICIdial setup, working through the lead and log tables, as described above, is usually the simpler path and keeps the summary logic close to the campaign data it is meant to support.

Getting a VICIdial sign up going

There is no online sign up form for VICIdial itself, since it is open source software you install on your own server rather than a subscription you activate. Getting started means either building the install yourself, following the standard Debian and Asterisk setup steps, and configuring campaigns and agents from there, or working with a provider who sets up and configures the platform for you as a project. 

Either route ends at the same place: a working VICIdial instance with campaigns, agents, and a database schema you can then extend with additions like an AI call summary layer.

Frequently Asked Questions

Ready to add call summaries to your VICIdial setup

Turning recorded calls into short, useful summaries is one of the more contained additions you can make to a VICIdial install, since it works alongside the existing dialer and database rather than replacing anything. 

If you want help scoping a call summary layer, checking your schema and campaign configuration first, or choosing a summarization service that fits your call volume, KingAsterisk works with VICIdial and Asterisk deployments on exactly this kind of project.

A VICIdial lead import system failure almost always looks the same from the outside: the upload screen confirms the file went through, the list detail page shows no change in lead count, and agents log in to an empty hopper with nothing to dial. For teams running outbound campaigns in Australia and other regions with non-US numbering formats, this is one of the most frequent VICIdial support tickets KingAsterisk receives, and in the overwhelming majority of cases the server is fine. 

The real cause sits inside VICIdial’s lead-load validation logic, which rejects rows before they ever reach the vicidial_list table and reports the rejection as a BAD-PHONE error.

This guide walks through reproducing the failure step by step, reading the validation output correctly, fixing the phone number formatting and field mapping that trigger it, resetting and reuploading leads safely, and confirming leads are reaching the dialer hopper once the import itself is fixed.

How the failure typically shows up

Before troubleshooting anything, confirm the pattern matches what VICIdial Lead Import System Failure actually does when phone validation rejects a batch. The reported symptoms usually include:

• CSV uploads appear successful on screen, but no leads land in the target list.
• The import process reports a BAD-PHONE validation error against some or all rows.
• The upload completes without any leads being inserted, and the list’s lead count does not move.
• The same result happens across different file formats and phone number layouts, ruling out a one-off formatting mistake.
• Testing across multiple CSV structures still points back to the lead-import and phone-number validation step, not the file transfer itself.

The clearest evidence is the lead count itself. If the list’s total stays flat after several import attempts, the upload is completed but insertion is failing silently at the validation layer, which is exactly what a BAD-PHONE rejection looks like from the admin panel.

Reproducing the fault step by step

Walking through the failure end to end makes the validation behaviour visible rather than assumed. The sequence below mirrors what KingAsterisk’s support team runs on every lead-import ticket.

Step 1: Open the load new leads screen

From Admin, go to Lists, select the target list, and open Load New Leads. This screen accepts the CSV, lets you map fields, and shows the import summary once processing finishes.

Step 2: Submit without a file attached

Clicking submit without selecting a CSV returns ERROR: No file uploaded. This confirms the form itself is functioning and rules out a broken submit action before moving to real data.

Step 3: Upload a correctly formatted CSV

With a properly structured file – clean header row, phone_number in the expected format, correct list and campaign selected – the import completes and the summary reports the number of leads inserted, updated, and rejected.

Step 4: Upload a deliberately malformed CSV

Reintroducing a bad phone number format, an extra delimiter, or a shifted column reproduces the BAD-PHONE rejection. The import summary reports rows rejected for phone validation instead of leads inserted, even though the upload itself completes without an error page.

Step 5: Re-upload the same file

Uploading the identical file a second time, without changing vendor_lead_code or resetting the list, returns an already-imported result rather than a fresh insert. This is VICIdial’s duplicate check working correctly, not a second failure.

What actually triggers the BAD-PHONE error

VICIdial validates phone_number during the load process before a row ever reaches the database. A row fails validation, and is reported as BAD-PHONE, for any of the following reasons:

• The number contains letters, spaces, brackets, dashes, or a leading plus sign that was not stripped before upload.
• The digit count falls outside the length VICIdial Lead Import System Failure expects for the configured numbering plan, which defaults to North American 10-digit formatting unless changed.
• The area code or prefix is not present in the system’s reference table, which matters for deployments serving Australian or other non-US number ranges running on default settings.
• The phone_number column is empty for that row because a header mismatch shifted data into the wrong field during mapping.

This last point explains why the same CSV can pass on one list and fail on another. If the column order in the file does not match the field mapping selected on the upload screen, VICIdial system reads a name, an address, or a blank cell as the phone number and rejects the row, even though the actual phone data further along the row is perfectly valid.

How to reboot VICIdial Lead Import System Failure Correctly

Most lead-import and hopper issues do not require a reboot, but a stalled dialer process occasionally does. Restart individual services rather than the full server where possible:

systemctl status mariadb
systemctl restart mariadb
systemctl restart httpd
systemctl restart asterisk

systemctl status mariadb
systemctl restart mariadb
systemctl restart httpd
systemctl restart asterisk

If the predictive dialing process itself has stalled rather than a background service, reconnect to its screen session (commonly astguiclient or AST_VDauto_predictive) and restart it from there rather than rebooting the whole machine. A full server reboot is only necessary after kernel or package updates, or when a service will not come back cleanly through systemctl. 

On an AlmaLinux deployment with a dedicated IP, confirm the reboot window with whoever manages the client-side server access before restarting, since it will drop any live calls in progress.

Related fault: manual dialing not responding after a lead import

A second issue sometimes surfaces around the same time as an import failure and gets mistaken for the same root cause: an agent logs in successfully, sees the Dial Next Number button, clicks it, and nothing happens – no outbound call, no screen update, no Asterisk origination. A quick database check confirms whether the agent session itself is the problem:

SELECT user, status, campaign_id
FROM vicidial_live_agents;
Returns:
TEST_AGENT | PAUSED | SAMPLE_CAMPAIGN
A PAUSED status blocks manual dial actions even though the button remains clickable in the interface. Combined with the campaign's dial level setting:
Campaign: SAMPLE_CAMPAIGN
auto_dial_level=0

SELECT user, status, campaign_id
FROM vicidial_live_agents;
Returns:
TEST_AGENT | PAUSED | SAMPLE_CAMPAIGN
A PAUSED status blocks manual dial actions even though the button remains clickable in the interface. Combined with the campaign's dial level setting:
Campaign: SAMPLE_CAMPAIGN
auto_dial_level=0

This points to the agent session, not the lead data, as the cause. auto_dial_level=0 is the expected setting for manual dialing campaigns, so the fix is clearing the paused state and confirming the agent’s phone extension is registered, rather than re-checking the leads that were just imported.

Automating lead delivery so this stops recurring

Teams that hit BAD-PHONE errors repeatedly on manual CSV uploads are usually better served moving recurring feeds to a script-driven import through KingAsterisk’s REST integration layer, which returns a structured validation response instead of a generic upload summary. A lead import request looks like this:

POST /api/v1/leads
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "data": {
    "clientReferenceId": "CRM500001",
    "phoneNumber": "+18005551234",
    "firstName": "John",
    "listId": 1001,
    "campaignId": "OUTBOUND001",
    "vendorLeadCode": "RM10001"
  }
}
 
A rejected number returns a validation error naming the specific field and reason instead of a batch-level BAD-PHONE summary:
{
  "success": false,
  "code": 422,
  "message": "Validation Failed",
  "errors": [
    { "field": "phoneNumber", "message": "Phone Number is required." }
  ]
}
 

POST /api/v1/leads
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "data": {
    "clientReferenceId": "CRM500001",
    "phoneNumber": "+18005551234",
    "firstName": "John",
    "listId": 1001,
    "campaignId": "OUTBOUND001",
    "vendorLeadCode": "RM10001"
  }
}
 
A rejected number returns a validation error naming the specific field and reason instead of a batch-level BAD-PHONE summary:
{
  "success": false,
  "code": 422,
  "message": "Validation Failed",
  "errors": [
    { "field": "phoneNumber", "message": "Phone Number is required." }
  ]
}
 

and a lead that already exists returns a 409 duplicate response referencing the existing lead ID rather than silently discarding the row. For CRM-fed or vendor-fed campaigns running daily volumes, this level of per-record feedback catches formatting problems before they reach a hopper, which is a meaningfully faster diagnostic path than re-running a full CSV to find one bad column.

Frequently asked questions

Get lead import issues fixed properly

If BAD-PHONE errors, empty hoppers, or stalled manual dialing keep recurring on your VICIdial deployment, KingAsterisk Technologies can review your list configuration, phone validation settings, and campaign hopper filters directly, and set up a script-driven lead feed where manual CSV uploads are no longer practical. 

Reach out to discuss your current setup and get a fix that holds beyond the next upload.

If you’ve spent any time inside a stock VICIdial admin panel, you already know the feeling: dense tables, 2005-era form fields, and a navigation structure that hasn’t meaningfully changed in over a decade. That’s the exact gap KingAsterisk Technologies built its custom VICIdial admin themes to close. 

VICIdial’s underlying engine is rock solid – but the interface supervisors and administrators stare at for eight hours a day hasn’t kept pace with how contact centers actually operate in 2026. Every theme in this roundup is a proprietary, in-house build – not a community skin, not a third-party plugin, and not a repackaged open-source template. 

We design, code, and test each dashboard against live VICIdial and ViciBox deployments, then refine it based on direct feedback from supervisors managing real campaigns across industries like lead generation, appointment setting, collections, and customer support.

In this guide, we’re walking through the top 5 custom VICIdial admin themes currently available from KingAsterisk, what makes each one different, and how you can explore them yourself in our live demo environment before committing to a deployment.

Why a Custom VICIdial Admin Theme Actually Matters

It’s tempting to dismiss admin theming as cosmetic. It isn’t. A poorly organized dashboard adds seconds to every lookup a supervisor performs – and across hundreds of daily actions, that adds up to real lost floor time. A custom VICIdial admin theme changes three things that directly affect day-to-day operations:

Navigation speed – grouping campaign management, list management, and reporting into a logical, visual structure instead of VICIdial’s flat menu tree.

Onboarding time – new administrators and team leads learn a clean, modern layout faster than the stock interface’s dense forms.

Data legibility – real-time agent status, campaign statistics, and queue information are easier to scan at a glance, which matters most during peak call volume.

Brand consistency – for agencies and BPOs running the panel in front of clients, a themed dashboard looks like a purpose-built platform rather than an off-the-shelf install.

None of this changes VICIdial’s core dialing engine, campaign logic, or database structure. A custom admin theme is a presentation layer built on top of the existing VICIdial and Asterisk stack – the underlying system you already know still does the work.

The Top 5 Custom VICIdial Admin Themes from KingAsterisk

All five of these dashboards are custom VICIdial admin themes designed and maintained by KingAsterisk. Four are English-language administration interfaces built around different operational priorities. The fifth is a dedicated German-language dashboard, built for teams operating in DACH-region deployments who need the admin panel itself – not just campaign scripts – presented in German.

The Streamlined Operations Theme

This one is the entry point for teams moving off the stock VICIdial interface for the first time. It restructures the default admin menu into a card-based navigation layout, with campaign management, list management, and user administration grouped into clearly labeled sections instead of a long left-hand tree.

This theme keeps every native VICIdial function in place – nothing is hidden or removed – but reorganizes the visual hierarchy so the most frequently used screens (live agent status, campaign configuration, and lead search) sit one click from the home dashboard instead of three or four.

Best suited for: smaller teams and agencies making their first move to a custom admin theme without wanting to relearn where anything lives.

The Real-Time Monitoring Theme

The real-time monitoring theme is built for supervisors who spend most of their day watching live queues rather than running reports. The dashboard opens directly into a real-time monitoring view showing agent status, live call counts, and queue depth across active campaigns, refreshed continuously rather than requiring a manual page reload.

It also incorporates an Auto-Attendant management panel, giving administrators a visual editor for call-routing logic instead of navigating raw menu configuration screens. Routing rules, time-based conditions, and department transfers can be reviewed and adjusted from a single screen, which meaningfully cuts down the time it takes to update inbound routing during shift changes or campaign launches.

Best suited for: floor supervisors and operations managers who need at-a-glance visibility into live activity, and teams that frequently adjust inbound routing.

The Conversation Intelligence Theme

The conversation intelligence theme is built around post-call visibility. Alongside the standard VICIdial disposition and recording tools, this theme layers in a sentiment analysis module that flags calls likely to need supervisor review – tone shifts, extended silence, or abrupt call endings – without requiring a manager to listen to every recording end-to-end.

The sentiment view sits alongside disposition data and campaign statistics on the same dashboard, so quality assurance teams can move from a flagged call straight into the relevant lead record and agent history without switching screens.

Best suited for: quality assurance teams, coaching-focused supervisors, and campaigns where conversation quality directly affects conversion or compliance.

The Productivity Theme

The productivity theme is designed around after-call workflow speed. Its standout addition is a call summarization panel that condenses each completed call into a short, structured summary – key discussion points, disposition reasoning, and any follow-up flagged by the agent – displayed directly in the lead history.

For campaigns with high call volume and tight after-call work targets, this cuts down the time supervisors spend reconstructing what happened on a call from raw recordings or agent notes alone, particularly useful when handing a lead off between shifts or agents.

Best suited for: high-volume outbound campaigns, appointment-setting teams, and any operation where fast lead handoffs matter.

The German-Language Dashboard

The German Theme is the only theme in this list built as a fully localized German-language administration panel – menu labels, form fields, report headers, and system messages are presented natively in German rather than relying on a browser-level translation layer. This is the theme we deploy for clients running DACH-region operations who need administrators to work in their own language, not just agents.

This theme also includes a predictive analytics module, surfacing forward-looking indicators such as projected list exhaustion, expected connect rates for the remainder of a shift, and campaign pacing trends – presented as simple visual indicators rather than raw statistical output, so administrators can act on them without needing a background in data analysis.

Best suited for: contact centers operating in German-speaking regions, and any deployment where administrator-level localization is a requirement rather than a nice-to-have.

How KingAsterisk Builds Every Custom Theme

A custom VICIdial admin theme isn’t a drop-in skin – VICIdial installations vary enough in the ViciBox version and SVN codebase revision that a theme built for one environment can break on another if it isn’t matched correctly. Our build process accounts for that from the start.

Step 1: Environment Assessment

Before development starts, we confirm two details from your existing setup: your ViciBox version and your SVN (VICIdial codebase) revision. These determine which theme structure and file paths we can safely build against.

Step 2: Custom Development

The theme is developed specifically for your environment – not adapted from a generic template. Depending on the project, this can include a modern interface layer, updated dashboard components, and campaign management tooling built on top of your existing VICIdial installation.

Step 3: Delivery

Once development is complete, you have two options: we provide the source code and installation steps for your own team to deploy, or you provide server access and we handle installation and configuration directly.

Step 4: Ongoing Support

Several support packages are available for post-installation needs, scoped to your environment and update frequency requirements – we can walk through the right fit once your ViciBox and SVN details are confirmed.

How to Explore These Themes on the Live Demo

Every theme above can be explored before deployment through the KingAsterisk demo portal. Here’s the process, using the Global Admin theme as an example:

• Visit kingasterisk.com and select Live Demo from the main navigation.
• This opens the demo portal at demo.kingasterisk.com, where each available theme is listed.
• Choose a theme – for example, Theme 5 for the German-language Global Admin dashboard.
• Click Admin to reach the themed login screen, located at a custom path such as
• demo.kingasterisk.com/theme-5/dialer/admin.php
• Enter the demo credentials provided on the login page and sign in to explore the full dashboard.

Once logged in, you can navigate the complete admin panel – campaign management, agent administration, lead and list management, real-time reporting, and system monitoring – all through the selected theme’s interface, with full underlying VICIdial functionality intact.

A Security Note on Custom Admin Panel Paths

One side benefit of a custom theme deployment worth mentioning: the admin login path itself changes. A standard VICIdial installation serves its admin panel at a predictable, publicly documented location. A KingAsterisk custom deployment instead serves the panel at a client-specific path – commonly something like /dialer/admin.php rather than the default /vicidial/admin.php – which can be adjusted further per project.

Frequently Asked Questions

Final Thoughts

The stock VICIdial admin panel gets the job done, but it wasn’t built with today’s contact center pace in mind. Whether your priority is faster navigation, real-time visibility, post-call intelligence, faster after-call summaries, or a fully localized German-language experience for your administrators, there’s a custom VICIdial admin theme built for that specific need – not a generic reskin applied after the fact.

If you’re ready to see how any of these five themes look against your own ViciBox and SVN environment, reach out to KingAsterisk Technologies to start with an environment assessment, or head straight to the live demo to explore them yourself.

KingAsterisk Technologies designs, develops, and deploys custom VICIdial, Asterisk, and dialer interface solutions for contact centers worldwide. For more on our development services, visit our contact page. 

If you administer a VICIdial environment, you have probably seen VICIdial Permission Error.  This exact message pops up on a user’s screen: “You Do Not Have Permission to View This Page.” 

It usually happens right after a new user is created, an agent is promoted to a supervisor role, or a User Group is copied from an existing template. The login itself works fine – the username and password are correct – but the moment that user clicks into a specific admin page, VICIdial blocks the screen outright.

This is not a bug. It is VICIdial’s permission system doing exactly what it was designed to do: gate every admin page behind a specific permission flag stored against the User Group and User Level. In this guide, we will break down what triggers the error, how to trace it back to the exact permission responsible, and how to fix VICIdial user permissions correctly – the same process our support team follows when clients report this issue on their deployments.

What Does the VICIdial Permission Error Mean?

VICIdial’s admin interface is built as a large collection of individual PHP pages – one for managing users, one for campaigns, one for lists, one for each report, and so on. Every one of these pages runs a permission check at the very top of the script, before any data or form loads. That check looks at two things stored in the vicidial_users and vicidial_user_groups tables: the logged-in user’s User Level, and the specific permission flags attached to that user’s User Group.

When the check passes, the page renders normally. When it fails, VICIdial stops execution immediately and prints the message: “You Do Not Have Permission to View This Page.” No data is shown, no partial page loads – the script exits as soon as the permission check returns false.

This distinction matters for troubleshooting. A login failure means the username or password is wrong, and the user never reaches the dashboard at all. 

A permission error means authentication succeeded – the user is genuinely logged in – but authorization failed for that particular page. The fix, therefore, is never about resetting a password. It is about locating and correcting the specific permission flag tied to the page the user is trying to open.

How to Identify the Permission Causing the Error

Every admin page in VICIdial is mapped to a corresponding permission field inside the User Group configuration (and in some cases, an individual toggle on the User record itself). These fields store a simple binary value.

Permission Value 1 – Page Accessible

When the relevant permission field is set to 1, the permission check passes and the page loads exactly as expected. For example, if “Modify Campaigns” is set to 1 for a User Group, any user in that group can open the campaign editing screen without issue.

Permission Value 0 – “You Do Not Have Permission to View This Page”

When that same field is set to 0, VICIdial blocks the page entirely and displays the error message. This is the exact behavior admins run into after cloning a restrictive User Group template, or after a manager account is downgraded without adjusting individual toggles.

To trace the correct field, match the page the user was trying to reach against its corresponding permission name in the User Group screen. Some of the most common mappings include:

• Admin – Users pages – controlled by Modify Users / Delete Users
• Admin – Campaigns pages – controlled by Modify Campaigns
• Admin – Lists / lead upload pages – controlled by Load Leads / Modify Lists
• Reports section (Agent Time, Call Detail, etc.) – controlled by View Reports plus the Allowed Reports list
• Any page under Admin – User Groups – controlled by Modify User Groups

Once you know which permission name corresponds to the blocked page, the fix is a straightforward edit inside that user’s User Group.

Step-by-Step: How to Fix the VICIdial User Permission

The steps below cover both a general permission fix and the more specific case of restricting a user to a single report – a very common request when a manager should only see Agent Time data and nothing else.

1. Log into the VICIdial admin panel using an account with sufficient User Level (typically Level 1, full administrator access).

2. Navigate to Admin – User Groups – Show User Groups.

3. Locate the User Group assigned to the affected user and click the Edit (Action) icon.

4. Scroll to the permission field that matches the blocked page (for example, Allowed Reports, Modify Campaigns, or Modify Lists) and change the value from 0 to 1.

5. If you are restricting access rather than opening it up – for example, giving a manager visibility into only the Agent Time Detail Report – create a dedicated User Group first (e.g., REPORT_USERS), then set Allowed Reports to only the report you want visible.

6. Create or edit the User record under Admin – Users. Assign the correct User Group, set User Level to 7 or 8 for report-only access, and set View Reports = 1 while leaving Modify Users, Modify Campaigns, Modify Lists, Delete Users, and Load Leads at 0.

7. If report visibility should also be limited by team, configure Allowed User Groups inside the User Group settings so the group can only see report data belonging to specific other groups.

8. Click Save Changes to commit the updated permission set.

This combination – User Level, User Group, View Reports, and Allowed Reports – is how VICIdial layers access control. Getting all four aligned is what separates a user who can see everything from one who can see exactly one report and nothing else.

How to Test the Permission After Making Changes

Permission changes in the VICIdial solution are not applied to an already-open session. The permission set is read once, at login, and cached for that session. Always have the affected user log out completely and log back in before assuming a fix has failed.

• Log in as the affected user (or ask them to) in a fresh browser session or private window.
• Navigate directly to the page that previously triggered the error.
• Confirm the page now loads and displays data as expected.
• If the report-only scenario was configured, confirm that only the intended report appears and that other admin menu items remain hidden.
• If the error persists, double-check that the user is actually assigned to the updated User Group – not a similarly named group left over from a previous setup.

Common VICIdial Permission Issues

Most permission errors trace back to one of a small handful of causes:

User assigned to the wrong User Group – the permission was fixed on one group, but the user’s account still points to a different one.

User Level too low – some pages require a minimum User Level regardless of what the User Group allows, so both gates need to agree.

Stale session – the user tested the page without logging out first, so the old cached permission set was still active.

Custom admin panel paths – on customized deployments the admin interface may live at a different path (for example /dialer/admin.php instead of the standard /vicidial/admin.php); the underlying permission logic is identical, but it helps to confirm you are editing the correct environment.

Allowed Reports vs. general admin toggles confused with one another – restricting a report requires editing Allowed Reports specifically, not the general Modify permissions.

Allowed User Groups left unconfigured – the user has View Reports enabled but still cannot see data belonging to another team’s group.

Watch: Fixing the VICIdial Permission Error

This walkthrough shows the exact VICIdial permission error on screen and demonstrates the User Group fix in real time – useful if you’d rather watch the fix than read it.

Need Setup or Server Support?

If you are configuring User Groups, Allowed Reports, or a full permission structure on a new environment and want it set up correctly from the start, our team can assist with both the permission architecture and the underlying server environment.

Server Information

1. Hardware suggested based on your requirements
2. Intel and AMD hardware options available
3. Installation and configuration support
4. Compatible with multiple server environments

Important Note

• AlmaLinux server required from client side
• Dedicated IP required for setup
• Server access needed for installation
• Installation support provided

Frequently Asked Questions

Final Thoughts

The “You Do Not Have Permission to View This Page” message in VICIdial is a straightforward access-control response once you know where to look. Every blocked page maps back to a specific permission field inside the User Group or User configuration, and correcting it is a matter of locating that field, flipping it to the right value, and having the user log back in to pick up the change.

If your team manages multiple User Groups, custom admin panel builds, or a large agent roster and wants a permission structure that is easier to maintain long-term, KingAsterisk Technologies works with VICIdial and Asterisk environments on exactly this kind of configuration – from user access control to full custom admin panel builds. 

Reach out to our team to have your permission structure reviewed and set up correctly.

A VICIdial Responsive Theme platform is only as effective as the screen an agent looks at for eight or more hours a day. When that VICIdial screen fails to adapt to different monitors, laptops, or window sizes, it slows agents down, hides critical panels, and adds friction to every call. This is exactly the problem a custom theme is built to solve – a layout that adjusts intelligently to any resolution while keeping every dialing, scripting, and disposition tool exactly where an agent expects it.

In this guide, we break down what a VICIdial responsive theme actually is, why flexible agent interfaces matter more than ever for distributed teams, what to check before using a VICIdial responsive theme download or a VICIdial responsive theme GitHub repository, and how KingAsterisk Technologies approaches custom theme development for VICIdial deployments.

What Is a VICIdial Responsive Theme?

At its core, VICIdial ships with an agent screen and administration panel built on a traditional, fixed-layout structure. That structure works well on a standard desktop monitor, but it doesn’t automatically reflow when an agent switches to a smaller laptop, an ultrawide display, or a different browser zoom level.

A responsive theme replaces that rigid structure with a flexible grid system. Instead of hard-coded pixel widths, panels, buttons, and script windows are built using relative units and breakpoints, so the interface reorganizes itself based on the available screen space. The dial pad, call control buttons, lead information panel, disposition list, and script area all remain visible and usable, regardless of the device an agent is working from.

This is different from simply changing colors or fonts. A true responsive theme touches the underlying HTML and CSS structure of the agent screen, the layout grid, and often the JavaScript that governs how panels expand, collapse, or stack.

Why Agent Interfaces Need to Be Flexible

Dialer teams today rarely work from a single, uniform hardware setup. Agents log in from different monitor sizes, different operating systems, and increasingly from home-based workstations that were never standardized by an IT department. A fixed-width interface assumes a single ideal screen size – and breaks the moment reality doesn’t match that assumption.

Common problems with non-responsive dialer screens

• Script or CRM panels get cut off on smaller displays, forcing agents to scroll mid-call.
• Buttons for hold, transfer, or disposition shift position depending on browser zoom, causing mis-clicks.
• New agents need extra training time just to learn where controls ‘end up’ on their specific screen.
• Supervisors reviewing multiple agent screens side-by-side struggle when layouts don’t scale down cleanly.
• Remote or field-based agents on laptops experience a cramped, unusable version of the same interface a desktop agent sees comfortably.

A responsive theme removes these inconsistencies. The same underlying dialer logic runs identically for every agent – only the presentation adapts.

Core Building Blocks of a Responsive VICIdial Theme

1. A flexible grid layout

Rather than positioning elements at fixed pixel coordinates, a responsive theme organizes the agent screen into a grid of proportionally sized regions – call controls, lead data, script text, and disposition options. As screen width changes, these regions resize or stack in a predictable order instead of overlapping or disappearing.

2. Breakpoints for different screen classes

Breakpoints are the rules that tell the interface how to reorganize itself at specific screen widths – for example, a wide desktop monitor, a standard laptop, and a narrower browser window. A well-built theme defines breakpoints that keep every essential control reachable at each of these stages, without requiring horizontal scrolling.

3. Scalable typography and controls

Text sizing, button dimensions, and spacing are defined in relative units so they scale smoothly rather than becoming unreadably small or awkwardly oversized. This matters particularly for agents who work extended shifts and rely on quick visual scanning of lead details and script prompts.

4. Cross-device and cross-browser compatibility

A properly engineered theme is tested across the major browsers agents actually use, along with common operating system combinations, to confirm that call controls, real-time timers, and popup windows behave consistently everywhere.

5. Preserved core dialer functionality

Visual flexibility should never come at the cost of dialer performance. The underlying agent screen logic – call state handling, disposition submission, script rendering, and real-time status updates – needs to remain untouched while only the presentation layer is restructured.

VICIdial Responsive Theme Download: What to Check First

Many teams start their search by looking for a ready-made VICIdial responsive theme download or browsing a VICIdial responsive theme GitHub repository for community-built templates. Pre-built themes can be a reasonable starting point, but a few checks matter before installing one on a live system.

1. Version compatibility: Confirm the theme was built for your installed VICIdial and VICIBox version. Themes built for older releases can break newer agent screen scripts.

2. Codebase transparency: Review the source files before deployment. A theme pulled from a public GitHub repository should be readable, documented, and free of unnecessary external calls.

3. Update history: Check whether the repository is actively maintained. An abandoned project can leave security gaps as VICIdial itself continues to evolve.

4. Licensing terms: Confirm the theme’s license allows the kind of customization and redistribution your organization plans to do.

5. Testing on a staging environment: Never apply a downloaded theme directly to a production dialer. Test agent login, call handling, and disposition flows on a staging instance first.

For organizations that need guaranteed compatibility, dedicated support, and a theme built specifically around their campaign structure, a custom-built responsive theme is generally the safer long-term path compared with adapting a generic download.

How KingAsterisk Builds a Responsive Agent Theme

KingAsterisk Technologies develops custom VICIdial themes tailored to each client’s existing environment rather than applying a one-size-fits-all template. The process is structured around a few clear stages.

Step 1: Environment assessment

Development begins by confirming the client’s current ViciBox version and the underlying VICIdial codebase version. This ensures the responsive theme is engineered against the exact environment it will run on, rather than a generic baseline that may not match.

Step 2: Interface design and grid planning

The agent screen is mapped out region by region – call controls, script area, lead panel, disposition list – and rebuilt using a flexible grid with defined breakpoints. Where a client uses a modern front-end stack, this can include a React-based interface with a utility-first styling approach for faster iteration and consistent design tokens.

Step 3: Development and internal testing

The theme is built and tested across common screen sizes and browser combinations before being shared with the client, checking that every control agents rely on – hold, transfer, disposition, script navigation – remains accessible at each breakpoint.

Step 4: Delivery or managed installation

Depending on the client’s preference, KingAsterisk either delivers the completed source code and installation steps for the client’s own team to deploy, or completes the installation directly on client-provided server access.

Step 5: Post-launch support

Once a responsive theme is live, ongoing support options are available to handle future VICIdial updates, additional breakpoint tuning, or new panel requirements as a campaign structure evolves.

Server and Environment Requirements

Before any custom theme project begins, a few infrastructure basics need to be confirmed on the client side.

• Hardware recommendations are provided based on expected campaign volume, with support for both Intel and AMD server configurations.
• An AlmaLinux server is required from the client side, provisioned with a dedicated IP address.
• Server access is needed for installation and configuration once the theme has been finalized.
• Installation and configuration support is included as part of the deployment process.

Confirming these requirements early prevents delays once development work is complete and installation is ready to begin.

Agent and Administration Access Structure

On a standard VICIdial installation, agents typically log in through a dedicated agent screen path, separate from the administration dashboard used to manage campaigns, lists, and users. Custom theme deployments often use a distinct, client-specified path for both the agent interface and the administration panel, while the underlying authentication mechanism stays the same as a standard installation – only the file path and visual layout change.

Keeping this separation clear during theme development matters: the responsive treatment needs to be applied consistently to both the agent-facing screen and any administration view the theme touches, so supervisors and agents get the same reliable experience.

Common Pitfalls When Building or Installing a Responsive Theme

• Overriding core dialer scripts instead of layering theme changes on top, which makes future upgrades difficult.
• Skipping cross-browser testing and discovering layout issues only after agents are already live on the new theme.
• Using a downloaded theme without checking version compatibility against the current VICIdial and ViciBox release.
• Ignoring smaller breakpoints, so agents on laptops or narrower windows still end up scrolling.
• Not testing real call scenarios – hold, transfer, conference – after the visual layer has changed, since a theme change can sometimes affect how a script triggers UI updates.

Frequently Asked Questions

Final Thoughts

A responsive agent interface isn’t a cosmetic upgrade – it’s a practical fix for the everyday friction agents face when a fixed layout doesn’t match their actual screen. Whether a team starts by evaluating a VICIdial responsive theme download, exploring a VICIdial responsive theme GitHub project, or commissioning a fully custom build, the underlying goal is the same: keep every control an agent needs visible and consistent, no matter what device they’re logging in from.

KingAsterisk Technologies builds responsive and custom VICIdial themes matched to each client’s exact ViciBox and codebase version, from initial grid design through installation and ongoing support, so agent screens stay fast, consistent, and easy to train on as teams grow.

VICIdial user permission guide is one of the most underleveraged features in contact center administration – and one of the most consequential. If you run a busy VICIdial dialing operation with team leaders, supervisors, you need to think about leaving sensitive reports like the Agent Time Report. It opens to every user with admin credentials and is a security gap waiting to cause problems.

This guide walks you through the exact steps to lock down that report, control who sees what, and build a cleaner, more accountable permission structure across your VICIdial environment.

Understanding VICIdial’s Permission Architecture

VICIdial uses a hierarchical, role-based access model. Understanding this hierarchy is the starting point for any serious permission hardening work.

The system separates permissions into three broad categories: User-Level Settings (what the user can do at their own login), Admin Panel Access (which menu items and configuration pages are visible), and Report Access Controls (which data reports a user can pull and export). 

The Agent Time Report falls under that third category – and it contains detailed per-agent activity data that most roles simply should not see.

User Types Explained

• Admin: Full system access including all configuration, reports, and user management.
• Manager: Campaign-level visibility; can view reports tied to assigned campaigns.
• Agent: Restricted to the softphone interface; no admin panel access by default.
• Custom User: Configured manually – the most flexible and recommended approach for supervisors who need limited access.

What Is the Agent Time Report – and Why Restrict It?

The Agent Time Report is a built-in VICIdial report that tracks exactly how long each agent spent in different states – logged in, on a call, in a pause code, waiting, and so on. It is one of the most granular performance views available in the platform.

From a management standpoint, that granularity is valuable. From a data security standpoint, it is sensitive. If a junior supervisor or a team lead can export this report for all campaigns, they gain visibility into performance data for agents outside their scope – including potential pay-for-performance metrics, attendance records, and shift patterns.

Restricting access to this report ensures that only the right people – typically senior managers or reporting analysts – can run and export it. It also makes your operation cleaner for internal compliance reviews, where auditors will ask who had access to what and when.

How to Create a User in VICIdial

Before you can restrict access, you need users set up with the correct base roles. Here is the standard process for creating a new user through the admin panel.

Step-by-Step: Adding a New User

• Log in to the VICIdial Admin Panel using your administrator credentials.
• Navigate to Admin – Users from the top menu.
• Click ‘Add a New User’ at the top of the user list.
• Fill in the required fields: User ID, Password, Full Name, and User Level.
• Set the User Group – this is important as group membership can inherit shared permission settings.
• Under the ‘User Level’ dropdown, select the appropriate base level (1–9, where 9 is full admin).
• Scroll through the extended options to configure phone settings, campaign access, and allowed IPs if needed.
• Click Submit to save the new user.

User Level is a numeric scale, but do not confuse a higher number with unlimited access. The actual report and panel permissions are set through separate toggles lower on the same user configuration page – and those are what matter most for report restriction.

Assigning and Editing User Roles

Once a user exists in the system, you can return to their profile at any time to tighten or expand their permissions. This is done from Admin – Users – [select user] – Modify.

The key fields to pay attention to when controlling report access are:

• allowed_reports: A comma-delimited list of reports the user is allowed to run. Leave this blank to deny all, or list specific report names to whitelist only those.
• admin_hide_lead: Controls visibility of lead data columns.
• report_default_file_download: Determines whether the user can export report data to a file.
• user_group: Membership in a group that may have shared permission templates applied.

A common mistake is setting User Level to 8 or 9 and assuming the granular report fields below will auto-restrict. They will not – each report permission is independently toggled, which is exactly what gives you the control you need.

Step-by-Step: Restricting Access to the Agent Time Report

This is the core of the VICIdial user permission guide. Follow these steps precisely to remove Agent Time Report access from a specific user or role.

Step 1 – Identify the Target User or Group

Go to Admin – Users and locate the user whose access you want to restrict. If you manage a team of supervisors with identical permission needs, consider using a User Group so you can apply changes once and have them cascade to all group members.

Step 2 – Open the User Modify Page

Click Modify next to the user. This opens the full user configuration form. Scroll past the basic fields – phone, campaign assignment, and scheduling – until you reach the Reporting and Admin Options section.

Step 3 – Locate the Report Access Fields

Find the field labeled ‘allowed_reports’. By default, this may be set to ‘ALL’ or left empty, which in many configurations defaults to permissive access. You will change this to an explicit list that excludes the Agent Time Report.

Step 4 – Remove Agent Time Report from Allowed List

The Agent Time Report is identified in VICIdial’s report system as ‘agent_time’. Edit the allowed_reports field to include only the reports this user legitimately needs. Do not include ‘agent_time’ in the list. For example, if this user should only access the Campaign Report and Call Counts Report, your entry would look like: Campaign_stats,call_counts

Step 5 – Disable Report Export Permissions

Scroll down to ‘report_default_file_download’ and set it to 0 (disabled) for this user if you also want to prevent them from downloading any report data even for the reports they can view.

Step 6 – Save and Test

Click Submit to save changes. Log out, then log back in as the restricted user (use a test account) and confirm the Agent Time Report is no longer visible or accessible from the Reports menu. The menu item should either not appear or return an access denied message.

Real-World Use Case: Multi-Team Contact Center

Consider a contact center running three outbound sales campaigns simultaneously. The operation has a General Manager, three Campaign Supervisors, and roughly forty agents spread across shifts. The General Manager needs full reporting access – including Agent Time. Each Campaign Supervisor should only see data for their own campaign and should have no access to time-based performance data for agents outside their team.

Without proper permission control, a Campaign Supervisor logged in at User Level 7 could navigate to the Reports menu and pull Agent Time data for all forty agents – across all three campaigns. That is a data governance failure.

After applying the restriction method outlined in this guide, each supervisor’s ‘allowed_reports’ field is configured to include only campaign_stats and call_counts. The agent_time report is excluded. The General Manager’s account retains full report access as before. Result: clean data boundaries, no cross-team performance leakage, and a straightforward audit trail if compliance ever asks.

How to Log In to VICIdial and Verify Permission Changes

After applying any permission change, verification is a non-negotiable step. Here is how to do it cleanly.

Admin Login

• Navigate to your VICIdial server URL – typically http://[your-server-IP]/vicidial/admin.php
• Enter your admin username and password.
• You will land on the main admin dashboard from where all user management and reporting settings are accessible.

Testing as a Restricted User

• Open a private/incognito browser window to avoid session conflicts.
• Log in using the restricted user’s credentials at the same admin URL.
• Navigate to the Reports section and confirm the Agent Time Report is absent from the menu.
• Attempt to directly access the report URL (if you know it) – a correctly configured system will return an access denial.

If the report still appears, recheck the allowed_reports field – ensure there are no trailing spaces, that ‘agent_time’ is definitely absent, and that the user is not inheriting a permissive group policy that overrides the individual setting.

Frequently Asked Questions

Conclusion

A well-configured VICIdial user permission guide is not just an administrative checklist – it is a core part of running a secure, accountable contact center operation. Restricting the Agent Time Report to authorized users only protects sensitive performance data, reduces internal data exposure, and keeps your system audit-ready without limiting the productivity of the people who legitimately need reporting access.

The steps covered here – from creating users with proper roles, to editing allowed_reports, to testing permissions with a dedicated verification session – give you a repeatable process you can apply across every user type in your environment.

KingAsterisk’s engineering team can help you audit your current setup and implement a permission structure that scales. Reach out to us to discuss your specific deployment.

If you have spent any real time inside a stock Custom VICIdial Theme, you already know the tradeoff: the dialer engine is rock solid, but the default screens look and feel like they were built for a different decade. Agents squint at dense tables, supervisors click through five menus to find one report, and every “quick fix” to the VICIdial interface risks breaking something in the core codebase.

KingAsterisk built its new custom VICIdial theme to solve exactly that problem – without touching the dialer logic your contact center already depends on. The result is a modern, agent-friendly UI layer that sits on top of standard VICIdial, giving your team a cleaner workspace and giving your supervisors sharper visibility, while the underlying VICIdial/Asterisk engine keeps doing what it does best.

This post walks through what the new theme actually changes, how the development and installation process works, what your server needs to look like before we start, and answers to the questions we hear most often – including the ones around downloading, free versions, and GitHub.

Why the Default VICIdial UI Holds Teams Back

VICIdial’s open-source interface was designed for functionality, not for daily comfort. Over long shifts, that design gap shows up as real cost:

• Agent fatigue from dense, low-contrast screens that make it harder to track call status, scripts, and disposition options at a glance.
• Slower onboarding because new agents need extra training just to navigate menus that haven’t changed much in years.
• Supervisor blind spots when real-time monitoring and reporting are buried several clicks deep instead of visible on one screen.
• Brand inconsistency, since an unmodified VICIdial panel doesn’t reflect a modern, professional operation – something that matters when clients or auditors see the dashboard.

None of this is a flaw in VICIdial itself. It’s a UI problem, and UI problems have UI solutions.

What’s New in the KingAsterisk Custom VICIdial Theme

Our custom theme is built as a modern front-end layer, developed with contemporary web technologies rather than recycled legacy templates. Key elements include:

Modern, component-based front-end. 

We build custom interfaces using React-based components and Tailwind CSS, which allows for faster iteration, cleaner layouts, and consistent styling across every screen – agent, supervisor, and admin alike.

Redesigned agent workspace

Call controls, disposition buttons, scripts, and customer information are reorganized around the agent’s actual workflow, reducing the number of clicks needed during a live call.

Supervisor and real-time monitoring panels

Live call status, queue statistics, and agent activity are surfaced in cleaner, more scannable dashboards, so supervisors can spot problems as they happen instead of after a report runs.

Custom dashboards and campaign views

Campaign management, lead views, and list controls get a visual refresh that makes day-to-day administration faster for whoever is running the floor.

Responsive layout improvements. 

Screens are built to behave predictably across different monitor sizes and resolutions common in contact center environments.

Full VICIdial functionality preserved

This is the part that matters most: every core capability – campaign management, user and agent administration, lead and list management, inbound/outbound routing, real-time reporting, carrier and trunk configuration, call recording settings, CRM integrations, and system monitoring – remains fully intact underneath the new interface. You’re changing the skin, not the engine.

How Theme Development Works

Because every VICIdial deployment is a little different, theme development isn’t a one-size-fits-all download – it’s a scoped build against your specific environment. Here’s the process:

Step 1 – We confirm your environment. Before development starts, we need two pieces of information from your current setup:

• Your ViciBox version
• Your SVN (VICIdial codebase) version

These determine exactly how the theme needs to be built so it installs cleanly against what you’re already running, instead of fighting version mismatches later.

Step 2 – We scope timeline and cost. Once we’ve reviewed your ViciBox and SVN details, we provide a project timeline and cost estimate based on the scope of customization you need.

Step 3 – Development. The theme is built against your environment specifications, keeping all standard VICIdial functionality in place while applying the new interface layer.

Step 4 – Deployment, your way. After development is complete, you have two options:

• We share the source code and installation steps, and your team installs it, or
• You provide server access, and we handle installation and configuration directly.

Step 5 – Ongoing support. We offer multiple support packages for post-installation needs. If you want ongoing assistance after go-live, we’ll walk through the available options and recommend a fit based on your environment and support goals.

Server & Setup Requirements

A few infrastructure details matter before any custom theme work begins:

• Hardware: We suggest hardware configurations based on your specific requirements, with support for both Intel and AMD server options.
• Installation and configuration support: Provided throughout setup, not just handed off as documentation.
• Server compatibility: Our theme and installation process supports multiple server environments, including both Linux-based deployments generally and Ubuntu server environments specifically for VICIdial and contact center installations.
• Important note on OS: For custom theme installations, an AlmaLinux server with a dedicated IP is required from the client side, along with server access for our team to complete installation.

Getting these details confirmed upfront is what keeps the install timeline predictable – most delays in theme deployments come from mismatched server prep, not the theme build itself.

See It Before You Install It: KingAsterisk Live Demo

You don’t have to take any of this on faith. KingAsterisk runs a live demo portal so you can explore actual custom VICIdial themes – including the interface layouts – before committing to anything.

Step 1: Visit the KingAsterisk website. and locate the Live Demo option in the main navigation or promotional banner.

Step 2: Open the Live Demo portal, where you can browse the available custom VICIdial themes and interface layouts.

Step 3: Pick a theme. Browse the available designs – each retains full VICIdial functionality while offering a distinct look and workflow. For example, Theme 5 is a commonly explored option in the demo set.

Step 4: Open the admin login. Click Admin on your chosen theme to reach the custom admin panel login, typically at a path like: https://demo.kingasterisk.com/theme-5/dialer/admin.php 

Step 5: Log in with demo credentials. Use the demo credentials provided on the login screen (in our public demo environment, these are shown directly on the page) to access the dashboard.

Step 6: Explore the dashboard. From there you can click through campaign management, user and agent administration, lead and list management, routing, real-time reporting, and more – all inside the redesigned interface.

It’s worth noting that on custom theme installations, both the admin panel and agent interface paths can differ from the standard VICIdial layout. A default install typically serves the admin panel at /vicidial/admin.php and the agent screen at /vicidial/vicidial.php. 

On a custom deployment, you might instead see something like /dialer/admin.php for admin access and /agent/agent.php for the agent interface – the folder and file names can be adjusted based on your preference. The authentication mechanism underneath stays the same; only the file path changes.

The Productivity Case: What Actually Improves for Agents

It’s easy to talk about a “modern UI” in the abstract, so it’s worth being specific about where the time savings actually come from on a live floor.

Fewer Clicks Per Call

When disposition buttons, scripts, and customer details are laid out around the natural flow of a call instead of scattered across a legacy grid, agents spend less time hunting for the right control and more time actually talking to the customer.

Faster Visual Scanning

Contrast, spacing, and typography aren’t cosmetic details – they’re what let an agent glance at a screen mid-call and immediately register call status, queue position, or a pending callback without stopping to read carefully. Cleaner UI reduces the small daily friction that adds up across an eight-hour shift.

Shorter Ramp-up for New Hires 

Every hour a new agent spends learning where things are on the screen is an hour not spent handling calls. A more intuitive layout shortens that ramp-up period, which matters most in high-turnover environments like BPOs and seasonal campaigns.

Faster Supervisor Response Times

When real-time monitoring, queue statistics, and agent activity sit on a clean, scannable dashboard rather than buried in submenus, supervisors catch problems – a stalled queue, an agent stuck in an odd status – while they’re still small.

None of these gains require ripping out your dialer or retraining agents on new call logic. They come purely from removing the friction between the agent and the system they already know how to use.

Security Reminder for Any New Deployment

Whether you’re running a stock install or a custom-themed one, this bears repeating: default admin credentials are publicly documented and represent one of the highest-risk vulnerabilities in any fresh contact center deployment. Change both the username and password immediately after first login, through Admin – Users – Edit User, before the system goes anywhere near production traffic.

Frequently Asked Questions

Final Thoughts

A modern interface isn’t a cosmetic upgrade – it’s an operational one. Faster agent screens mean shorter handle times and less onboarding friction. Clearer supervisor dashboards mean problems get caught in minutes instead of at end-of-shift review. 

And because KingAsterisk’s custom VICIdial theme is built as a layer on top of your existing environment rather than a replacement for it, you get that improvement without retraining your team on a new dialer platform or risking the stability of your current setup.

If you want to see it before deciding anything, reach out to us. If you’re ready to scope a build for your own environment, the next step is simple: share your ViciBox and SVN version, and we’ll take it from there.

VICIdial API integration is the process of connecting VICIdial’s dialer engine to external applications – CRMs, ticketing platforms, IVR flows, and reporting tools – through secure REST API endpoints rather than direct database access. 

Many contact center teams know they need this kind of integration but aren’t sure which API type to use, how the wrapper layer works, or where the source code fits into the picture. By the end, you’ll know how to plan the setup from first principles, not guesswork.

Understanding VICIdial API Documentation

VICIdial API documentation is typically organized by functional categories rather than by endpoint alphabetically – lead management, campaign configuration, agent status, call history, and system monitoring each get their own section. Before writing any integration code, map out which category your project actually touches. 

A CRM screen-pop project, for example, only needs the call and lead endpoints; it has no reason to touch cluster or server status calls. Reading the documentation this way saves hours of unnecessary exploration.

Reading Endpoints the Right Way

Most VICIdial API integration examples you’ll find online demonstrate a single call in isolation – fetch a lead, update a disposition. Real integrations chain several calls together: a lead lookup, a status check, then a write-back. Treat each documented endpoint as one link in a longer chain, and plan the chain before you plan the code.

Protocol & Data Standards

Every request and response follows a consistent envelope, which is what makes the API predictable for CRM and lead-vendor developers integrating for the first time.

Agent API vs. Non-Agent API

This distinction trips up a lot of teams early on.

VICIdial Agent Login API

The agent login API tracks and manages an individual agent’s session state – login, pause, wrap-up, logout. It’s built for real-time agent-facing tools: softphone panels, custom agent dashboards, or supervisor monitoring screens that need to reflect what one specific agent is doing right now.

VICIdial Non-Agent API

The VICIdial non agent API operates independently of any logged-in agent session. It’s the layer used for background and administrative work: importing leads in bulk, pulling campaign statistics, checking DNC status, or syncing reporting data on a schedule. 

VICIdial non agent API documentation usually separates these calls specifically because they don’t require an active agent context, which makes them ideal for nightly batch jobs and external reporting systems. Mixing the two – for instance, trying to run bulk lead updates through an agent-session-bound call – is the single most common integration mistake we see.

Core VICIdial API Categories for Contact Centers

A complete integration spec organizes endpoints by function. Based on a real 102-endpoint VICIdial integration build, here’s how the categories typically break down.

Lead Management APIs

These handle the flow of leads into and out of VICIdial – importing from a CRM or lead vendor, checking status, and bulk updates. The Lead Import API (POST /api/v1/leads) is the most-used endpoint in almost every integration, since it’s the entry point for outbound dialing data.

Campaign, List, and Reporting APIs

Endpoints here expose campaign configuration, list inventory, and statistics – the data a client-facing dashboard or account manager needs without direct database access.

Agent Management APIs

This is where the VICIdial agent login API and related endpoints live – agent list, agent details, live agent status, performance metrics, skills, and login status. These power real-time agent monitoring dashboards and workforce management tools.

Call Management and Real-Time Control APIs

Call history, live calls, recordings, disposition and notes, plus real-time actions: originate, hangup, transfer, hold, mute, conference, whisper, and barge. These map directly onto Asterisk AMI actions under the hood.

Inbound, DNC, and Voicemail APIs

DID lists, inbound groups, callback management, and DNC (Do Not Call) lookups – critical for TCPA compliance in outbound campaigns.

System, Infrastructure, and AI Services APIs

Server and cluster status, database health, queue statistics, and (in more advanced builds) AI-driven call sentiment, keyword detection, auto-QA, and sales opportunity scoring.

A Real-World Integration Example

A 100-agent contact center migrating from a legacy dialer to VICIdial needed its proprietary CRM to pop the full customer record the moment a call connected. The build used the non-agent API for the overnight lead import from the CRM into VICIdial’s lists, and a lightweight listener on the call and lead endpoints to trigger the screen-pop in under a second after connect. Disposition data then flowed back through the same non-agent layer, keeping the CRM as the single source of truth without duplicating agent login logic.

Building a VICIdial API Wrapper

Calling raw endpoints directly across a large codebase gets messy fast – every developer ends up re-writing authentication headers and error handling. A VICIdial API wrapper solves this by centralizing token handling, retry logic, and response parsing behind a small set of internal functions your team actually calls. For most contact centers, a wrapper covering lead, call, and campaign endpoints handles 80% of integration needs and can be built and tested in under two weeks by a small development team.

Common Headers and Request/Response Structure

Every VICIdial API integration example follows the same request shape. Here’s the standard structure used across the specification:

Standard Request Envelope

json
{
    "requestId": "REQ-100001",
    "timestamp": "2026-07-15T11:00:00Z",
    "data": {}
}

json
{
    "requestId": "REQ-100001",
    "timestamp": "2026-07-15T11:00:00Z",
    "data": {}
}

Standard Success Response

json
{
    "success": true,
    "code": 200,
    "message": "Request Completed Successfully",
    "timestamp": "2026-07-15T11:05:10Z",
    "requestId": "REQ-100001",
    "data": {}
}

json
{
    "success": true,
    "code": 200,
    "message": "Request Completed Successfully",
    "timestamp": "2026-07-15T11:05:10Z",
    "requestId": "REQ-100001",
    "data": {}
}

Standard Error Response

json
{
    "success": false,
    "code": 422,
    "message": "Validation Failed",
    "timestamp": "2026-07-15T11:05:10Z",
    "requestId": "REQ-100001",
    "errors": [
        {
            "field": "phoneNumber",
            "message": "Phone Number is required."
        }
    ]
}

json
{
    "success": false,
    "code": 422,
    "message": "Validation Failed",
    "timestamp": "2026-07-15T11:05:10Z",
    "requestId": "REQ-100001",
    "errors": [
        {
            "field": "phoneNumber",
            "message": "Phone Number is required."
        }
    ]
}

Required headers on every call: Authorization (Bearer token), Content-Type: application/json, and Accept: application/json. 

Optional headers like X-Correlation-ID and X-Client-ID help trace requests across systems during debugging – invaluable once you have more than one CRM hitting the same dialer.

VICIdial Download and Source Code Basics

Before any integration work begins, it’s worth confirming which version you’re running. A VICIdial download from the official project gives you the base dialer, while the VICIDIAL source code repository lets you inspect exactly how agent sessions, campaigns, and the underlying database schema are structured – invaluable when an API response doesn’t match what the documentation describes. Reviewing the relevant source files ahead of a migration project avoids version-mismatch surprises once agents go live.

Frequently Asked Questions

Conclusion

Getting VICIdial API integration right comes down to picking the correct endpoint category for the job, wrapping those calls in a maintainable layer, and validating everything against the actual source code your instance runs on. 

Agent APIs handle live session states; non-agent APIs handle everything else. Get that split right, build a wrapper early, and most integration projects – from a single CRM screen-pop to a full multi-campaign migration – stay predictable from start to finish. 

2If you’re planning this kind of build for your contact center, our engineering team at KingAsterisk can walk through your setup and scope the work – contact us to get started.

Running VICIdial scheduled outbound calls at 500 or more connections per hour is an achievable benchmark for any well-configured contact center operation – but reaching it consistently requires more than pressing a Start button on a campaign. It demands a precise combination of hopper sizing, Vicidial dialing mode selection, trunk capacity, and real-time reporting feedback. 

This guide walks through every layer of that configuration, from first-time campaign setup to backend API automation, so your team stops leaving dial capacity on the table.

Is VICIdial a Dialer? Understanding the Platform at Scale

VICIdial is a full-featured, open-source contact center suite built on the Asterisk telephony engine. It combines an outbound auto-dialer, an inbound ACD queue manager, a real-time agent interface, a campaign configuration layer, and a suite of reporting tools into a single system. So yes – VICIdial is a dialer, but calling it only that significantly undersells its role in day-to-day operations.

When configured for high-volume scheduled outbound work, VICIdial manages the entire dial cycle: pulling leads from a hopper queue, connecting answered calls to available agents, detecting answering machines via AMD, logging dispositions, and recycling uncompleted leads back through the queue – all without manual intervention. At scale, a properly sized VICIdial server can sustain well over 500 outbound call attempts per hour per campaign, with multiple campaigns running simultaneously across different agent groups.

What Are the Types of Outbound Calls in VICIdial?

VICIdial supports three primary outbound dialing modes. Understanding which mode fits your operation is the single most impactful configuration decision you will make:

Predictive Dialing

The system dials multiple lines simultaneously per available agent, using a statistical algorithm to estimate when an agent will finish their current call. It adjusts the dial ratio in real time based on drop rate and answer rate. This mode is built for high-volume operations where maximizing agent talk time is the primary goal. At 500+ calls per hour, predictive mode is almost always the correct choice.

Power Dialing

The system dials one call per available agent slot. There is no statistical overdial – when a call connects, it reaches an agent immediately. Power mode offers tighter compliance control at the cost of slightly lower throughput. Teams operating under strict answer-supervision requirements often prefer it.

Progressive Dialing

Similar to power dialing but the call is only placed after the agent is confirmed available. This mode generates the lowest throughput but the highest agent-readiness guarantee. It suits appointment confirmation callbacks and sensitive collections workflows.

Configuring a High-Volume Outbound Campaign Step by Step

The following configuration path applies to the standard VICIdial admin panel at /vicidial/admin.php, and to KingAsterisk’s custom-themed deployments at /dialer/admin.php – the underlying settings are identical.

Step 1 – Create or Open the Campaign

Navigate to Admin – Campaigns – Add Campaign. Give the campaign a clear internal code (e.g., OB_COLLECT_JUL). Set Campaign Status to ACTIVE only when your lead list and trunks are confirmed.

Step 2 – Set the Dialing Method and Ratio

Under the campaign’s Dialing Settings, select RATIO for predictive mode. Set the Dial Ratio to begin at 1.5 (1.5 lines dialed per available agent). Monitor your real-time stats board for the first 15 minutes and raise the ratio incrementally. A well-tuned predictive campaign at 30 agents with a 2.2 ratio will typically push past 500 attempts per hour, depending on your list’s connect rate.

Step 3 – Configure Hopper Level and Local Dial Timeout

The Hopper Level controls how many leads are pre-loaded into the active dial queue. Set it to at least 5x your expected calls-per-minute figure. For a 500/hour target (roughly 8–9 per minute), a hopper of 50–60 leads ensures the dialer never starves waiting for the next record. Set the Local Dial Timeout between 25 and 32 seconds – long enough for a genuine ring cycle, short enough to recycle quickly.

Step 4 – Assign Trunks and DID Configuration

Go to the Carriers section and confirm your active SIP trunk has sufficient concurrent channel capacity. At 500 calls per hour with an average call duration of 90 seconds, you need a minimum of 12–15 simultaneous channels available at peak. Under-provisioned trunks are the most common reason high-dial-ratio campaigns plateau below their targets.

Step 5 – Upload and Activate a Lead List

Under Lists – Add List, create a list assigned to your campaign. Upload leads in the VICIdial-standard CSV format (phone number, first name, last name, address fields, custom fields). Activate the list and verify the record count in the campaign’s List Status view before starting agents.

How to Set Up an Inbound Call in VICIdial (for Blended Operations)

Many high-volume outbound teams also handle inbound return calls, overflow queues, or dedicated inbound campaigns. Setting up inbound call handling in VICIdial uses the Inbound Groups (queues) system rather than the campaign system.

Creating an Inbound Group

Go to Admin – Inbound Groups – Add Group. Assign a group name (e.g., IB_RETURNS), set the Queue Priority, and configure the Agent Grab Time (how many seconds an agent has to accept an inbound before it re-queues). For blended agents, assign both outbound campaign access and an inbound group in the agent’s User settings.

DID Routing

Under Admin – Phones – DIDs, map your inbound telephone number to the Inbound Group. Calls arriving on that DID will enter the queue and ring available blended agents. The system automatically pauses outbound dialing for the agent during an inbound call and resumes after disposition.

Hopper Logic and What “Dead Call” Means in VICIdial

A dead call in VICIdial refers to an outbound call that connected (i.e., a live answer or AMD-detected machine) but had no available agent to receive it within the configured wait window. The system plays a brief audio message or silence and then terminates the call. Dead calls appear in reports as the DEAD disposition.

Dead calls are a direct symptom of a dial ratio that is too aggressive relative to the number of active agents. If your reports show more than 2–3% dead calls, reduce your dial ratio by 0.2 increments and allow the predictive algorithm 10–15 minutes to restabilize. Sustained dead call rates above 5% also trigger compliance risk under regulations governing automated outbound contact – a critical consideration for operations targeting regulated industries.

Hopper Refresh and Lead Recycling

VICIdial’s hopper refresh cycle pulls new leads from the active list and refills the hopper based on the campaign’s reset settings. Leads with specific dispositions (e.g., NI – Not Interested, DC – Disconnected) are excluded from the next cycle automatically. Configuring the Callback and Recycle settings properly ensures your agents spend time on reachable prospects rather than burning through exhausted lead pools.

Automating Lead Flow with the VICIdial Non-Agent API

At 500+ calls per hour, manual lead uploads become a bottleneck. The VICIdial Non-Agent API eliminates that constraint by allowing external CRM systems, web forms, and data pipelines to inject leads, modify records, and retrieve campaign statistics programmatically – without any administrator needing to log in.

API Endpoint and Authentication

The Non-Agent API is accessible at:

http://[YOUR_SERVER_IP]/vicidial/non_agent_api.php

http://[YOUR_SERVER_IP]/vicidial/non_agent_api.php

All requests use HTTP GET or POST parameters including a user credential pair with API permissions enabled. Authentication is configured at the user level in Admin – Users.

Core Operations

Agent API vs. Non-Agent API

The Agent API (/agc/api.php) controls active agent sessions – pausing, transferring, or hanging up calls during a live interaction. The Non-Agent API handles everything outside of that: data management, campaign administration, reporting pulls, and automated lead injection. For a 500+/hour operation, the Non-Agent API is the integration layer your CRM connects to.

Restricting Report Access: User Permission Configuration

Large operations have multiple supervision tiers. A floor supervisor does not need access to carrier configuration or user deletion – they need the Agent Time Detail Report for their group. VICIdial’s User Group permission system handles this precisely.

Creating a Report-Only User Group

Go to Admin – User Groups – Add User Group. Name it something descriptive like REPORT_SUPERVISORS. Under Allowed Reports, select only the reports this group should see (e.g., Agent Time Detail, Hourly Report). Set Allowed User Groups to restrict data visibility to that supervisor’s assigned teams only.

Configuring the User

Under Admin – Users – Add User, assign User Level 7 or 8, set User Group to REPORT_SUPERVISORS, and configure the admin interface options as follows: View Reports = 1, Modify Campaigns = 0, Modify Users = 0, Load Leads = 0. The user can now log into the admin interface, access their permitted reports, and see only their team’s data – nothing else.

Transferring Calls Without Losing Momentum

In high-throughput environments, call transfer speed directly impacts the agent’s effective talk time per hour. VICIdial supports two transfer methods:

Blind Transfer

The agent enters the destination extension or external number, clicks transfer, and the call immediately routes. The agent’s line is released and they return to the queue. Use this when the receiving department does not require a warm introduction – collections escalations to a senior agent, for example.

Attended (Warm) Transfer

The agent places the current call on hold, dials the destination, speaks privately with the receiving party, and then bridges the three-party call before dropping off. This method is preferable for complex sales handoffs or when the caller needs to be formally introduced to a specialist. The additional step costs roughly 45–90 seconds per transfer, which matters when you’re managing a high-call-volume campaign.

Real-World Use Case: 500+ Calls Per Hour in a Debt Recovery Operation

A regional debt recovery firm running a 45-agent blended team migrated their legacy dialer to VICIdial with a KingAsterisk custom interface deployment. Their previous system capped practical outbound volume at roughly 280–310 calls per hour due to rigid dial ratio settings and no API lead injection capability.

After migration, the team configured three simultaneous predictive campaigns with a 2.0 to 2.4 dial ratio per campaign, a hopper level of 80 leads per campaign, and an automated CRM connector using the Non-Agent API to push new recovery accounts directly into the active list every 30 minutes. SIP trunk capacity was expanded to 110 concurrent channels across two carriers.

Within the first billing cycle, the operation recorded a consistent average of 547 outbound call attempts per hour across active campaign hours. Agent talk time utilization increased from 52% to 74%. Dead call rate held at 1.8% – well within acceptable thresholds. The Agent Time Detail Report, restricted to supervisor-level users via User Groups, gave floor managers live visibility into individual agent performance without requiring full admin access.

Frequently Asked Questions

Conclusion

Running VICIdial scheduled outbound calls at 500+ per hour is not a matter of luck or raw server power – it is the result of deliberate configuration across every layer of the system: dialing mode selection, hopper sizing, trunk capacity, campaign settings, and real-time reporting feedback. The Non-Agent API removes the manual bottleneck from lead management, while VICIdial’s User Group permission system keeps supervisors focused without overexposing administrative controls. Dead call rates and disposition data are your operational compass – monitor them continuously and adjust dial ratios accordingly.

If your contact center operation is not consistently hitting its outbound throughput targets, the configuration details covered in this guide are the right place to start. KingAsterisk’s team of senior engineers has deployed and optimized VICIdial environments across dozens of industries and operational scales. 

Contact us to discuss your setup requirements and discover what your current infrastructure is actually capable of.