Customization

Simple Agent was designed to be invisible — the widget should look like part of your product, not a third-party tool bolted onto your site.

Widget appearance

Go to the agent panel → Appearance tab to configure:

Primary color

The color of the bubble button and highlighted elements inside the chat. The system automatically extracts the primary color from your site, but you can change it to any hex value.

Best practices:

• Use the highest-contrast color from your palette
• Avoid very light colors on light backgrounds (WCAG minimum is 4.5:1)
• The color is also applied to the avatar, widget border, and loading dots

Avatar

• Auto-generated: site favicon (default)
• Upload: PNG/JPG/SVG, minimum 64×64px
• Initials: if no image is set, displays the agent name initials (fallback)

Agent name

Shown in the widget header. Can be a real name (Simple Agent Support), a character (Luna), or neutral (Assistant).

Welcome message

The first message the user sees when they open the widget.

Default: "Hi! How can I help you?"

You can customize it to something more specific:

• "Hi! I'm Luna, specialist in XYZ products. How can I help?"
• "Welcome! Ask me anything about our plans."

Input placeholder

The text shown in the input field before the user starts typing.

Default: "Type your message..."

---

Tone of voice

In the Behavior tab, configure the tone of voice using 3 presets:

Preset	Style	Best for
Formal	Respectful, technical, no slang	B2B, legal, financial, medical
Balanced	Friendly, clear, professional but human	E-commerce, SaaS, general support
Casual	Informal, direct, colloquial without excess	Youth apps, lifestyle brands, edtech

The preset is a prefix in the system prompt. You can add extra instructions in the Additional instructions field.

---

Fallback message (out-of-scope)

When the agent can't answer — either because the question isn't in the sources, or because the FCS score is low — it shows the fallback message.

Default: "I don't have enough information to answer that. Can I connect you with our team?"

Customize this to something more natural for your brand.

Fallback options:

• Human handoff: shows a contact button (email, WhatsApp, Intercom)
• Default response: custom text
• Informed silence: agent says "I don't know" and asks to rephrase

---

Opening behavior

Option	Description
Bubble (default)	Button in the corner, user clicks to open
Auto-open	Opens automatically after X seconds
Re-engagement	Opens with a message after X seconds of inactivity
Inline	Embedded in the page, no bubble (via JS API)

Recommendation: Avoid auto-open under 10 seconds. Users who are still reading the page get annoyed by unexpected modals. 30–45 seconds gives the best engagement rate without frustrating users.

---

Position and z-index

<!-- Custom position via CSS (advanced) -->
<style>
  #cbk-bubble {
    bottom: 80px !important; /* above a cookie banner */
    right: 24px !important;
    z-index: 9999 !important;
  }
</style>

The widget uses Shadow DOM — internal CSS doesn't leak out, and external CSS doesn't affect the inside. To customize the interior, use the CSS variables exposed via data-theme:

<script
  src="https://simple-agent.me/widget/loader.js"
  data-agent-id="YOUR-AGENT-ID"
  data-theme='{"--af-accent":"#a3e635","--af-bg":"#09090b","--af-text":"#f4f4f5"}'
  async
></script>

---

White-label (Growth+ plan)

To completely remove Simple Agent branding:

1. Go to Settings → Branding
2. Enable Remove "Powered by Simple Agent"
3. Add your logo (it appears in the widget header in place of the default avatar)

Available from the Growth plan ($149/month). Full white-label with custom domain on the Agency plan ($399/month).