Документация Tolkly

Чат поддержки с ИИ, который отвечает по страницам вашего сайта с цитатой из источника, а остальное передаёт вашим операторам в Telegram или в инбокс.

На странице

Владельцу

  • Как отвечает 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.