Why your agent's phone doesn't ring on login

An agent logs in, a call comes in, and the phone stays silent. It is a frustrating one because everything looks fine on the agent screen, yet no ring. Almost every time, the cause is that the phone is not really registered, the wrong phone is logged in, or a setting is sending the call somewhere else. Here is how to track it down.

The phone never registered

This is the big one. The agent screen login and the phone registration are two separate steps. A Softphone or deskphone has to send a SIP (Session Initiation Protocol) REGISTER and be accepted by Asterisk before any call can land on it. If the agent logged into the web screen but the device itself never registered, VICIdial has nowhere to send the call, so the phone is dead quiet. Confirming the device is online is always step one.

The wrong extension is logged in

VICIdial rings the phone tied to the Phone record the agent picked at login. If the agent logged in against one Phone entry but their actual handset is registered as a different extension, the ring goes to the wrong device and the agent hears nothing. Make sure the phone the agent selected matches the device sitting in front of them.

sequenceDiagram
  participant A as Agent screen
  participant V as VICIdial
  participant P as Phone device
  A->>V: Agent logs in with a phone
  V->>P: Ring the registered extension
  P-->>V: No registration found
  V-->>A: Call has nowhere to ring
  Note over P: Register the device first

Audio reaches the phone but you hear nothing

Sometimes the call connects but no sound passes, which can feel like the phone never rang. That is usually a media path problem rather than a registration problem. The voice travels over RTP, and if a firewall blocks those ports or a home router mangles addresses through NAT traversal, you get a dead or one-way call. Open the RTP range and confirm the agent's network is not silently dropping it.

The ring goes elsewhere

A couple of Phone-record settings can route a call away before the agent ever hears it. Phone Ring Timeout sets how many seconds the phone rings before the call is sent to voicemail, with a default of 60 seconds, so a very short value can cut the ring off fast. There is also an Unavailable Dialplan Forward field that, if filled in, sends unanswered calls to a dialplan extension instead of letting the phone keep ringing. Check both if calls seem to vanish.

• Confirm the device shows as registered before blaming VICIdial.
• Make sure the logged-in phone is the same device the agent is using.
• Check Phone Ring Timeout and any Unavailable Dialplan Forward value.
• Open the SIP and RTP ports so the call can reach the phone with audio.

Where to start

Nine times out of ten, a silent phone is an unregistered phone, so start there. If you are not even sure the device is online, the registration password guide explains the secret the device must send to register, and the VICIdial phones guide covers the full setup.

On a clean managed VICIdial box the registration and firewall are already correct, so phones ring the moment an agent logs in. See VICIfast pricing to launch one in under 40 seconds.