D
DeskClone Docs

Embed Widget

The embed widget is how your website visitors interact with Jarvis. It appears as a chat bubble in the corner of your site. When a visitor clicks it, a conversation window opens and they can ask questions, get answers from your knowledge base, and get support - all without leaving your page.

This is the core product action. Once the widget is live, Jarvis is working for you around the clock.

Getting Your Embed Code

1

Go to your agent

Navigate to Agents in the sidebar and click your agent card to open the configuration page.

2

Open the Publish tab

Click the Publish tab. This is where you manage publishing, embed code, and widget appearance.

3

Configure your widget

Under the Appearance sub-tab, set your agent name, welcome message, and brand colors. The primary color controls the widget header and send button. Choose a color that matches your website.

4

Publish your agent

Go to the Publish and share sub-tab and click Publish agent. A confirmation dialog will appear - confirm to generate your unique API key and make Jarvis available on your website.

5

Copy the embed code

After publishing, your embed code appears on the same page. Copy the script tag and paste it into your website.

Adding to Your Website

There are three ways to add Jarvis to your website:

Copy the script tag from the Publish tab and paste it into your website's HTML, just before the closing </body> tag:

<script
  src="https://jarvis.deskclone.ai/embed/chat.js"
  data-key="your-api-key-here"
  data-theme="light"
  data-welcome="Hi! How can I help you today?"
></script>

This is the recommended method. It loads the widget asynchronously and does not affect your page load speed.

If you want to share Jarvis as a standalone page (not embedded on your site), use the share link:

https://jarvis.deskclone.ai/chat/your-url-slug

This opens a full-page chat experience. Useful for sharing with your team during testing, or as a link in emails and social media.

iFrame

For more control over placement, you can embed Jarvis in an iFrame:

<iframe
  src="https://jarvis.deskclone.ai/chat/your-url-slug"
  width="400"
  height="600"
  style="border: none;"
></iframe>

This is useful if you want to embed the full chat experience inside a specific section of your page rather than as a floating bubble.

Customizing the Widget

From the Appearance sub-tab on the Publish tab, you can customize:

  • Agent Name - shown in the widget header
  • URL Slug - the unique identifier for your share link (automatically cleaned up from your input)
  • Welcome Message - the first thing visitors see when they open the chat
  • Primary Color - header background and send button

Changes to the welcome message, colors, and name take effect immediately after saving - you do not need to update the script tag on your website.

Powered by Jarvis Badge

By default, the widget shows a small "Powered by Jarvis" badge at the bottom. This badge includes a link to remove it by upgrading.

On Pro and Business plans, the badge is automatically hidden (white-label). Your visitors see only your brand - no DeskClone AI branding.

If you are on a Free or Starter plan, the badge is displayed automatically. Upgrading to Pro or above removes it with no code changes needed on your end.

Support Form

In addition to the chat widget, you can also publish a Support Form - a structured form that visitors can fill out to submit a request. The form is configured from Tickets > Sources > Forms and supports the same branding options. It generates its own embed code.

Deployment Readiness

Before going live, make sure you have:

  • [ ] Written a personality description for Jarvis (in Agents > Personality tab)
  • [ ] Added content to your knowledge base (at least a few articles covering your most common questions)
  • [ ] Previewed the agent using the persistent preview panel or the share link
  • [ ] Set your brand colors and welcome message
  • [ ] Published your agent

You do not need a perfect knowledge base to go live. Start with your top 10-20 most common questions and add more over time. Jarvis will honestly say "I don't know" for questions outside your content - which is better than making something up.

Testing Before Going Live

Before adding the widget to your production website, test it:

  1. Use the share link - open it in a browser and have a conversation. Check that the tone, accuracy, and branding look right.
  2. Test on a staging site - if you have a staging or development version of your website, add the script tag there first.
  3. Try edge cases - ask questions Jarvis cannot answer. Verify it responds gracefully instead of guessing.

Troubleshooting

Widget not appearing

  • Check the API key - make sure the data-key attribute in your script tag matches the key shown on your agent's Publish tab under Connection key
  • Check script placement - the script tag should be placed before </body>, not in the <head>
  • Check your browser console - open developer tools (F12) and look for any error messages

CORS errors

If you see CORS errors in your browser console, your domain may not be in the allowed origins list. Go to Agents > Publish tab and check the Placement sub-tab for the Allowed domains setting.

Widget loads but conversations fail

  • Verify that your agent is published (the Publish tab should show your agent as already published)
  • Check that your agent has remaining conversations for the month
  • Try the share link directly - if that works, the issue is with your website's script tag placement

What's Next

Your widget is live - visitors can now chat with Jarvis on your website. To set up automatic ticket creation from your support email, head to Ticket Sources.

Previous

Smart Import

Next

Ticket Sources

Was this page helpful?