Skip to main content

Install the Widget on WordPress

The 2-minute path: the official BESS AI Voice & Chat Widget plugin puts your widget on every page of a WordPress site — no code, just your publishable key.

Before you start​

You need a widget and its publishable key:

  1. In the dashboard, open Voice Widgets and create a widget (see Website Widgets).
  2. Open its Install screen and copy the publishable key — it starts with bess_pk_live_.
  3. Make sure your WordPress site's domain is in the widget's Allowed domains — without it, the panel won't open on your site.

Install the plugin​

  1. In WordPress admin, go to Plugins → Add New and search for BESS AI. Install and activate BESS AI Voice & Chat Widget.
    • If the plugin isn't available in the directory yet, upload the plugin zip provided by BESS support via Plugins → Add New → Upload Plugin.
  2. Go to Settings → BESS AI Widget.
  3. Paste your publishable key.
  4. Pick the Widget mode to match the mode configured for this widget in the BESS dashboard (voice, chat, or hybrid), plus the position and language you want.
  5. Save.

That's it — open your site and the launcher bubble appears in the corner you chose. Back in the BESS dashboard, the widget's Install screen flips to "widget detected" on your domain automatically the first time any page loads.

note

The publishable key is safe to use publicly — like a Stripe pk_ key, it can only start sessions for this widget's agent and is bounded by your rate limits, daily caps, and credit balance. You can rotate it any time from the dashboard (remember to update the plugin settings with the new key).

Optional settings​

  • Accent color and launcher label — override the launcher button's color and add a text pill (e.g. "Talk to our agent"). Leave them empty to use your dashboard branding defaults.
  • On hybrid widgets, choosing Voice or Chat as the mode pins this site to that surface; "Widget default" lets the visitor choose Talk / Chat.

Nothing shows up?​

Check three things:

  1. The key is saved in Settings → BESS AI Widget (the plugin loads nothing without it).
  2. Your domain is listed in the widget's Allowed domains in the BESS dashboard.
  3. The widget is Active (not disabled) in the dashboard.

Without the plugin​

Any of these work too — they all install the same one-line snippet from the widget's Install screen:

  • A header/footer code plugin (for example WPCode): paste the snippet into the site-wide footer.
  • Your child theme: paste the snippet just before </body>.
  • Google Tag Manager: the Install screen's Google Tag Manager instructions walk through the Custom HTML tag setup.

Removing the widget​

Deactivate the plugin (or clear the key) and the widget disappears from your site immediately. Uninstalling the plugin also deletes its stored settings.