Skip to content

Admin Panel

The widget's appearance and behaviour are configured in the admin panel, not in the embed code. That way you can update settings such as color, position, call features, or member login without changing any code.

All of the settings below live in the provider editor.

Widget Theme

SettingValuesDescription
Themelayout variantThe widget's layout variant.
Dark ModeLight · Dark · AutoLight, dark, or follow the visitor's system preference.
Brand ColorcolorThe accent color used throughout the widget.

Widget Placement

SettingValuesDefaultDescription
Widget PositionBottom Right · Bottom Left · Top Right · Top LeftBottom RightWhich corner the widget sits in.
Horizontal Offset0200 px24Distance from that corner, horizontally.
Vertical Offset0200 px24Distance from that corner, vertically.
Horizontal Offset (Mobile)0200 pxUsed on small screens instead of the value above.
Vertical Offset (Mobile)0200 pxUsed on small screens instead of the value above.

Leave a mobile offset empty and the desktop value applies on every screen size.

Call settings

The Webfon section manages the call features. Two settings let the agent request media from the visitor during a call:

SettingDefaultDescription
Agent Camera RequestoffThe agent can ask the visitor to turn on their camera. Requires the customer video feature to be enabled.
Agent Screen Share RequestoffThe agent can ask the visitor to share their screen. Requires the customer screen-share feature to be enabled.

Visitor consent is required

The request opens a confirmation dialog in the visitor's widget (Allow / Decline). If no answer arrives within 30 seconds, the request is automatically declined. No media is turned on without the visitor's approval; if they approve, it flows exactly as if the visitor had started it themselves. If the corresponding customer feature is off, the request setting is disabled as well.

Member Login

The Member Login section manages the social login options in the widget (see Authentication):

  • Key SourceWebfon Application Keys (Webfon's OAuth applications) or Own Application Keys (your own OAuth applications).
  • An enable checkbox per provider — only enabled providers appear on the widget's login page.
  • When Key Source is Own Application Keys, a Client ID / Client Secret per provider; for Apple additionally Team ID / Key ID and the p8 private key.

Supported providers: Google, Facebook, Apple, GitHub, X.

When do updates take effect?

A change in the admin panel reaches the widget within about a minute at most — widgets already open on a page pick it up on their next load.

Webfon live-support widget documentation