# Tolkly docs

> An AI support chat that answers from your site's pages with a source and hands the rest to your operators in Telegram or the inbox.

- **Owners:** start with [How Tolkly answers](https://tolkly.io/docs/en/overview.md) and the [quickstart](https://tolkly.io/docs/en/quickstart.md).
- **Developers** installing the chat: [Install on a site](https://tolkly.io/docs/en/install.md).
- **AI agents:** read [llms.txt](https://tolkly.io/llms.txt) first, then [For AI agents](https://tolkly.io/docs/en/agents.md).

## For owners
- [How Tolkly answers](https://tolkly.io/docs/en/overview.md): A source in every answer, an honest refusal, the AI mark, handoff to a person, what counts as resolved, and the AI limit.
- [Quickstart: from sign-up to the first conversation](https://tolkly.io/docs/en/quickstart.md): Six steps from creating your company to a test conversation on your own site.
- [Launch and overview](https://tolkly.io/docs/en/launch.md): The project's «Overview» — the launch steps and their states, help with a step, the day's numbers, what is worth setting up, «Reports» and the start page.
- [How the chat looks](https://tolkly.io/docs/en/widget.md): The chat's colours and font from your site, the live preview, languages, greeting, hint and sounds.
- [Knowledge base and reindexing](https://tolkly.io/docs/en/knowledge.md): What the bot reads, how often it reads your sites again, how it picks up mirrors and learns from operators' answers.
- [Handoff to people](https://tolkly.io/docs/en/handoff.md): When the bot hands a conversation to a person, who answers and when, the visitor's contact, topics for an operator, reply templates and the order number.
- [Spam guard](https://tolkly.io/docs/en/spam.md): Limits per network, the spam filter, a harder check in a surge, blocked visitors and the «Possible spam» folder.
- [Operators in Telegram](https://tolkly.io/docs/en/telegram.md): Link your company's group, then answer handed-off conversations in its topics, with shifts, work names and files.
- [A Telegram bot for your customers](https://tolkly.io/docs/en/telegram-bot.md): Customers write to your own Telegram bot, the same AI answers, and handoffs come to the same inbox and support group.
- [The inbox in the app](https://tolkly.io/docs/en/inbox.md): Views, search, taking and assigning conversations, reply templates, the visitor card, closing and shifts.
- [Domains and mirrors](https://tolkly.io/docs/en/domains.md): The chat works on any of your domains, tells you of each new site, and lets you block one that is not yours or keep the chat to a list.
- [Plan, payment and limit](https://tolkly.io/docs/en/billing.md): The free month, the plans, paying by card or in crypto, what counts as an AI conversation and what happens when the limit is reached.

## For developers
- [Install on a site](https://tolkly.io/docs/en/install.md): Where the two lines go and how to check that the chat is live.
- [Frameworks](https://tolkly.io/docs/en/frameworks.md): Where the two lines go in Next.js, Nuxt, React, Vue, Angular, WordPress, Tilda and Bitrix.
- [Content-Security-Policy](https://tolkly.io/docs/en/csp.md): What to allow for the chat when a site sends a Content-Security-Policy.
- [Widget attributes](https://tolkly.io/docs/en/widget-attributes.md): Every attribute of \<tolkly-chat\>, the --tolkly-\* colour properties, and \<tolkly-search\>.
- [JS API and events](https://tolkly.io/docs/en/widget-api.md): Open the chat, ask a question for the visitor, say who they are, and learn when a conversation goes to people.
- [Signed visitor identity](https://tolkly.io/docs/en/identity.md): Your server signs a token, and the chat knows which signed-in visitor is writing.
- [For AI agents](https://tolkly.io/docs/en/agents.md): llms.txt, a Markdown twin of every page, and the prompt that installs the chat with Claude Code or Cursor.