# Tolkly

> AI support chat for online businesses. It answers from the site's own pages with a source in every answer, and hands what it cannot answer to operators in Telegram or a web inbox. The widget is one script tag; its settings come from the server.

The widget endpoint is https://api.tolkly.io. These docs describe the version served at https://tolkly.io. Every page has a Markdown twin: add .md to its address, or send Accept: text/markdown.

## Product

- [Tolkly home page](https://tolkly.io/): what Tolkly is, the price compared with Jivo and Intercom, a live demo on your own site
- [Questions and answers](https://tolkly.io/faq): price, what counts as an AI conversation, how answers are checked, handoff, Jivo and Intercom
- [Articles (in Russian)](https://tolkly.io/blog): Tolkly compared with Jivo, Intercom and other chats, and what an AI support chat changes
- [Articles (in Russian)](https://tolkly.io/ru/blog): Tolkly compared with Jivo, Intercom and other chats, and what an AI support chat changes
- [Tolkly vs Intercom Fin: a Fin alternative without per-outcome fees](https://tolkly.io/vs/intercom): Tolkly vs Intercom Fin: seats from $29 plus $0.99 per Fin outcome against Tolkly's $49 a month for everything. Costs for 3 and 8 operators, with sources.
- [Tolkly или Intercom Fin: альтернатива Fin с ценой без оплаты за исходы](https://tolkly.io/ru/vs/intercom): Tolkly и Intercom Fin: место от $29 плюс $0,99 за исход Fin против $49 в месяц за всё у Tolkly. Расчёт на 3 и 8 операторов, источники, русский интерфейс.
- [Tolkly или Jivo: чат с ИИ для сайта без платы за каждого оператора](https://tolkly.io/ru/vs/jivo): Tolkly и Jivo: цены на 2026 год, ИИ-оператор Jivo за 12 990 ₽ против ИИ в тарифе Tolkly от $49, ответы с цитатой из источника, расчёт на 3 и 8 операторов.
- [Tolkly, Verbox, Carrot quest или Talk-Me: какой онлайн-чат с ИИ выбрать в 2026](https://tolkly.io/ru/vs/verbox-carrot-quest-talk-me): Сравнение Tolkly с Verbox, Carrot quest и Talk-Me: цены на 2026 год, как устроен ИИ, где отвечают операторы, расчёт на 3 и 8 операторов.
- [How AI support chats read your site: Intercom, Zendesk, Chatwoot, Crisp and Tolkly](https://tolkly.io/blog/ai-chat-reads-your-site): Which AI chats read a site by sitemap and links, how often they read it again, what they do with menus, robots.txt and JavaScript, and what to check before launch.
- [How an AI support chat affects conversion and the load on operators](https://tolkly.io/blog/ai-chat-conversion): What research says about response time, questions after hours and the share of conversations AI closes, and how to measure it on your own site.
- [How to answer website chats from Telegram](https://tolkly.io/blog/operators-in-telegram): How operators answer site visitors from the company's Telegram group in Tolkly: a topic per conversation, shifts, files, and why it beats a separate app.
- [What an AI support chat costs and how a hard cap on the bill works](https://tolkly.io/blog/ai-chat-cost-cap): Why paying per seat and per AI outcome grows the bill, how Tolkly's hard cap works, and a worked example for 3,000 conversations a month.
- [Why support bots make up prices and deadlines, and how to prevent it](https://tolkly.io/blog/ai-hallucinations-support): Real cases of support chatbots inventing rules, why it happens, and how a quoted answer, a check in code and an honest refusal prevent it.
- [Альтернативы Jivo в 2026: 6 онлайн-чатов с ИИ для сайта](https://tolkly.io/ru/blog/jivo-alternatives): Чем заменить Jivo в 2026: Tolkly, Carrot quest, Verbox, Talk-Me, Intercom Fin и Chatwoot. Цены с датами и источниками, сильные стороны каждого, расчёт на 3 и 8 операторов.
- [Как ИИ-чат поддержки влияет на конверсию и нагрузку на операторов](https://tolkly.io/ru/blog/ai-chat-conversion): Что говорят исследования о скорости ответа, вопросах в нерабочее время и доле разговоров, которые закрывает ИИ, и как это измерить на своём сайте.
- [Как ИИ-чаты поддержки читают ваш сайт: Intercom, Zendesk, Chatwoot, Crisp, Jivo и Tolkly](https://tolkly.io/ru/blog/ai-chat-reads-your-site): Кто из ИИ-чатов читает сайт по sitemap и ссылкам, как часто перечитывает, что делает с меню, robots.txt и JavaScript, и что проверить до запуска.
- [Как отвечать на чаты с сайта из Telegram](https://tolkly.io/ru/blog/operators-in-telegram): Как операторы отвечают посетителям сайта из Telegram-группы компании в Tolkly: тема на разговор, смены, файлы, и почему это удобнее приложения.
- [Почему бот поддержки выдумывает цены и сроки и как это предотвратить](https://tolkly.io/ru/blog/ai-hallucinations-support): Реальные случаи, когда чат-бот поддержки выдумал правила, почему так происходит и как ответ с цитатой, проверкой кодом и честным отказом это предотвращает.
- [Сколько стоит ИИ-чат поддержки и как работает жёсткий потолок счёта](https://tolkly.io/ru/blog/ai-chat-cost-cap): Почему оплата за операторов и за исходы ИИ растит счёт, как работает жёсткий потолок в Tolkly и пример расчёта для 3 000 разговоров в месяц.

Plans: Start $49 a month (up to 10 operators, 1,000 AI conversations), Business $149 (operators without limit, 5,000 AI conversations); the first month is free. At the limit the bot hands conversations to operators and never charges extra.

## Instructions for agents

- Add the widget once per site, in the layout every page shares, just before </body>. Give the tag only `endpoint` and `project`: the name, greeting, colours and who answers come from the server.
- Load `widget.js` from the endpoint; do not copy it into the repository or bundle it.
- In a single-page app, render `<tolkly-chat>` outside the router outlet, so it survives route changes, and load the script once.
- Never put the identity secret in browser code. Sign visitor tokens (HS256 JWT) on the site’s server and ask the owner before adding them.
- Do not add a domain allowlist unless the owner asks: the chat runs on any domain by default.
- With a Content-Security-Policy, allow the endpoint in script-src, connect-src and img-src, and add blob: to img-src. style-src needs nothing; with a style nonce, put the same `nonce` on the tag for older Safari.
- To check an install, open the site in a browser. Do not send requests with a forged Origin header: they record a stranger’s site among the project’s domains.

## Install

- [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.

## 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.

## Optional

- [All pages in one file](https://tolkly.io/llms-full.txt)
- [Русская версия](https://tolkly.io/docs/ru/llms.txt)