What the Zoiper WebPhone integration is

VICIdial includes built-in hooks for the Zoiper WebPhone, a commercial browser-embedded Webphone from Zoiper. A webphone runs inside the browser instead of as a separate desktop app, so an agent can take calls without installing a standalone client. This post explains what the Zoiper integration actually is, how it is licensed, where its settings live in the admin interface, and how it surfaces in the agent screen, so you can tell whether it fits your setup before you read about why it has aged out of practical use.

A web-embedded phone, licensed per domain

Zoiper offers a web-embedded phone alongside its standalone softphone. A softphone is a software phone you install on the desktop; the web-embedded version drops the phone into the agent's browser page instead, with no install. The web phone is commercial software and is licensed by fully-qualified domain name, for example testphone.vicidial.org. That means only the server serving pages at that exact URL can use the phone, and domain name wildcards are not allowed, so you cannot license one cert for many subdomains. Plan your hostnames carefully before you buy, because the license is pinned to a single name and moving it later means a new license.

It is also Windows-only. The Zoiper web phone is compatible with Microsoft Windows agent systems only, so a mixed fleet that includes Mac or Linux agents cannot use it at all. That platform limit alone rules it out for a lot of modern, browser-first call centers.

What the admin integration controls

Several places in the admin web interface are wired to specific Zoiper features. In the Phones section you can define whether a phone is to be a webphone, whether to use the server's external server IP, whether the phone auto-answers when called, and whether the dialpad is usable or not. Each phone in VICIdial is a SIP endpoint, and SIP (Session Initiation Protocol) is the protocol that sets up and tears down the call, so these toggles control how that endpoint behaves once it loads in the browser rather than changing the protocol itself.

• Mark a phone entry as a webphone.
• Choose whether it uses the server's external server IP.
• Set auto-answer on inbound calls and toggle whether the dialpad is usable.

Where it appears for the agent

The Zoiper web phone can also be displayed inside the agent screen itself. It loads when the agent screen loads and can even be minimized while in use, so the agent works the campaign and the phone in one window without juggling two apps. Like any softphone its audio rides over RTP once a call connects, with the SIP signalling and the per-phone settings above deciding how the call is presented to the agent.

flowchart TD
  A[Agent screen loads] --> B[Zoiper web phone embeds]
  B --> C[License checks domain name]
  C --> D[Phone registers as SIP endpoint]
  D --> E[Auto answer and dialpad per phone settings]

For the bigger picture of how agents take calls from outside the office, see our pillar on VICIdial remote agents. Before you commit to Zoiper for anything new, read why the Zoiper WebPhone no longer works in modern browsers, because the browser story has changed completely. If you want a phone that works in any current browser out of the box, our managed plans include a modern branded webphone on every plan.