Chat Widget

The ScendCore chat widget lets website visitors start a conversation with your AI agent directly from your site. Conversations flow into your unified inbox alongside email, SMS, and other channels.

Prerequisites

• An active AI agent configured in ScendCore
• Access to your website’s HTML or CMS to add a script tag

Creating a Chat Widget

1. Go to Chat Widgets in the ScendCore sidebar.
2. Click + New Widget.
3. Enter a name for the widget (e.g., “Website Support Chat” or “Pricing Page”).
4. Click Create Widget.

You will be taken to the widget configuration page.

Configuring the Widget

On the widget detail page, you can customize:

Agent Assignment

Select which AI agent handles conversations that come through this widget. The agent’s personality, knowledge base, and skills will be used for all chat sessions.

Appearance

• Brand color — Matches the launcher button to your site’s design
• Position — Where the chat button appears on the page
• Welcome message — The greeting visitors see when they open the chat

Behavior

• Active/Inactive — Toggle the widget on or off without removing the embed code
• Business hours — Optionally restrict chat availability to your working hours

Embedding the Widget

Each widget has a unique embed snippet. To add the chat widget to your website:

1. On the Chat Widgets list page, find your widget.
2. Click Copy Snippet to copy the embed code to your clipboard.
3. Paste the snippet into your website’s HTML, just before the closing </body> tag:

<script src="https://app.scendcore.com/chat-widget.js" data-key="YOUR_WIDGET_KEY"></script>

The widget will appear as a floating chat button on your site.

CMS-Specific Instructions

• WordPress: Add the snippet using a Custom HTML block or your theme’s footer scripts section.
• Webflow: Go to Project Settings > Custom Code > Footer Code.
• Squarespace: Go to Settings > Advanced > Code Injection > Footer.
• Shopify: Edit your theme and add the script to theme.liquid before </body>.

How Chat Conversations Work

1. A visitor clicks the chat button on your website.
2. The widget opens and shows the welcome message.
3. The visitor types a message.
4. Your assigned AI agent responds in real time using its knowledge base and configured personality.
5. The conversation appears in ScendCore under Conversations with the web_chat channel tag.
6. Team members can take over the conversation at any time from the inbox.

Managing Widgets

On the Chat Widgets page, you can:

• View session count — See how many conversations each widget has handled
• Configure — Edit the widget’s settings, agent assignment, and appearance
• Copy Snippet — Get the embed code again
• Delete — Remove a widget permanently

Multiple Widgets

You can create multiple widgets for different pages or purposes. For example:

• A sales-focused widget on your pricing page with a sales agent
• A support widget on your help center with a support agent
• A general widget on your homepage with a general-purpose agent

Each widget can have a different AI agent assigned.

Troubleshooting

Widget not appearing on website

• Check that the embed snippet is in your page’s HTML and the data-key matches.
• Verify the widget is set to Active in ScendCore.
• Open your browser’s developer console and look for script loading errors.

Chat conversations not showing in ScendCore

• Ensure the widget has an AI agent assigned.
• Check the Conversations page with the channel filter set to “Chat”.