Create a web widget deployment
A web widget deployment embeds your assistant on your website as a chat bubble with streaming replies, optional rich cards from tools, and your branding.
Prerequisites
Section titled “Prerequisites”- Assistant created with knowledge bases and/or tools configured
- Domain you control for allowed domains
- Go to Deployments → Create → Web widget.
- Name — e.g.
Marketing site – production. - Assistant — select which assistant powers this embed.
- Environment — development, staging, or production.
- Configure appearance (theme, colors, greeting).
- Add allowed domains.
- Optional: enable JWT verification for logged-in users.
- Save and copy embed code.
Install on your site
Section titled “Install on your site”Paste the script before </body> on every page that should show chat:
<script src="https://widget.chatevo.ai/chat.js" data-deployment-id="YOUR_DEPLOYMENT_ID" async></script>Platform-specific steps: WordPress, Webflow.
Verify
Section titled “Verify”- Open your site on an allowed domain.
- Send a test message — confirm streaming reply.
- If tools are attached, trigger a tool and confirm rich content if configured.
Multiple widgets
Section titled “Multiple widgets”Create separate deployments for staging vs production, or different assistants on different subsites — each has its own deployment ID and domain list.