Your agents' webphone
Your agents talk through a phone built into the agent screen. Nothing to install. Here is what they see, and how to give it your logo and colours.
Your agents · 3 min read

Your agents don't need a desk phone or an app on their computer. A phone is built into the agent screen, and every agent you add in the dashboard gets one. It connects by itself when the agent signs in. This guide shows what your agents see, and how to put your own logo and colours on it.
What you need
- Agents created on the Users tab of your server. Each one gets a webphone with the same number as their user ID.
- To change the look: the account owner login. Only the owner can see and apply whitelabel packs.
What your agents see
The phone sits on the agent screen next to the customer's details. Agents don't dial, answer or hang up on the phone itself. They do that with the agent screen's buttons, and the phone carries the sound.
- The dot and the word next to it show the line: Connecting… while it starts, then Ready. A few seconds after the agent signs in it says In call and stays that way all shift, between customer calls too: the agent screen keeps the phone on an open line to the dialer. Ext shows the agent's extension.
- The first time, the browser asks to use the microphone. The agent must click Allow. If they missed it, an Enable microphone button appears on the phone.
- While the phone says In call it shows a timer and a Mute button. If you left the dialpad on, agents can press keys for phone menus.
- With more than one headset or speaker plugged in, small lists appear so the agent can pick the right one.
- If the internet drops, the phone reconnects by itself. While it does, a Retrying - reconnect now button lets the agent try straight away.

Step 1: Open Whitelabel
- In the sidebar, click Whitelabel.
- You see your Whitelabel Packs. A pack is one saved set of branding: your logo, the agent login and screen, the webphone, and the firewall portal. You can keep up to 10 of your own, plus ready-made packs from VICIfast.
- Click Create pack, or Edit on a pack you already have.

Step 2: Design the phone
- In the editor, scroll to Webphone. Click Add a look if the pack has none yet. A pack can hold up to three looks.
- Give it a Look name, and switch on Agents get this look. Only one look is active at a time.
- Pick an Accent colour, a Theme (Light or Dark) and a Style: Modern; Nostalgic, an old rotary desk phone that rings and turns its dial; or Pet, a dog or a cat on a cushion.
- Set Spacing (Compact or Roomy) and Dialpad (Shown or Hidden).
- Upload a Phone logo (PNG, JPEG, SVG or WebP, up to 1 MB), or type a Name on the phone. Leave both empty to use your brand logo.
- Check the preview on the right. It is the real phone, so what you see is what agents get. Click Create pack (or Save pack).

Step 3: Apply it to your server
- Back on Whitelabel Packs, open Apply to on the pack's card.
- Pick your server, or a project under Projects (all servers) to brand every server in it.
- Click Apply.
- Under Applied to, the server shows Pushing to the server… and then On the server.
Agents get the new look the next time they open or reload the agent screen.

If something goes wrong
Frequently asked
- The browser was told not to use the microphone. The agent clicks the lock icon in the address bar, allows the microphone for this site, then clicks Enable microphone on the phone.
- Usually the agent's internet address isn't allowed through your firewall yet. The agent signs in on your agent link again, then reloads the agent screen. See Your firewall: who can reach your dialer.
- Check the right headset is picked in the phone's device list, and that Mute is off. Then see Calls with no sound or one-way sound.
- Click Retry next to the server. If it fails again, make sure the server is running and contact us through the chat bubble.
- Check the Phone column on the Users tab. If it says no phone or SIP Extension, tick the agent and click To webphone.
- Remove takes the server back to the stock VICIdial login and phone page. Apply your pack again to bring the branded phone back.
› An agent's phone says "Microphone blocked".
› The phone stays on Connecting… or shows Registration failed.
› The agent hears nothing, or the customer can't hear them.
› Applied to shows "Webphone push failed".
› An agent has no phone at all.
› I clicked Remove under Applied to.
Related articles
Tags: agents, vicidial, webphone, branding


