Web Widget

Nexaflow Editor

5 MIN READ

Web widget setup

The web widget adds a Nexaflow agent to any website as a chat bubble.

#Where to find the widget code

  1. Open an agent.
  2. Go to Embed.
  3. Copy the installation script.

The script looks like:

<script
  src="https://your-domain.com/embed.js"
  data-bot-id="YOUR_AGENT_ID"
></script>
html

Paste it into the <head> or near the end of the <body> on your website.

#Preview before publishing

From Embed, use View Live Preview to open the public chat preview for the selected agent.

From Playground, use the preview panel to test widget appearance and behavior.

#What updates automatically

The widget reflects saved agent configuration, including:

  • Welcome message.
  • Suggested questions.
  • Theme color.
  • Launcher text.
  • Company logo.
  • Agent instructions.
  • Attached knowledge bases.
  • Enabled modules.

#Deployment checklist

Before installing the script on production:

  • Turn the agent live only after testing.
  • Confirm the correct knowledge base is attached.
  • Test module actions from Playground.
  • Add escalation copy.
  • Verify suggested questions.
  • Test the widget on mobile and desktop.

#Troubleshooting

The widget does not appear

Check:

  • The script is included on the page.
  • data-bot-id is correct.
  • The browser console has no blocked script errors.
  • Your site allows the embed script domain.

The widget appears but does not answer

Check:

  • Agent is live.
  • Workspace has available credits.
  • Agent has a valid model/provider configuration.
  • Knowledge and modules are attached correctly.

The widget shows old branding

Save agent changes, hard-refresh the website, and clear any site-level cache.

#Related guides

Helpful for you?

Help us improve the world of AI agents.

Keep Learning

View All Guides
Documentation

WhatsApp Setup

Documentation

Getting Started