Chirpy Documentation

A friendly guide to building, customising, and embedding your AI assistant.

---

1. Build an assistant in 2 minutes

1. From the landing page, drop your website URL into Show Chirpy your website.
2. We crawl the site, extract your brand voice, and build a draft assistant.
3. Click Add to your website — you'll be taken to your dashboard playground with the brand pre-filled.

If you'd rather start from scratch, use New chatbot in the dashboard sidebar.

2. Customise

Open any assistant from your dashboard. The right-hand drawer is split into four tabs:

• Identity — name, description, tone, welcome message, and avatar (PNG/JPG/WebP, max 2MB).
• Appearance — primary, secondary, and accent brand colours, plus suggested topics shown to first-time visitors.
• Behaviour — the system prompt that drives every reply, the model (Claude Sonnet 4.6 by default), and creativity (temperature).
• Visibility — flip the public switch to enable embedding on real customer-facing sites.

All edits save automatically and reflect in the playground on the left.

3. Add knowledge

Go to the Sources tab on a chatbot. You can add:

• Files — drag-drop PDFs, txt or DOCX. We chunk and index everything.
• Text — paste FAQs, product copy, or any long-form text directly.
• Websites — point Chirpy at a URL and we'll crawl up to 10 pages.

Documents are converted into vector embeddings used at runtime to ground every reply.

4. Embed

Make the chatbot public in the Visibility tab, then open the Embed tab. Pick your platform — Plain HTML, Shopify, WordPress, Wix, Squarespace, Webflow, or Google Tag Manager — and follow the steps. The snippet looks like:

<script>
  window.chirpyAIConfig = {
    chatbotId: "<your-id>",
    primaryColor: "#1a1a1a",
    position: "bottom-right"
  };
</script>
<script src="https://your-chirpy-domain/widget.js" defer></script>

After installing, click Check installation to verify.

5. Conversations & analytics

• Conversations (per chatbot) — list every visitor session and replay messages with timestamps.
• Analytics (sidebar) — last 30 days of activity: messages/day chart, top chatbots, unique visitors, avg messages per conversation.

6. Plans

A credit is one AI reply (the standard Haiku model); the smarter Sonnet model costs more per reply. Upgrade from Settings → Billing.

7. Need help?

Email hello@chirpy.biz or use the live chat from the dashboard.