npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@vicistack/vicidial-agent-coaching

v1.0.0

Published

Stop Coaching Reactively: A Data-Driven VICIdial Coaching Workflow — ViciStack call center engineering guide

Readme

Stop Coaching Reactively: A Data-Driven VICIdial Coaching Workflow

The complete, practical guide to VICIdial's real-time coaching tools — silent monitor, whisper, barge-in, agent screen monitoring, performance-based coaching workflows, and how to measure whether your coaching actually moves the numbers. --- Most call centers have the same coaching problem: they know they should be doing more of it, they have the tools sitting right there in VICIdial, and they still end up coaching reactively — pulling an agent aside after a bad call, reviewing a random recording once a week, or waiting until someone's numbers are so bad they're about to get fired. That's not coaching. That's damage control. Real coaching — the kind that actually improves conversion rates, reduces handle times, and retains agents — is systematic. It's data-driven. It happens in real time, not three days after the call. And VICIdial has every tool you need to do it. Silent monitoring, whisper coaching, barge-in, agent screen monitoring, real-time status tracking, performance dashboards — it's all built in or easily configured. The problem isn't the toolset. The problem is that most operations never set it up properly, never build a repeatable coaching workflow around it, and never measure whether the coaching is actually working. This guide fixes that. We'll walk through every VICIdial coaching capability, show you how to configure each one, build a coaching workflow that identifies who needs help and when, and give you the queries and dashboards to prove it's working. If you're looking to layer AI-powered analysis on top of these fundamentals, see our AI coaching feature — but start here first. --- ## Understanding VICIdial's Three Coaching Modes VICIdial provides three real-time call intervention modes, all accessible from the real-time report or the manager interface. Each serves a different purpose in the coaching workflow. ### Silent Monitor (Listen Mode) Silent monitoring lets a supervisor listen to a live call without the agent or the caller knowing. The supervisor hears both sides of the conversation in real time. No one on the call hears the supervisor. When to use it: - Routine quality monitoring — listening to calls to evaluate script adherence, tone, objection handling - Evaluating new agents during their first days on the floor - Investigating customer complaints about specific agents - Gathering examples of good calls for training purposes - Pre-coaching — listening to an agent's calls before a coaching session to identify specific behaviors to address How it works technically: VICIdial uses Asterisk's ChanSpy application under the hood. When a supervisor initiates silent monitor, the system creates a ChanSpy channel pointed at the agent's active call channel. The audio is mixed and sent to the supervisor's phone or softphone. The agent's channel is not modified, so there's no telltale beep or audio artifact. ### Whisper (Coach Mode) Whisper coaching lets a supervisor speak to the agent during a live call without the caller hearing. The supervisor hears both sides. The agent hears the supervisor and the caller. The caller only hears the agent. When to use it: - Real-time coaching during a call — feeding the agent rebuttals, product information, or pricing - Guiding a new agent through their first live calls - Helping an agent recover a call that's going sideways - Walking an agent through a complex compliance disclosure - Assisting with upsell or cross-sell opportunities in real time How it works technically: Whisper uses Asterisk's ChanSpy with the whisper flag enabled. The supervisor's audio is injected into the agent's channel only, not the bridged caller channel. This means the caller has zero indication a third party is on the line. Important limitation: Whisper requires the agent to be comfortable with receiving real-time instructions while simultaneously talking to a caller. This is a skill that takes practice. Don't throw agents into whisper coaching cold — let them know in advance and start with simple, short prompts ("ask about the warranty," "slow down") before attempting full rebuttal feeding. ### Barge-In (3-Way Conference) Barge-in puts the supervisor directly on the call as a three-way conference. All three parties — supervisor, agent, and caller — can hear each other and speak. When to use it: - Escalation support — the agent needs a manager to close a deal or handle a complaint - Compliance situations — a supervisor needs to deliver a required disclosure - Saving a call from an agent who's completely lost - Taking over a call from an agent who needs to be pulled off the floor - Handling a hostile or threatening caller When NOT to use it: Barge-in should be rare. If supervisors are barging into calls regularly, your training program has a problem. Barge-in is the emergency brake, not the steering wheel. Over-using it damages agent confidence and creates a culture where agents lean on supervisors instead of developing their own skills. --- ## Configuring Silent Monitor, Whisper, and Barge-In ### Prerequisites Before setting up coaching modes, verify the following: 1. Manager user account with appropriate permissions The supervisor or manager account needs specific permissions in VICIdial. Go to Admin → Users → [manager user] and verify: - User Level: 7 or higher (7 = manager, 8 = admin, 9 = superadmin). Level 6 and below cannot monitor. - Agent API access: Enabled (required for the monitoring functions) - Monitor allowed: Yes - Barge-in allowed: Yes (separate from monitor permission) sql -- Verify user permissions for coaching capabilities SELECT user, user_level, vdc_agent_api_access FROM vicidial_users WHERE user_level >= 7; 2. Asterisk Manager Interface (AMI) configured The monitoring functions work through Asterisk's AMI. Verify the manager connection is working on each dialer server: bash # Check AMI is listening ss -tlnp | grep 5038 # Verify manager credentials from VICIdial asterisk -rx "manager show connected" # Test AMI connectivity from the web server telnet dialer-server-ip 5038 If AMI isn't responding, check /etc/asterisk/manager.conf for the correct credentials and permitted network ranges. 3. SIP/IAX phones for supervisors Supervisors need a phone or softphone registered to the VICIdial Asterisk system. The monitoring audio is delivered to this phone. This can be: - A hardware SIP phone at the supervisor's desk - A software phone (Zoiper, MicroSIP, Linphone) on their computer - A WebRTC phone if you're running VICIdial's WebRTC configuration The supervisor's phone extension must be configured in VICIdial under Admin → Phones. The phone must be registered and working before initiating monitoring. ### Starting a Monitoring Session #### From the Real-Time Report The fastest way to start monitoring is from VICIdial's real-time report at /vicidial/realtime_report.php: 1. Locate the agent you want to monitor in the agent detail section 2. Click the agent's row or the monitoring icon next to their name 3. Select the monitoring mode: - MONITOR — silent listen - BARGE — barge-in (3-way) - WHISPER — whisper to agent only 4. Your supervisor phone will ring. Answer it to begin the session. The monitoring session continues until the supervisor hangs up or the call ends. If the call ends and the agent takes another call, the monitoring session does NOT automatically continue to the next call — you'll need to initiate a new session. #### From the Manager Interface (API) For more control, use VICIdial's non-agent API to initiate monitoring programmatically: http://your-vicidial-server/agc/api.php?source=test &function=blind_monitor &user=manager_user &pass=manager_pass &phone_login=manager_phone_extension &session_id=active_session_id &agent_user=agent_to_monitor &stage=MONITOR Change stage to WHISPER or BARGE for those modes. API parameters: | Parameter | Description | |---|---| | phone_login | The supervisor's phone extension | | session_id | Active manager session ID | | agent_user | Agent ID to monitor | | stage | MONITOR, WHISPER, or BARGE | This API approach is useful if you're building a custom supervisory interface or integrating coaching tools into a separate application. #### Switching Modes During a Session You can switch between monitoring modes mid-call. If you start in silent monitor and realize the agent needs help, you can escalate to whisper without ending the session. From the real-time report, click the mode change option while monitoring is active. The escalation path typically goes: Silent Monitor → Whisper → Barge-In. Going in reverse (barge-in back to silent) is also possible but less common — once the caller knows a supervisor is on the line, dropping to silent feels awkward. ### Asterisk Configuration for Monitoring VICIdial handles most of the Asterisk configuration automatically, but if monitoring isn't working, check these Asterisk settings: ; In /etc/asterisk/features.conf (or featuremap section) ; ChanSpy must be enabled ; In /etc/asterisk/extensions.conf ; VICIdial adds the monitoring context automatically ; But verify the following context exists: [monitor-agent] exten => _X.,1,ChanSpy(SIP/${EXTEN},qBw) The ChanSpy flags control behavior: - q — quiet mode (no beep when entering the channel) - B — bridge mode (required for whisper) - w — whisper mode (supervisor audio goes to agent only) If agents hear a beep when monitoring starts, the q flag is missing. This immediately defeats the purpose of silent monitoring. Fix this in the dialplan or VICIdial's Asterisk configuration templates. ### Recording Monitored Calls VICIdial records calls independently of monitoring sessions. The call recording continues regardless of whether a supervisor is monitoring. However, the default recording captures only the agent-caller audio — the supervisor's whisper or barge-in audio may or may not be included depending on your recording configuration. To ensure monitored sessions are fully captured (including supervisor audio during barge-in): - Verify recording is set to server-side (MixMon or Monitor application), not client-side - Barge-in audio is captured because the supervisor joins the call bridge - Whisper audio may not be captured in the main recording because it's a separate audio stream injected into the agent channel For quality control purposes, note which calls were coached during the monitoring session so you can compare coached vs. uncoached performance. --- ## Agent Screen Monitoring Audio monitoring is half the picture. VICIdial also supports screen monitoring — letting supervisors see what's on an agent's screen in real time. This is critical for identifying: - Agents not following the script or call flow displayed on screen - Data entry errors (wrong dispositions, incomplete lead records) - Call avoidance behavior (agents slow-rolling disposition or deliberately staying in wrap-up) - Technical issues (frozen screens, error messages, connectivity problems) ### VICIdial's Built-In Screen Monitoring VICIdial's agent screen is a web application, which means screen monitoring can be accomplished through several methods: 1. Agent Screen Preview (built-in) VICIdial includes an agent screen preview feature accessible from the real-time report. When viewing an agent in the real-time detail, the supervisor can open a read-only view of what the agent's screen shows — the current lead information, call status, script, and disposition options. This isn't a pixel-perfect screen mirror. It's a reconstructed view of the agent's VICIdial interface state based on database data. It shows: - Current lead information displayed to the agent - Active script and script position - Call status and timer - Available dispositions - Agent's current status and queue position 2. Web-Based Screen Sharing For full screen monitoring (including non-VICIdial applications the agent might have open), deploy a lightweight screen-sharing solution: - Apache Guacamole — open-source, web-based remote desktop gateway. Supervisors can view agent desktops through a browser without installing client software. - VNC with a web viewer — noVNC provides browser-based VNC access. Each agent workstation runs a VNC server, and supervisors connect through the web viewer. For remote agent teams, Guacamole is the best option. It works over standard HTTPS, doesn't require VPN, and supports view-only connections that prevent supervisors from accidentally interacting with the agent's screen. ### Real-Time Agent Status Tracking Beyond screen monitoring, VICIdial's real-time status tracking gives you a second-by-second view of what every agent is doing. The vicidial_live_agents table is the source of truth: sql -- Current agent status with time in state SELECT vla.user, vla.campaign_id, vla.status, vla.pause_code, TIMESTAMPDIFF(SECOND, vla.last_state_change, NOW()) as seconds_in_state, vla.callerid, vla.lead_id, vl.phone_number, vl.first_name, vl.last_name FROM vicidial_live_agents vla LEFT JOIN vicidial_list vl ON vla.lead_id = vl.lead_id ORDER BY vla.status, seconds_in_state DESC; What to watch for in real-time status: | Status Pattern | What It Means | Action |


Read the full article

About

Built by ViciStack — enterprise VoIP and call center infrastructure.

License

MIT