It Adds your AI agent to your website so visitors can start chatting.
Choose your embed type #
1. Basic Embed (Required) #
Use this for most cases.
Works for:
- Static websites
- Marketing sites
- Simple chat use cases
No login or user identification needed.
2. Authenticated Embed (Optional) #
Use this only if your product has login.
Needed when you want:
- User-specific responses
- Personalized conversations
- Secure actions (based on logged-in user)
Requires:
- JWT
- Secret Key
Add Basic Embed (mandatory) #
- Go to your Agent
- Open Embed Preview
- Copy the script
- Paste it before the closing </body> tag of your website
- Save and publish your site
That’s it , your chatbot is live.
When to use Authenticated Embed #
Use this only if:
- Your users log into your app
- You want the AI to know who the user is
You’ll need to:
- Generate a JWT token
- Pass user details securely
- Use the Secret Key for validation
Important notes #
- Basic Embed is required for the chatbot to work
- Authenticated Embed is an add-on, not a replacement
- Make sure your domain is added under Security → Allowed Domains
Embedding the AI Chat Widget on Your Web Application #
Once your agent is ready, you can embed it on your website to start interacting with users in real time.
How to Embed the Chat Widget #
Embed modal with script + style configuration
- Open your agent from the Dashboard
- Click Embed Preview (top right)
- Copy the script code
Add the Code to Your Website #
Paste the script before the closing </body> tag on your website.
Once added, the chatbot will appear on your site.
Customize Widget Appearance #
From the Style Configuration panel, you can adjust:
- Position (Bottom Left / Right)
- Widget and button size
- Device visibility
- Color scheme
- Spacing (offsets) and
- Initial language
Secure Your Widget (Recommended) #
Security tab with Allowed Domains and Rate Limit
Go to Security Settings to control where and how your widget can be used:
- Allowed Domains → Restrict the widget to specific websites
- Rate Limit → Control how many messages a user can send
- Limit Message → Show a message when the limit is reached
- Report Abuse → Enable abuse reporting
This helps prevent misuse and unauthorized embedding.
Important Notes #
- Make sure your agent is Active before embedding
- Changes update automatically on your website
- Always test after embedding
Once embedded and secured, your AI agent is ready to handle real user conversations on your website.
If you have any questions, concerns, or need further clarification, please contact support@highengage.com for assistance.
