Best practices to start
Brand voice and positioning
Before you tune colors or buttons, decide how you want the agent to sound. Formal, direct, playful, and reassuring are all valid—what matters is consistency with your site copy and sales motion. If your homepage is crisp and opinionated, an overly generic assistant undermines trust; if your brand is warm and educational, a cold transactional tone feels out of place.
Write a short internal note (even bullet points) covering: who the product is for, what problem you solve in one sentence, words you like and words you avoid, and how you describe pricing without overpromising. Feed that thinking into your tone settings so every reply reinforces the same story a human on your team would tell on a good day.
Widget branding and trust
The widget is part of your UI. Match colors, corner radius, and logo usage to your design system so the chat feels native, not like a third party parked on top of your page. Visitors should recognize it as your assistant before they read the first message.
Keep the entry experience honest: use an agent name and greeting that align with how you introduce the product elsewhere. Avoid implying human staffing if you are not offering live handoff in that moment; clarity builds more trust than ambiguity.
What belongs in knowledge
The agent is only as accurate as the material it can ground answers in. Treat your knowledge base as the canonical brief you would give a new sales or success hire: pricing pages, feature summaries, security or compliance pages, implementation guides, comparison or positioning narratives, and updated release notes when they change how you talk about the product.
Site content and crawling
Start from URLs that already reflect how you sell today—your primary marketing domain, documentation subsite if it is public, and any pages that answer recurring pre-sales questions. Remove or exclude stale microsites so the agent does not resurrect old messaging.
Files and long-form docs
Upload PDFs when they carry facts you want cited accurately: one-pagers, security overviews, architecture diagrams explained in prose, or customer-facing policies. Keep filenames sensible; they help you audit what is in the library later.
What to leave out or handle carefully
- Draft or internal-only documents that contradict the public site.
- Legal text unless it is truly customer-facing and current.
- Huge duplicate pages that say the same thing in five places—pick the authoritative URL.
Refresh knowledge when you ship positioning or pricing changes. The best setups schedule a quick review after every meaningful go-to-market update.
Triggers and boundaries
Triggers let you start conversations when they help—after someone dwells on pricing, returns to a key page, or reaches a moment where a nudge reduces friction. Start conservative: a few high-signal rules beat dozens of noisy pop-ups. Watch early transcripts to see where visitors stall and add triggers there, not everywhere at once.
Decide what the agent should do when it is unsure: point to a doc, suggest contacting you, or collect an email—whatever matches your funnel. The dashboard exists so those defaults reflect your ethics and risk tolerance, not a one-size template.
Review and iterate
Plan a weekly or biweekly pass on top questions and categories in analytics. If the same objection appears repeatedly, update the site or knowledge rather than hoping the model improvises. The agent surfaces demand for clearer copy; marketing and product can respond in parallel.
When you change tone or knowledge, spot-check a handful of conversations on staging or production to confirm the voice still feels right. Small, deliberate iterations beat rare massive overhauls that are hard to debug.
