Tolkly docs

• Owners: start with How Tolkly answers and the quickstart.
• Developers installing the chat: Install on a site.
• AI agents: read llms.txt first, then For AI agents.

For owners#

• How Tolkly answers: 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: Six steps from creating your company to a test conversation on your own site.
• Launch and overview: 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: The chat's colours and font from your site, the live preview, languages, greeting, hint and sounds.
• Knowledge base and reindexing: What the bot reads, how often it reads your sites again, how it picks up mirrors and learns from operators' answers.
• Handoff to people: 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: Limits per network, the spam filter, a harder check in a surge, blocked visitors and the «Possible spam» folder.
• Operators in Telegram: 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: 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: Views, search, taking and assigning conversations, reply templates, the visitor card, closing and shifts.
• Domains and mirrors: 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: 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: Where the two lines go and how to check that the chat is live.
• Frameworks: Where the two lines go in Next.js, Nuxt, React, Vue, Angular, WordPress, Tilda and Bitrix.
• Content-Security-Policy: What to allow for the chat when a site sends a Content-Security-Policy.
• Widget attributes: Every attribute of <tolkly-chat>, the --tolkly-* colour properties, and <tolkly-search>.
• JS API and events: Open the chat, ask a question for the visitor, say who they are, and learn when a conversation goes to people.
• Signed visitor identity: Your server signs a token, and the chat knows which signed-in visitor is writing.
• For AI agents: llms.txt, a Markdown twin of every page, and the prompt that installs the chat with Claude Code or Cursor.