Документация Tolkly
Чат поддержки с ИИ, который отвечает по страницам вашего сайта с цитатой из источника, а остальное передаёт вашим операторам в Telegram или в инбокс.
На странице
- Владельцу: начните со страниц Как отвечает Tolkly и Быстрый старт.
- Разработчику, который ставит чат: Установка на сайт.
- ИИ-агенту: сначала llms.txt, затем Для ИИ-агентов.
Владельцу
- Как отвечает Tolkly: Источник в каждом ответе, честный отказ, отметка ИИ, передача человеку, решённый вопрос и лимит ИИ.
- Быстрый старт: от регистрации до первого разговора: Шесть шагов от создания компании до тестового разговора на вашем сайте.
- Запуск и обзор: «Обзор» проекта — шаги запуска и их состояния, помощь к шагу, цифры за день, что можно улучшить, «Отчёты» и стартовая страница.
- Как выглядит чат: Цвета и шрифт с вашего сайта, живое превью, языки, приветствие, подсказка и звуки чата.
- База знаний и переиндексация: Что читает бот, как часто перечитывает сайты, как подхватывает зеркала и учится на ответах операторов.
- Передача людям: Когда бот передаёт разговор человеку, кто и когда отвечает, контакт посетителя, темы для оператора, шаблоны ответов и номер заявки.
- Защита от спама: Лимиты на одну сеть, фильтр спама, проверка строже при наплыве, заблокированные посетители и папка «Возможно спам».
- Операторы в Telegram: Подключите группу компании и отвечайте на переданные разговоры в её темах — со сменами, рабочими именами и файлами.
- Бот в Telegram для клиентов: Клиенты пишут вашему собственному боту в Telegram, отвечает тот же ИИ, а передачи людям приходят в тот же инбокс и ту же группу поддержки.
- Инбокс в приложении: Вкладки, поиск, как брать и назначать разговоры, шаблоны ответов, карточка посетителя, закрытие и смены.
- Домены и зеркала: Чат работает на любом вашем домене, сообщает о каждом новом сайте и позволяет заблокировать чужой сайт или оставить чат только на доменах из списка.
- Тариф, оплата и лимит: Бесплатный месяц, тарифы, оплата картой или криптовалютой, что считается ИИ-диалогом и что происходит, когда лимит исчерпан.
Разработчику
- Установка на сайт: Куда вставить две строки и как проверить, что чат работает.
- Фреймворки: Куда вставить две строки в Next.js, Nuxt, React, Vue, Angular, WordPress, Tilda и Битрикс.
- Content-Security-Policy: Что разрешить для чата, если сайт отдаёт Content-Security-Policy.
- Атрибуты виджета: Все атрибуты <tolkly-chat>, свойства цветов --tolkly-* и <tolkly-search>.
- JS API и события: Как открыть чат, задать вопрос за посетителя, сказать, кто он, и узнать, что разговор ушёл к людям.
- Подпись посетителя: Ваш сервер подписывает токен, и чат знает, какой вошедший посетитель пишет.
- Для ИИ-агентов: llms.txt, Markdown-версия каждой страницы и промпт, который ставит чат через Claude Code или Cursor.