Chatzuri
Pricing
Guides
Guides
Introduction
  1. 1Getting Started
  2. 2Your Agent
    • Create an agent
    • AI configuration
    • Personality and presentation
    • Customise the chat widget
    • Test in the Playground
    • Voice, video, images, and files
    • How memory works
    • Multi-agent orchestration
    • Performance and cost controls
    • Security and access control
    • Compliance and guardrails
    • Improve response quality
  3. 3Knowledge & Sources
  4. 4Agent actions & Tools
  5. 5Agent Tasks
  6. 6WorkflowsBeta
  7. 7Channels
  8. 8Customers & Conversations
  9. 9Run Your Team
  10. 10Developer Tools
Developer reference →Showcase →
Guides2. Your AgentCustomise the chat widget
Chapter 2 · Your Agent

Customise the chat widget

Theme, colours, alignment, initial messages, suggested replies, footer, lead form.

6 min read

The chat widget is a customer's first impression of your agent. Every knob you need to make it match your brand lives under Settings → Interface.

Theme

Pick Light, Dark, or Auto (follows the visitor's system preference). For most marketing sites, Light is the right default.

Colours

  • Customer message colour — the bubble for messages the customer sends. This is the most prominent colour in the widget. Use your primary brand colour.
  • Chat bubble colour — the small launcher bubble in the corner. Often the same as the customer message colour.
  • Use customer colour as header — if on, the chat window header takes the same colour. Useful for a strong brand presence.

Alignment

Pick whether the launcher bubble appears bottom-right or bottom-left. Bottom-right is conventional in left-to-right languages.

Auto-show delay

Number of seconds after the page loads before the chat opens itself. Set to 0 to never auto-open (recommended for most sites). Anything between 5–15 seconds is reasonable if you want a proactive greeting.

Heads up
Auto-opening is high-leverage but feels spammy if it triggers on every page. Consider auto-show only on high-intent pages like pricing.

Initial messages and suggested replies

See the Personality guide for guidance — these settings live in the same Interface tab.

Footer

A short string of text under the chat (e.g. "Powered by Acme · Privacy policy"). Supports basic Markdown links.

Lead capture form

Under Settings → Leads:

  • Title — what the form asks ("Before we begin, can we get your details?").
  • Fields — name, email, phone, custom message. Toggle each on/off.
  • Notification email — where new leads get sent.

See the Capture and review leads guide for the full lead lifecycle.

Feedback and regenerate

  • Collect feedback — adds thumbs-up/down buttons on every agent reply. Great signal for improving prompts and sources.
  • Allow regenerate — lets customers ask for an alternate answer if the first response wasn't quite right.

Restricting where the widget loads

Under Settings → Security:

  • Allowed domains — comma-separated list. The widget will refuse to load on any other origin.
  • IP rate limit — cap how many messages a single IP can send per timeframe to deflect abuse.
Previous · Your AgentPersonality and presentationNext · Your AgentTest in the Playground
Chatzuri

AI-powered agents are transforming customer interactions by providing instant, intelligent responses around the clock. They help businesses reduce operational costs, improve response times, and scale support without compromising quality. These agents understand natural language, learn from conversations, and integrate with existing systems to offer personalized experiences that enhance customer satisfaction and loyalty.

Chatzuri

AI-powered agents are transforming customer interactions by providing instant, intelligent responses around the clock. They help businesses reduce operational costs, improve response times, and scale support without compromising quality. These agents understand natural language, learn from conversations, and integrate with existing systems to offer personalized experiences that enhance customer satisfaction and loyalty.

Product

  • Pricing
  • Security
  • Affiliates

Resources

  • API
  • Guides
  • Blog
  • Help

Company

  • About us
  • Privacy Policy
  • Terms of Service
  • Cookie Policy
  • DPA

About

  • Teams
  • Singapore, Nairobi

© 2026 Chatzuri. All rights reserved.

Chatzuri uses AI and can make mistakes.

Terms of ServicePrivacy PolicyCookie PolicyChatzuri