Skip to content
Chatevo Docs
← Site Start free trial

Quickstart: Embed widget on your website

Goal: Live chat widget on your site in ~10 minutes.

Prerequisites

Section titled “Prerequisites”
  • Assistant with at least one knowledge base attached
  • Access to your website HTML or CMS

Step 1 — Create deployment

Section titled “Step 1 — Create deployment”
  1. Go to Deployments → Create.
  2. Type: Web widget.
  3. Select your assistant.
  4. Environment: Production.

Step 2 — Allowed domains

Section titled “Step 2 — Allowed domains”
  1. In deployment settings, open Security → Allowed domains.
  2. Add your site, e.g. https://www.yourbusiness.com or https://*.yourbusiness.com.
  3. Save. The widget will not load on unlisted domains.

Optional: JWT identity verification

Section titled “Optional: JWT identity verification”

If your site has logged-in users, enable Require identity verification and set a shared secret. See JWT verification.

Step 3 — Appearance

Section titled “Step 3 — Appearance”
  1. Set primary color (default accent: #F97316).
  2. Choose light or dark theme.
  3. Set greeting message and optional suggested questions.

Step 4 — Embed code

Section titled “Step 4 — Embed code”
<script
  src="https://widget.chatevo.ai/chat.js"
  data-deployment-id="YOUR_DEPLOYMENT_ID"
  data-api-base="https://api.chatevo.ai"
  async
></script>

Paste before </body> on every page where chat should appear.

Step 5 — Verify

Section titled “Step 5 — Verify”
  1. Open your website.
  2. Confirm the chat bubble appears.
  3. Send a test message.

Troubleshooting

Section titled “Troubleshooting”