Using the Webphone Only Page in VICIdial

Not everyone who needs to make a call inside VICIdial needs the whole agent screen. The Webphone Only page is for exactly that case: anyone with access to the agent interface can log in here and use the built-in webphone by itself, without loading the full dialing console.

A Webphone is a phone that runs right in the browser, with no separate app to install on the machine. It is a Softphone, meaning it is software rather than a physical desk handset. The Webphone Only page strips everything else away and just gives you that phone.

When you would use it

There are a few honest reasons to reach for this page instead of the full agent screen.

• You want to confirm the browser phone registers and gets audio before anyone tries to take live calls on it.
• A supervisor or back-office user needs to place the odd call but should not be sitting in the dialing queue.
• You are testing a new workstation, headset, or network path and want to isolate the phone from everything else the agent screen does.

One condition matters: the webphone has to actually be installed on your system. The page surfaces a phone that is already there. If your build was set up without a browser phone, this page has nothing to show, and your users would be working from a hardphone or an external Softphone instead.

What happens when you log in

Logging in here follows the same path the phone takes inside the full agent screen, just without the rest of the page. You sign in with credentials that have agent-interface access, the webphone reads its connection details, and it registers itself with the dialer over SIP (Session Initiation Protocol), the protocol that sets up and tears down voice calls. Once it is registered, it is ready to make and take calls.

flowchart TD
  A[User opens Webphone Only page] --> B[Log in with agent interface access]
  B --> C{Webphone installed on system}
  C -- no --> D[Nothing to show]
  C -- yes --> E[Webphone reads its connection details]
  E --> F[Webphone registers over SIP]
  F --> G[Phone shows ready to talk]

Under the hood, registration is driven by a Registration string, the bundle of settings that tells the phone which server to reach and how to authenticate. You normally never see it on this page, but when registration fails, that string is the first thing to check, because a wrong server address or password is the usual reason a webphone sits stuck on connecting.

A couple of things to keep in mind

Because this page logs the user in as the phone itself, it still creates a real Agent session on the system, so the person is genuinely present on the dialer even though they never see the agent console. That is fine for testing and for the occasional manual call, but it means you should log out cleanly when you are done rather than just closing the tab.

If the phone registers but you get no sound, the problem is almost always network rather than VICIdial: a firewall blocking the audio ports, or a browser that has not been granted microphone access. The Webphone Only page is actually a great place to chase that down, because there is nothing else on screen to muddy the result.

This page is one small corner of VICIdial's admin and operator utilities. For the full tour of the bulk and admin tools around it, read our guide to VICIdial admin bulk tools. If you are setting phones up in bulk rather than one at a time, see how to set bulk-inserted phones as webphones.

All of this assumes a VICIdial box with the webphone already built in. If you would rather have a configured dialer, webphone included, ready in under 40 seconds, see VICIfast pricing.