Get started

Welcome

Pitchbar is a sales-AI chat widget you embed on any website. A visitor opens your site, the widget loads, and an agent grounded in your own knowledge base answers their questions, captures leads, and hands off to a human when needed. This documentation covers how to build agents, embed them, run your workspace, and operate the platform.

New here?

Jump to the 5-minute Quickstart, or skim Core concepts to get the mental model first.

What you can do

Build an agent

Persona, tone, language, system prompt, confidence threshold — all configurable per agent.

Train it on your data

Crawl URLs and sitemaps, paste text, sync from Notion or Google Docs. Auto-index pages visitors land on.

Embed in one line

A single <script> tag drops the widget on any page. ≤50KB gzipped, isolated in a Shadow DOM.

Take over conversations

Real-time inbox lets a human jump in mid-thread. Visitor sees the handoff seamlessly.

Watch the metrics

Conversations, low-confidence gaps, lead conversion, deflection rate — all in one dashboard.

Plans & quotas

Stripe-backed subscriptions, monthly conversation quotas, branding removal on paid plans.

How it fits together

The product has three surfaces:

Customer app — the React/Inertia SPA you use to build agents, manage knowledge, run the inbox, and handle billing. Lives at /dashboard, /app/agents, /app/inbox, etc.
Visitor widget — the Preact bundle that runs on your customers' sites. Streams answers from the same backend over a signed JWT.
Platform admin — the operator-only console at /admin for plans, subscriptions, usage, queue health, and global notifications. Only super-admins see it.

Under the hood: Laravel 13 + Octane, Postgres + Redis, Laravel Reverb for realtime, Stripe via Cashier, Cloudflare Workers AI / Vectorize / Browser Rendering for the AI stack (with OpenAI + Qdrant as fallback). The full stack is documented under Architecture.

Reading order

The sidebar is grouped roughly in the order you'll need things — start from the top, skip what doesn't apply. If you're an operator running the platform, jump straight to Platform admin and Observability.