# Asks

> Documentation for Asks — the AI support agent that answers customers on your website, WhatsApp, Instagram, email, and more.

## Guides

- [Introduction](https://docs.asks.app/index.md): What Asks is, who it's for, and where to start.
- [Quickstart](https://docs.asks.app/quickstart.md): Go from your website URL to a live AI agent in about ten minutes.
- [Core concepts](https://docs.asks.app/concepts.md): The vocabulary Asks uses — workspaces, channels, conversations, credits, and how they relate.
- [AI agent overview](https://docs.asks.app/ai-agent.md): How the Asks AI agent answers customers, the setup checklist, and where each setting lives.
- [Model & guidance](https://docs.asks.app/ai-agent/guidance.md): Choose the AI model tier, name the agent, set tone and response length, and add custom instructions.
- [Escalation & human handoff](https://docs.asks.app/ai-agent/escalation.md): When and how the AI hands conversations to your team — handoff rules, business hours, off-hours behavior, notifications, and automations.
- [Custom actions](https://docs.asks.app/ai-agent/actions.md): Let the AI agent call your HTTP APIs mid-conversation — order lookups, account checks, ticket creation.
- [MCP servers](https://docs.asks.app/ai-agent/mcp-servers.md): Connect external MCP servers so the AI agent can use their tools in customer conversations.
- [Data collection](https://docs.asks.app/ai-agent/data-collection.md): Have the AI agent gather leads and customer details conversationally and save them to the customer record.
- [Playground & evals](https://docs.asks.app/ai-agent/testing.md): Chat against your live agent configuration in the Playground, and measure answer quality with evals.
- [Knowledge base overview](https://docs.asks.app/knowledge-base.md): What the knowledge base is, the source types it holds, and how Asks turns your content into grounded answers.
- [Websites](https://docs.asks.app/knowledge-base/websites.md): Crawl your site into the knowledge base — review pages before crawling, sync on a schedule, and manage every page.
- [Articles](https://docs.asks.app/knowledge-base/articles.md): Write knowledge directly in the dashboard — public help articles, internal-only guidance, drafts, and folders.
- [Documents](https://docs.asks.app/knowledge-base/documents.md): Upload PDFs, Word files, spreadsheets, text files, and images — Asks extracts the text, with OCR for scans and images.
- [Articles & limits](https://docs.asks.app/knowledge-base/limits.md): What counts as a Knowledge Base Article, what each plan includes, and what happens when you reach the limit.
- [Channels overview](https://docs.asks.app/channels.md): Every surface your customers can reach you on, and how each one connects to Asks.
- [Website widget](https://docs.asks.app/channels/widget.md): Install the Asks chat widget on your site with one script tag, as a floating launcher or an inline embed.
- [Widget customization](https://docs.asks.app/channels/widget-customization.md): Configure the widget's content, style, behavior, and languages with a live preview of what customers will see.
- [Chat Page](https://docs.asks.app/channels/chat-page.md): A hosted chat page at app.asks.app/c/your-slug — share a link and customers can talk to you with nothing to install.
- [WhatsApp](https://docs.asks.app/channels/whatsapp.md): Connect a WhatsApp Business number through Meta's Embedded Signup and answer customers on WhatsApp.
- [Instagram](https://docs.asks.app/channels/instagram.md): Connect an Instagram professional account so your AI agent answers DMs, within Meta's messaging windows.
- [Facebook Messenger](https://docs.asks.app/channels/facebook.md): Connect one or more Facebook Pages so your AI agent answers Messenger conversations.
- [Telegram](https://docs.asks.app/channels/telegram.md): Connect a Telegram bot so your AI agent answers customers in Telegram direct messages.
- [Slack](https://docs.asks.app/channels/slack.md): Add Asks to a Slack workspace so your AI agent answers questions in DMs, mentions, and channels.
- [Discord](https://docs.asks.app/channels/discord.md): Connect a Discord bot so your AI agent answers in servers and DMs over a persistent gateway connection.
- [Email](https://docs.asks.app/channels/email.md): Turn your support address into an Asks channel with a single forwarding rule — no DNS changes required.
- [Shopify](https://docs.asks.app/channels/shopify.md): Connect your Shopify store so the agent answers with live products, policies, carts, and order status.
- [Inbox overview](https://docs.asks.app/inbox.md): One shared inbox for every conversation your AI agent and team handle, across all channels.
- [Takeover & collaboration](https://docs.asks.app/inbox/handoff.md): Take over from the AI, work conversations with your team, and reply on any channel.
- [Tickets, tags & SLAs](https://docs.asks.app/inbox/tickets.md): How conversations and tickets relate, and how to organize your queue with tags, canned responses, and SLA policies.
- [Customers](https://docs.asks.app/inbox/customers.md): A directory of everyone who has contacted you, deduplicated across channels, with a full profile per customer.
- [Help center](https://docs.asks.app/help-center.md): Publish a public, searchable help center from your knowledge base — on the web and inside the chat widget.
- [Analytics overview](https://docs.asks.app/analytics.md): See how your support is performing — volume, AI resolution, handoffs, and CSAT — with period-over-period deltas.
- [Topics & AI insights](https://docs.asks.app/analytics/insights.md): Automatic analysis of every conversation — what customers talk about, how they feel, and which conversations need your attention.
- [Ratings & CSAT](https://docs.asks.app/analytics/ratings.md): Ask customers to rate conversations when they wrap up, and see scores, reasons, and written feedback.
- [Team & roles](https://docs.asks.app/workspace/team.md): Invite teammates, understand what owners, admins, and members can do, and transfer ownership safely.
- [Plans & billing](https://docs.asks.app/workspace/billing.md): What each plan includes, how AI credits work, and how to manage add-ons, top-ups, and invoices.
- [Security](https://docs.asks.app/workspace/security.md): Account security with 2FA and session control, SAML SSO for the workspace, and data controls.
- [Plan limits & quotas](https://docs.asks.app/workspace/limits.md): The complete matrix — every plan limit, add-on price, and platform quota in one place.

## API

- [API overview](https://docs.asks.app/api.md): The Asks REST API — base URL, first request, pagination, idempotency, rate limits, and errors.
- [Authentication](https://docs.asks.app/api/authentication.md): Authenticate to the Asks API with a workspace API key, and limit what each key can do with scopes.
- [Agent chat API](https://docs.asks.app/api/agent-chat.md): Send messages to your trained AI agent from your own code and get structured replies in one round-trip.
- [Webhooks](https://docs.asks.app/api/webhooks.md): Receive Asks events on your server in real time — event types, signed deliveries, verification, and retries.
- [MCP server](https://docs.asks.app/api/mcp.md): Expose your Asks agent as a remote MCP server so Claude Code, Cursor, and other AI clients can talk to it.
- [Widget developer guide](https://docs.asks.app/api/widget.md): Embed script attributes, SPA installs, inline mode, sessions, domain allowlisting, and CSP for the Asks widget.