Embed Widget

The widget is a chat bubble in the corner of your website. When a visitor clicks it, they can ask questions and get instant answers from your knowledge base - without leaving your page. This is the moment your agent goes to work for you, around the clock.

A visitor asks a question and the agent answers instantly from your knowledge base.

The DeskClone chat widget as a visitor sees it, with the agent's welcome message and a message input box

The DeskClone chat widget as a visitor sees it, with the agent's welcome message and a message input box

Publish and Get Your Website Code

1

Open your agent's Share tab

Go to Agents, click your agent card, and open the Share tab.

2

Set the look

On the Appearance sub-tab, set your display name, welcome message, and brand color.

3

Publish

On the Publish & share sub-tab, click Publish agent and confirm.

4

Copy the code

Your website code appears right there. Copy the script tag.

Open the Share tab to see your published agent and copy the ready-to-paste embed snippet.

The Share tab's Publish and share view showing the published state and the embed script snippet

The Share tab's Publish and share view showing the published state and the embed script snippet

Add It to Your Website

Paste the script tag into your website's HTML, just before the closing </body> tag:

<script
  src="https://agents.deskclone.ai/embed/chat.js"
  data-key="your-connection-key-here"
></script>

That is all most sites need - the widget loads on its own and does not slow your page down.

A few other options are on the Share tab if you need them:

  • Share link (https://agents.deskclone.ai/chat/your-slug) - a full-page chat you can send in an email or share with your team while testing.

  • iFrame - embeds the hosted full-page chat inside a fixed-size frame on your page.

  • Inline - mounts the chat directly inside an element of your own page (no floating bubble, no iframe) - ideal for a dedicated "Support" or "Help" page. Drop in a container and point the script at it with data-mode="inline":

    <div id="deskclone-chat" style="height:600px;max-width:480px;"></div>
    <script
      src="https://agents.deskclone.ai/embed/chat.js"
      data-key="your-connection-key-here"
      data-mode="inline"
      data-container="#deskclone-chat"
    ></script>
    

Customize the Look

On the Appearance sub-tab you can set:

  • Display name - shown in the widget header
  • Welcome message - the first thing visitors see
  • Primary color - the header and send button
  • Position - which corner the bubble sits in

Changes save instantly - you do not need to touch the script tag on your website again.

The Appearance sub-tab showing the primary color picker and a live preview of the widget

The Appearance sub-tab showing the primary color picker and a live preview of the widget

File and Photo Attachments

Visitors can attach files and photos right in the chat - images (JPEG, PNG, GIF, WebP), PDFs, and text or Markdown files. Your agent reads images as part of the conversation, so a visitor can show a screenshot of an error or a photo of a product and get help with it.

Visitor Ratings

Every answer carries thumbs up / thumbs down buttons - always visible on the newest answer (including on phones) and on hover for earlier ones. These ratings feed the Satisfaction number on your Quality dashboard, counted per conversation so one unhappy chat is one unhappy chat, no matter how many messages it rated.

The "Powered by DeskClone" Badge

By default the widget shows a small Powered by DeskClone badge. On Pro and Business plans it is hidden automatically, so visitors see only your brand.

Placement and Identity

Two more Share sub-tabs fine-tune the widget:

  • Placement - which corner the floating bubble sits in (bottom-right by default) and which of your pages it appears on.
  • Identity - the name and avatar your agent shows in the chat header.

Before You Go Live

A quick checklist:

  • [ ] Your agent has a personality description
  • [ ] Your knowledge base covers your most common questions
  • [ ] You have previewed the agent or opened the share link and had a real conversation
  • [ ] Your brand color and welcome message are set
  • [ ] Your agent is published

You do not need a perfect knowledge base to launch. Start with your top 10-20 questions and grow from there. Your agent will honestly say "I don't know" for anything it cannot answer - far better than a confident wrong answer.

What's Next

If the widget does not appear or conversations fail, the Troubleshooting guide walks through the common fixes (connection key, script placement, allowed domains).

Your widget is live. Next, connect your support inbox so emails become tickets too - head to Ticket Sources.

Was this page helpful?