# Hourzero documentation

> Plain-language guides for building an AI agent, teaching it about your business, and putting it in front of customers.

Hourzero lets you build an AI agent that answers your customers' questions using your own information: your website, your policies, your product details. You teach it, test it privately, and then put it live on your website, WhatsApp, Instagram, and other places your customers already talk to you.

You don't need to write code. Most of the work is the same work you'd do to train a new support teammate: give them the right documents, tell them how to behave, and check their answers before they talk to customers.

![The Hourzero Playground: settings on the left and a live chat with the Acme Support agent on the right](https://hourzero.dev/marketing/app/playground-chat-light.webp "The Playground, where you test your agent before customers see it. Here the agent handles a jacket return using Acme's return policy.")

## How it works

1. **Teach it**: Add your website, files, and common questions and answers.
2. **Shape it**: Describe its job, its tone, and the rules it must follow.
3. **Test it**: Chat with it privately in the Playground.
4. **Go live**: Publish it to your website or a messaging app.
5. **Improve it**: Read real conversations and fill the gaps.

## Start here

New to Hourzero? These three pages take you from zero to a working agent.

- [What is Hourzero?](https://hourzero.dev/docs/quick-start/introduction): The big picture in five minutes: agents, knowledge, drafts, and channels.
- [Build your first agent](https://hourzero.dev/docs/quick-start/your-first-agent): A step-by-step walkthrough, from your website address to a live chat bubble.
- [Tips for a great agent](https://hourzero.dev/docs/quick-start/best-practices): Simple habits that make answers more accurate and keep customers happy.

> [!TIP]
> Looking for something specific? Use **Search docs** at the top of the sidebar, or press **⌘K** on a Mac (**Ctrl+K** on Windows). Search looks inside every article, not only page titles.

## Teach and shape your agent

- [Data sources](https://hourzero.dev/docs/ai-agent-management/data-sources): Add website pages, files, text, and Q&A so the agent knows your business.
- [Instructions](https://hourzero.dev/docs/ai-agent-management/build): Tell the agent what its job is, how to sound, and when to hand over to a person.
- [Guardrails](https://hourzero.dev/docs/ai-agent-management/guardrails): Set the rules it must never break, and protect it from misuse.
- [Playground](https://hourzero.dev/docs/ai-agent-management/playground): Chat with your draft agent and style it for each channel.
- [AI models](https://hourzero.dev/docs/ai-agent-management/models): Choose the AI model behind your agent, balancing quality, speed, and cost.
- [Suggestions](https://hourzero.dev/docs/ai-agent-management/suggestions): Improvement ideas your agent spots in real conversations, with the evidence behind them.

## Let your agent do things

Answering questions is only the start. Your agent can also collect details, look things up, and hand a chat to your team.

- [Actions](https://hourzero.dev/docs/ai-agent-management/actions/overview): Collect leads, show forms and buttons, search the web, or call your own systems.
- [Widgets](https://hourzero.dev/docs/ai-agent-management/widgets): Show what an action returns as cards, lists, and forms customers can use in the chat.
- [Procedures](https://hourzero.dev/docs/ai-agent-management/procedures/overview): Step-by-step playbooks for tasks like returns or address changes.
- [Skills](https://hourzero.dev/docs/ai-agent-management/skills): Ready-made abilities, such as creating PDFs or reading spreadsheets.
- [MCP servers](https://hourzero.dev/docs/ai-agent-management/mcp): Plug the agent into tools from other apps you already use.
- [Human escalation](https://hourzero.dev/docs/ai-agent-management/actions/human-escalation): Let the agent pass a conversation to a person when it should.
- [Benchmark Agent](https://hourzero.dev/docs/ai-agent-management/benchmarks): Give your agent a test before and after changes to see what improved.

## Put it in front of customers

Each place your agent can talk to customers is called a **channel**. You can use several at once.

- [Website widget](https://hourzero.dev/docs/integrations/website-widget): Add a chat bubble or a chat bar to your website.
- [Chat Iframe](https://hourzero.dev/docs/integrations/chat-iframe): Embed a full-size chat inside a page of your website.
- [WhatsApp](https://hourzero.dev/docs/integrations/whatsapp): Answer customers on your WhatsApp business number.
- [Instagram](https://hourzero.dev/docs/integrations/instagram): Reply to Instagram direct messages.
- [Messenger](https://hourzero.dev/docs/integrations/messenger): Reply to messages sent to your Facebook page.
- [Slack](https://hourzero.dev/docs/integrations/slack): Answer questions inside your Slack workspace.
- [All channels](https://hourzero.dev/docs/integrations): Discord, Telegram, webhooks, and how to choose.

> [!IMPORTANT] Saving is not the same as going live
> Changes you make are saved to a **draft** that only you and your team can see. Customers keep getting the current live version until you **publish**. Read [Publishing and version history](https://hourzero.dev/docs/ai-agent-management/deployments) to see how this protects you.

## Run your agent day to day

- [Conversations](https://hourzero.dev/docs/ai-agent-management/conversations): Read every chat, and step in to reply yourself when needed.
- [Helpdesk](https://hourzero.dev/docs/ai-agent-management/helpdesk): Manage the chats your agent hands to your team, like a shared inbox.
- [Contacts](https://hourzero.dev/docs/ai-agent-management/contacts): See the people who have talked to your agent.
- [Leads and collected data](https://hourzero.dev/docs/ai-agent-management/submissions): Find the names, emails, and form answers your agent gathered.
- [Analytics](https://hourzero.dev/docs/ai-agent-management/analytics): See how many chats you get, what people ask about, and how they feel.
- [Backstage](https://hourzero.dev/docs/ai-agent-management/backstage): Ask plain questions about how your agent is doing and get answers with charts.

## Your workspace and account

Your **workspace** is your company's home in Hourzero. It holds your agents, your teammates, and your plan.

- [Manage your workspace](https://hourzero.dev/docs/workspace-management/manage): Create agents, rename your workspace, and switch between workspaces.
- [Invite teammates](https://hourzero.dev/docs/workspace-management/members): Add colleagues and choose what each person can do.
- [Usage and credits](https://hourzero.dev/docs/workspace-management/usage): See how many messages you've used and what they cost.
- [Plans and billing](https://hourzero.dev/docs/workspace-management/billing): Change your plan, update payment details, and download invoices.
- [Account security](https://hourzero.dev/docs/security/account): Manage your password, two-step sign-in, and active sessions.
- [Single sign-on](https://hourzero.dev/docs/security/single-sign-on): For IT admins: let your team sign in with your company login.

## Need help?

- [Frequently asked questions](https://hourzero.dev/docs/help-and-support/faq): Quick answers to the questions new users ask most.
- [Troubleshooting](https://hourzero.dev/docs/help-and-support/troubleshooting): Fix common problems, like a chat bubble that doesn't appear.
- [Feature availability](https://hourzero.dev/docs/help-and-support/feature-availability): What's ready to use today and what's still coming.
