Website Assistant Install

What This Does

The Website Assistant install flow puts a Bombyx assistant on a customer’s site.

Most WordPress sites should use the plugin. Custom sites can use the script tag.

Before You Start

In Bombyx, the assistant should be turned on and have a widget key.

The widget key is different from a tool connector token. It is safe to use in website install code, but it should still belong only to the site it was created for.

WordPress Install

In Bombyx, open Website Assistant, then Installation.
Download the Bombyx WordPress plugin ZIP.
In WordPress, open Plugins, then Add Plugin.
Choose Upload Plugin and select the ZIP.
Activate the plugin.
Open Settings, then Bombyx Assistant.
Paste the widget key.

The WordPress plugin can also keep public WordPress pages and posts current for training. It does not include drafts, private content, password-protected content, revisions, comments, media files, or admin-only data.

Direct Script Install

Use this path for non-WordPress sites or custom installs.

<script
  async
  src="https://bombyxlabs.com/widget/widget_key_here.js"
  data-launcher-label="Ask us">
</script>

The launcher label comes from Website Assistant settings unless data-launcher-label overrides it.

On-Page Openers

After install, either of these opens the assistant:

<a href="#bombyx-assistant">Ask a question</a>

<button data-bombyx-open-assistant>Ask a question</button>

Common Mistakes

Using a tool connector token instead of the widget key.
Installing both the WordPress plugin and direct script on the same page.
Expecting private WordPress content to be scanned. It is intentionally skipped.