> For the complete documentation index, see [llms.txt](https://docs.mydbsync.com/cloud-workflow/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mydbsync.com/cloud-workflow/ai/website-chat-agent.md).

# Website Chat agent

DBSync's website chatbot is an artificial intelligence (AI)-powered assistant that transforms how visitors navigate the company website and internal portal. Instead of clicking through pages to find what they need, visitors get instant, conversational answers about the company, products, pricing, and support, along with direct links to relevant resources like demos, documentation, and case studies.

The chat agent can be embedded on any webpage, either as an inline widget within a page section or as a floating window, and it maintains context across the visitor's session as they navigate, refresh, or return to the site. It draws answers exclusively from a configured knowledge base, keeping responses accurate and aligned with your brand, with the flexibility to customize its appearance to match your brand's look and feel.

## How it works

When a visitor arrives on your website, the chat agent widget appears as a floating icon or an inline component within a page section. The visitor types a question, and the chat agent:

1. Generates a formatted summary answer.
2. Surfaces relevant resource links, demo videos, documentation pages, case studies, and blog posts, grouped by category.
3. Suggests a next action to keep the visitor engaged.

The chat agent maintains session history across page navigations until the visitor clears their browser cookies, so conversations are never interrupted when moving between pages.

## Embed options

The chat agent supports three embed formats:

| Format               | Description                                                                                                                                            | Best for                                                                |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| **Floating window**  | A widget that slides in from the corner of the screen, available on every page.                                                                        | General site-wide navigation assistance.                                |
| **Inline**           | Embedded directly inside a specific `<div>` section of a page's HTML.                                                                                  | Focused, contextual help on a specific landing page or product section. |
| **Copilot slide-in** | A conversational panel that expands from the edge of the screen, letting you interact with the Copilot while maintaining context on your current page. | Contextual assistance while visitors keep the current page visible.     |

## Before you begin

Before you configure the chat agent, make sure you have:

* Access to the DBSync Cloud Workflow admin panel.
* A configured [knowledge base](/cloud-workflow/ai/knowledge-base.md), such as website pages, wiki articles, blog posts, documentation, or uploaded documents.
* An active Salesforce integration, if you want to use lead capture.

## Configuration steps

{% stepper %}
{% step %}
Open the chat agent creation panel.

1. Log in to the DBSync Cloud Workflow admin panel.
2. Navigate to **Chat Agents** <img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FW3M3DhEV0n5VzlTJMJ8K%2Fimage.png?alt=media&amp;token=d7449145-b786-4887-936b-3e8ae78ad640" alt="" data-size="line">.
3. Select an existing agent or click **New Chatbot**.
   {% endstep %}

{% step %}
In the **Name** field, enter a short identifier for your chat agent. This name displays on your chat agent list.
{% endstep %}

{% step %}
From the **LLM Provider** menu, select the platform or service that hosts the language model you want to use.
{% endstep %}

{% step %}
From the **Model** menu, select the specific language model version (for example, `gpt-5.6-luna`) to power your chat agent's responses.
{% endstep %}

{% step %}
Optional: In the **Initial Prompt** field, enter a greeting message. This text appears as the first assistant message when a user opens the chat interface. If you want to skip the initial greeting, leave this field empty.

<div align="left" data-with-frame="true"><figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FEdtSho9BQLAJdJMvxl8Y%2Fimage.png?alt=media&amp;token=ab962fc9-efc5-4117-bb93-461ec618a1ce" alt="" width="209"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
In the **System Prompt** field, enter the core instructions that define the assistant's persona and behavior.

Example system prompt:

```
You are a helpful assistant.
```

<div align="left" data-with-frame="true"><figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FLTDdtDU1MDfy60413ekU%2Fimage.png?alt=media&amp;token=90260541-f5e8-419c-94d4-210c06052fca" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Go to the [Knowledge Base](/cloud-workflow/ai/knowledge-base.md) section if you have not yet configured it.

The chat agent answers using only the content you add here. To improve answer quality, upload detailed product documentation, user guides, the website sitemap URL, and other relevant documentation that you want the chatbot to use as source material.
{% endstep %}

{% step %}
Optional: Go to the [MCP](/cloud-workflow/ai/model-context-protocol-mcp.md) section to configure an MCP server.
{% endstep %}

{% step %}
Optional: To restrict search results strictly to the knowledge base, turn off **Enable web search**.

<div align="left" data-with-frame="true"><figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FH02U3XWPPWFsFDu91G67%2Fimage.png?alt=media&amp;token=580a9318-53c9-44b7-9a1a-79a9dc1424d7" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Optional: Turn on the **Lead capture on gated content** toggle to ask visitors to fill out a lead form before they can play gated videos. This setting takes effect after you save your changes.

<div align="left" data-with-frame="true"><figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FcAKzt5Y7Jk5KKjhViirL%2Fimage.png?alt=media&amp;token=6520b5d4-bf8c-4a97-8472-d0cff8140186" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Customize the appearance

* Select a **Primary Color** to use for the header, buttons, and message bubbles.
* Under **Response Display**, turn on the **Show sources** toggle to display source material below each answer.
* Turn on the **Web view** toggle to display answers in web view.<br>

  <div align="left" data-with-frame="true"><figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FD0miK6jsqu9M6GcbSG68%2Fimage.png?alt=media&amp;token=30f3bb74-615a-4ba5-b931-2d56a6cbeb9b" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Click **Save & Preview**.

***

{% endstep %}
{% endstepper %}

## Configure embed code

{% stepper %}
{% step %}
Click <img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FxBhrReCcAW1z6ida1DMA%2Fimage.png?alt=media&amp;token=79ab33fe-ce2e-4919-b535-d75293f61f86" alt="" data-size="line"> **Settings**, then **Embed Code**.

1. Enter a token name.
2. Click **Generate Token**.<br>

   <div data-with-frame="true"><figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2Flm6P90svt6V8SOo8i4f2%2Fimage.png?alt=media&amp;token=c9248394-772f-4d9e-b548-036b8ea59181" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Scroll down further to access the chat agent script, which you can use to embed the chat agent on your website.&#x20;
{% endstep %}

{% step %}
Embed the chat agent on your website.

1. For floating bubble placement, click <img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FROWmmVlyDPao1XX5SjXS%2Fimage.png?alt=media&amp;token=d5a6291c-28ba-4e4a-b9f1-67f478c8a89a" alt="" data-size="line"> to copy the script and place it above the `<body>` tag in your webpage.\
   Sample script:

   <pre class="language-html" data-overflow="wrap" data-expandable="true"><code class="lang-html">&#x3C;!-- DBSync Chatbot — floating bubble embed -->
   &#x3C;script src="https://platform.dbsync.io/dbsync/resources/v2/js/chatbot/chatbot-embed.js">&#x3C;/script>
   &#x3C;script>
   DBSyncChatbot.init({
       orgId:        18238,
       chatConfigId: 133,
       embedToken:   "tok_18238_f86bd6587171f070707a3ec8d75796d3",

       // Optional — explicit tags to attach to every session from this page.
       // URL params on this page also auto-attach (e.g. ?customer=Acme).
       sessionTags: {
           // customer: "YourCustomer",
           // page:     "support"
       },

       appearance: {
           mode:        "bubble",       // "bubble" = floating button bottom-right
           minimized:   true,           // start collapsed; user clicks to expand
           theme:              { accent: "#24C258" },  // Primary Color (Appearance section)
           showSources:        true,
           showRelatedSources: false,
           showTimestamp:      false,
           showFeedback:       false,
           // shadowDom:       false,       // opt OUT of style isolation (host CSS can then restyle the widget)
           // Lead capture on gated content — where the lead goes.
           // REQUIRED on your own domain: without it, clicking gated content sends the
           // visitor to that content's own page instead of asking for details in chat.
           // leadGen: { oid: "00D..." },   // your Salesforce Web-to-Lead organisation id
           headerLabel: "AI Assistant",
           logoUrl:     ""
       }
   });
   &#x3C;/script>
   </code></pre>

   \
   Sample output:

   <div data-with-frame="true"><figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FzqjZ4B9d3WjVd88yGfRg%2Fimage.png?alt=media&amp;token=7c1789a1-d905-41bd-8027-b1fe75f696e3" alt=""><figcaption></figcaption></figure></div>
2. For Copilot slide-in placement, click <img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FROWmmVlyDPao1XX5SjXS%2Fimage.png?alt=media&amp;token=d5a6291c-28ba-4e4a-b9f1-67f478c8a89a" alt="" data-size="line"> to copy the script and place it above the `<body>` tag in your webpage.\
   Sample script:

   <pre class="language-html" data-overflow="wrap" data-expandable="true"><code class="lang-html">&#x3C;!-- DBSync Chatbot — copilot slide-in (prompt bar + right panel) -->
   &#x3C;script src="https://platform.dbsync.io/dbsync/resources/v2/js/chatbot/chatbot-embed.js">&#x3C;/script>
   &#x3C;script>
   DBSyncChatbot.init({
       orgId:        18238,
       chatConfigId: 133,
       embedToken:   "tok_18238_f86bd6587171f070707a3ec8d75796d3",

       sessionTags: {
           // customer: "YourCustomer"
       },

       appearance: {
           mode: "copilot",             // prompt bar + right slide-in panel
           bar:  "sticky",              // "sticky" | "hero" (set barContainer) | "pill"
           // How the panel treats YOUR page on desktop:
           //   "dock"    = the page reflows and the panel sits in the opened column
           //               (nothing on your site is ever covered)
           //   "overlay" = the panel floats on top; your layout never moves
           panelMode: "dock",
           barPlaceholder: "Ask us about anything…",
           suggestions: ["Compare plans", "Book a demo"],
           quickChips:  ["Compare plans", "Book a demo"],
           theme:              { accent: "#24C258" },  // Primary Color (Appearance section)
           showSources:        true,
           showRelatedSources: false,
           showTimestamp:      false,
           showFeedback:       false,
           // shadowDom:       false,       // opt OUT of style isolation (host CSS can then restyle the widget)
           // Lead capture on gated content — where the lead goes.
           // REQUIRED on your own domain: without it, clicking gated content sends the
           // visitor to that content's own page instead of asking for details in chat.
           // leadGen: { oid: "00D..." },   // your Salesforce Web-to-Lead organisation id
           headerLabel: "AI Assistant"
       }
   });
   &#x3C;/script>
   </code></pre>

   \
   Sample output:

   <div data-with-frame="true"><figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FXJ0W1O01NYbrmfye59NA%2Fimage.png?alt=media&amp;token=18e80fd3-e2e9-4760-9853-ed3e957b6d62" alt=""><figcaption></figcaption></figure></div>
3. For inline placement, click <img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FROWmmVlyDPao1XX5SjXS%2Fimage.png?alt=media&amp;token=d5a6291c-28ba-4e4a-b9f1-67f478c8a89a" alt="" data-size="line"> to copy the script and place it inside a `<div>` or `<section>` tag in your webpage.\
   Sample script:

   <pre class="language-html" data-overflow="wrap" data-expandable="true"><code class="lang-html">&#x3C;!-- DBSync Chatbot — inline embed inside a div -->
   &#x3C;div id="dbsync-chatbot" style="height: 600px;">&#x3C;/div>
   &#x3C;script src="https://platform.dbsync.io/dbsync/resources/v2/js/chatbot/chatbot-embed.js">&#x3C;/script>
   &#x3C;script>
   DBSyncChatbot.init({
       container:    "dbsync-chatbot",
       orgId:        18238,
       chatConfigId: 133,
       embedToken:   "tok_18238_f86bd6587171f070707a3ec8d75796d3",

       sessionTags: {
           // customer: "YourCustomer"
       },

       appearance: {
           mode:        "inline",       // fills the container div
           theme:              { accent: "#24C258" },  // Primary Color (Appearance section)
           showSources:        true,
           showRelatedSources: false,
           showTimestamp:      false,
           showFeedback:       false,
           // shadowDom:       false,       // opt OUT of style isolation (host CSS can then restyle the widget)
           // Lead capture on gated content — where the lead goes.
           // REQUIRED on your own domain: without it, clicking gated content sends the
           // visitor to that content's own page instead of asking for details in chat.
           // leadGen: { oid: "00D..." },   // your Salesforce Web-to-Lead organisation id
           headerLabel: "Your Brand",
           logoUrl:     "https://platform.dbsync.io/dbsync/resources/svgs/DBSync-favicon.svg"
       }
   });
   &#x3C;/script>
   </code></pre>

   \
   Sample output:

   <div data-with-frame="true"><figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FnO8zcpKgbiRvvr9f7sug%2Fimage.png?alt=media&amp;token=c149610c-a1be-4d51-b92f-2e3399350272" alt=""><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}

## Lead generation strategy

The chat agent supports lead capture through two mechanisms:

### Gated content forms

When a visitor requests access to a gated resource, such as a webinar recording, case study, or demo video, the chat agent presents the existing lead capture form. On submission, Salesforce automatically updates the lead record.

### Pricing inquiries

When a visitor asks about pricing, you can customize the chat agent's response and redirection based on client preferences. If a client has a dedicated pricing page, the chat agent can direct visitors there. Alternatively, it can redirect visitors to the Contact Sales page or prompt them to schedule a call.
