Web Widget

Embed a chat widget on any website. Visitors can talk to your agent directly from your site — no account required on their end.

---

Setup

1. Open your agent → Deploy → Web Widget
2. Click Enable Widget
3. Configure appearance: widget color, launcher text, initial message, position
4. Add your website’s domain to Allowed Domains
5. Copy the embed code

---

Embedding the widget

Paste just before the closing </body> tag:

<script>
  window.AuterynConfig = {
    agentId: "your-agent-id",
    apiKey: "your-widget-api-key",
  };
</script>
<script
  src="https://widget.auteryn.ai/v1/widget.js"
  async
  defer
></script>

---

Customization options

Colors & Branding

<script>
  window.AuterynConfig = {
    agentId: "your-agent-id",
    apiKey: "your-widget-api-key",
    theme: {
      primaryColor: "#f97316",
      textColor: "#ffffff",
      bubbleColor: "#f97316",
    },
    launcher: {
      text: "Ask our AI",
      position: "bottom-right",
    },
    greeting: "Hi! How can I help you today?",
  };
</script>

Passing User Context

If your users are logged in, pass their identity so the agent can personalize responses:

<script>
  window.AuterynConfig = {
    agentId: "your-agent-id",
    apiKey: "your-widget-api-key",
    user: {
      id: "user-123",
      name: "Alice Smith",
      email: "alice@example.com",
      metadata: {
        plan: "Pro",
        company: "Acme Corp",
      },
    },
  };
</script>

The agent can reference {{user.name}}, {{user.plan}}, etc. in its instructions.

---

Domain security

The widget only loads on domains you whitelist in Deploy → Web Widget → Allowed Domains. Requests from unlisted domains are rejected — this makes it safe to include your widget API key in client-side code.

---

Analytics

Go to Deploy → Web Widget → Analytics to see:

• Number of conversations
• Top questions users are asking
• Credit usage from widget conversations