# Chatref Docs

## Docs

- [Welcome to Chatref](https://docs.chatref.ai/introduction.md): Put a smart AI chat assistant on your website that answers visitors using your own content.
- [Quickstart](https://docs.chatref.ai/quickstart.md): Go from sign-up to a live AI bot on your website in a few minutes.
- [Key Concepts](https://docs.chatref.ai/concepts.md): A plain-English glossary of the words you'll see across Chatref.
- [Creating an Agent](https://docs.chatref.ai/agents/creating-an-agent.md): Create your first AI bot in Chatref – either from your website in seconds, or from scratch with a name.
- [The Playground](https://docs.chatref.ai/agents/playground.md): Shape your bot's personality, model, and behavior on the left, then test it live on the right before you deploy.
- [Choosing a Model](https://docs.chatref.ai/agents/choosing-a-model.md): Chatref is multi-model – pick the right AI model for each agent from four tiers, balancing cost and reasoning power.
- [System Prompt](https://docs.chatref.ai/agents/system-prompt.md): Give your bot its instructions and personality – pick a ready-made persona or write your own system prompt.
- [Agent Settings](https://docs.chatref.ai/agents/agent-settings.md): Set your bot's names, description, button label, dark mode, and the messages visitors see first.
- [Knowledge Base Overview](https://docs.chatref.ai/knowledge-base/overview.md): Learn how the Knowledge Base trains your bot and the three ways to add content.
- [Training with Websites](https://docs.chatref.ai/knowledge-base/training-with-websites.md): Paste a URL and let Chatref crawl your site to train your bot on its content.
- [Training with Files](https://docs.chatref.ai/knowledge-base/training-with-files.md): Upload documents like PDFs and spreadsheets so your bot can answer from them.
- [Training with Text](https://docs.chatref.ai/knowledge-base/training-with-text.md): Paste a title and content to teach your bot a quick FAQ, policy, or fact.
- [Training Status](https://docs.chatref.ai/knowledge-base/training-status.md): Track when your sources finish training, retry failures, and read the training-complete email.
- [Widget Appearance](https://docs.chatref.ai/widget/appearance.md): Customize how your chat widget looks so it matches your brand and fits your website.
- [Quick Actions](https://docs.chatref.ai/widget/quick-actions.md): Add up to 4 shortcut buttons in the chat header so visitors can call, email, or open a link.
- [Suggested Messages](https://docs.chatref.ai/widget/suggested-messages.md): Give visitors clickable starter prompts so they know what to ask, and control the greeting bubble timing.
- [Help Menu](https://docs.chatref.ai/widget/help-menu.md): Add a menu of useful links inside your chat widget so visitors can find resources fast.
- [Display Rules](https://docs.chatref.ai/widget/display-rules.md): Control which pages of your site show the chat widget, using simple URL patterns.
- [Embed on Your Website](https://docs.chatref.ai/deploy/embed-on-website.md): Put your bot live on your site with a single script tag, and learn where to paste it.
- [Multi-Agent Routing](https://docs.chatref.ai/deploy/multi-agent-routing.md): Run several agents from one workspace with a single script, and show the right agent on each page.
- [Allowed Domains](https://docs.chatref.ai/deploy/allowed-domains.md): Lock your widget so it only runs on your own sites by keeping an allow-list of domains.
- [Conversations](https://docs.chatref.ai/inbox/conversations.md): Read every chat your bot has with visitors in the Inbox, in real time, and reply as a human when you need to.
- [Tags](https://docs.chatref.ai/inbox/tags.md): Organize and label your chats with automatic and manual tags, and learn how engagement types feed your Insights.
- [Human Handoff](https://docs.chatref.ai/inbox/human-handoff.md): Step into any chat and reply as a real person – your bot pauses until you hand it back.
- [Insights Overview](https://docs.chatref.ai/insights/overview.md): See how your bot performed over the last 7 or 30 days, what needs attention, and what to fix next.
- [Every Number Explained](https://docs.chatref.ai/insights/metrics-explained.md): A plain-English guide to every stat in your Insights dashboard and what counts as answered.
- [Answered vs Couldn't Answer](https://docs.chatref.ai/insights/answered-vs-couldnt.md): Find the questions your bot can't handle yet and learn the loop to fix them.
- [Custom Actions](https://docs.chatref.ai/custom-actions/overview.md): Make your bot do things, not just answer – with forms, buttons, and API calls it fires on its own.
- [Form Actions](https://docs.chatref.ai/custom-actions/form-actions.md): Let your bot show a form inside the chat to collect details, then save them and send them to your webhook.
- [Button Actions](https://docs.chatref.ai/custom-actions/button-actions.md): Give your bot a one-tap button it can show in the chat, then record the click and call your webhook.
- [API / Webhook Actions](https://docs.chatref.ai/custom-actions/api-webhook-actions.md): Let your bot call your own API mid-chat – no visitor form – and use the response to keep answering.
- [Billing Overview](https://docs.chatref.ai/billing/overview.md): Chatref is pay as you go – keep a balance in dollars and your bot spends a little from it whenever it works.
- [How Pricing Works](https://docs.chatref.ai/billing/how-pricing-works.md): Understand how Chatref works out cost – you pay for the text the AI reads and writes, and pricier models cost a bit more.
- [Add Funds](https://docs.chatref.ai/billing/adding-funds.md): Top up your Chatref balance so your bot keeps answering, and see how the free trial and expiry work.
- [Existing Subscribers](https://docs.chatref.ai/billing/existing-subscribers.md): If you signed up on an older monthly plan, nothing changes – here's how it relates to pay as you go.

## OpenAPI Specs

- [openapi](https://docs.chatref.ai/api-reference/openapi.json)