Help / Getting started

Branded webphone for VICIdial agents

White-label agent webphone served from your subdomain. Your logo, your colors, your support contact.

The branded webphone is a white-label browser softphone served from your own subdomain (e.g. webphone.your-brand.com). Agents bookmark that URL; they never see VICIfast's name.

What gets branded

  • Logo (rendered at request time from your BrandConfig)

  • Primary color

  • App name in the page title

  • Support contact link

  • Favicon

All of these are configured at /admin/brand; the webphone reads them at request time, so changes apply on the next page load.

Audio path

The browser talks directly to your VICIdial server over WSS (Asterisk's WebSocket SIP transport on port 8089). The platform never sits in the audio path — RTP is browser-to-box. Lower latency than a relay, fewer moving parts to debug.

Browser support

Chrome, Edge, Firefox — current + previous major versions. Safari works for most flows; mic-capture quirks make it the second choice on Mac. Hard requirement: HTTPS (browsers block mic access on plain HTTP).

Disabling the webphone

Per-server toggle at your server → Branded Webphone. Turning it off returns 404 on the subdomain. Agents fall back to hardware/IP phones registered via PJSIP.

Tags: agents, vicidial, webphone, branding