# Tolkly

> Чат поддержки с ИИ для онлайн-бизнеса. Отвечает по страницам сайта с источником в каждом ответе, а что не может, передаёт операторам в Telegram или веб-инбокс. Виджет ставится одним тегом, настройки приходят с сервера.

Endpoint виджета: https://api.tolkly.io. Документация описывает версию на https://tolkly.io. У каждой страницы есть Markdown-версия: добавьте .md к адресу или пришлите Accept: text/markdown. Исходник документации — английский: /llms.txt.

## Продукт

- [Главная Tolkly](https://tolkly.io/ru): что такое Tolkly, цена в сравнении с Jivo и Intercom, демо на вашем сайте
- [Вопросы и ответы](https://tolkly.io/ru/faq): цена, что считается ИИ-диалогом, как проверяются ответы, передача человеку, Jivo и Intercom
- [Статьи](https://tolkly.io/blog): сравнения Tolkly с Jivo, Intercom и другими чатами и что меняет ИИ-чат поддержки
- [Статьи](https://tolkly.io/ru/blog): сравнения Tolkly с Jivo, Intercom и другими чатами и что меняет ИИ-чат поддержки
- [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 разговоров в месяц.

Тарифы: Старт $49 в месяц (до 10 операторов, 1 000 ИИ-диалогов), Бизнес $149 (операторы без лимита, 5 000 ИИ-диалогов); первый месяц бесплатно. На лимите бот передаёт разговоры операторам и ничего не списывает сверх.

## Инструкции для агентов

- Добавьте виджет один раз на сайт, в общий шаблон всех страниц, прямо перед </body>. У тега только `endpoint` и `project`: название, приветствие, цвета и кто отвечает приходят с сервера.
- Загружайте `widget.js` с endpoint; не копируйте его в репозиторий и не включайте в сборку.
- В одностраничном приложении `<tolkly-chat>` стоит вне router outlet, чтобы переживать смену страниц, а скрипт загружается один раз.
- Секрет подписи никогда не попадает в код страницы. Токены посетителей (HS256 JWT) подписывает сервер сайта, и только после вопроса владельцу.
- Не добавляйте список разрешённых доменов, если владелец не просил: чат работает на любом домене по умолчанию.
- При Content-Security-Policy разрешите endpoint в script-src, connect-src и img-src и добавьте blob: в img-src. В style-src ничего не нужно; при nonce для стилей поставьте тот же `nonce` на тег ради старого Safari.
- Проверяйте установку в браузере. Не шлите запросы с поддельным заголовком Origin: они записывают чужой сайт в домены проекта.

## Установка

- [Установка на сайт](https://tolkly.io/docs/ru/install.md): Куда вставить две строки и как проверить, что чат работает.
- [Фреймворки](https://tolkly.io/docs/ru/frameworks.md): Куда вставить две строки в Next.js, Nuxt, React, Vue, Angular, WordPress, Tilda и Битрикс.
- [Content-Security-Policy](https://tolkly.io/docs/ru/csp.md): Что разрешить для чата, если сайт отдаёт Content-Security-Policy.
- [Атрибуты виджета](https://tolkly.io/docs/ru/widget-attributes.md): Все атрибуты <tolkly-chat>, свойства цветов --tolkly-* и <tolkly-search>.
- [JS API и события](https://tolkly.io/docs/ru/widget-api.md): Как открыть чат, задать вопрос за посетителя, сказать, кто он, и узнать, что разговор ушёл к людям.
- [Подпись посетителя](https://tolkly.io/docs/ru/identity.md): Ваш сервер подписывает токен, и чат знает, какой вошедший посетитель пишет.
- [Для ИИ-агентов](https://tolkly.io/docs/ru/agents.md): llms.txt, Markdown-версия каждой страницы и промпт, который ставит чат через Claude Code или Cursor.

## Владельцу

- [Как отвечает Tolkly](https://tolkly.io/docs/ru/overview.md): Источник в каждом ответе, честный отказ, отметка ИИ, передача человеку, решённый вопрос и лимит ИИ.
- [Быстрый старт: от регистрации до первого разговора](https://tolkly.io/docs/ru/quickstart.md): Шесть шагов от создания компании до тестового разговора на вашем сайте.
- [Запуск и обзор](https://tolkly.io/docs/ru/launch.md): «Обзор» проекта — шаги запуска и их состояния, помощь к шагу, цифры за день, что можно улучшить, «Отчёты» и стартовая страница.
- [Как выглядит чат](https://tolkly.io/docs/ru/widget.md): Цвета и шрифт с вашего сайта, живое превью, языки, приветствие, подсказка и звуки чата.
- [База знаний и переиндексация](https://tolkly.io/docs/ru/knowledge.md): Что читает бот, как часто перечитывает сайты, как подхватывает зеркала и учится на ответах операторов.
- [Передача людям](https://tolkly.io/docs/ru/handoff.md): Когда бот передаёт разговор человеку, кто и когда отвечает, контакт посетителя, темы для оператора, шаблоны ответов и номер заявки.
- [Защита от спама](https://tolkly.io/docs/ru/spam.md): Лимиты на одну сеть, фильтр спама, проверка строже при наплыве, заблокированные посетители и папка «Возможно спам».
- [Операторы в Telegram](https://tolkly.io/docs/ru/telegram.md): Подключите группу компании и отвечайте на переданные разговоры в её темах — со сменами, рабочими именами и файлами.
- [Бот в Telegram для клиентов](https://tolkly.io/docs/ru/telegram-bot.md): Клиенты пишут вашему собственному боту в Telegram, отвечает тот же ИИ, а передачи людям приходят в тот же инбокс и ту же группу поддержки.
- [Инбокс в приложении](https://tolkly.io/docs/ru/inbox.md): Вкладки, поиск, как брать и назначать разговоры, шаблоны ответов, карточка посетителя, закрытие и смены.
- [Домены и зеркала](https://tolkly.io/docs/ru/domains.md): Чат работает на любом вашем домене, сообщает о каждом новом сайте и позволяет заблокировать чужой сайт или оставить чат только на доменах из списка.
- [Тариф, оплата и лимит](https://tolkly.io/docs/ru/billing.md): Бесплатный месяц, тарифы, оплата картой или криптовалютой, что считается ИИ-диалогом и что происходит, когда лимит исчерпан.

## Optional

- [Все страницы одним файлом](https://tolkly.io/docs/ru/llms-full.txt)
- [English version](https://tolkly.io/llms.txt)