telybot Чуть менее обыденно.
Намного умнее.
RussiaEnglish Войти Связаться Начать бесплатно
Документация TelybotСправочник

Лимиты и безопасность

Ваш Client ID общедоступен — и это нормально

Ключ в вашем теге скрипта (kb_live_…) предназначен для публичного доступа, точно так же, как идентификатор Google Analytics. Любой, кто просматривает исходный код вашей страницы, может его прочитать. Все, что он может сделать — это задавать вопросы вашему боту.

Никогда не размещайте так называемый секретный ключ на веб-странице или в приложении. Все, что отправляется в браузер, может быть прочитано. Telybot никогда не попросит вас об этом.

Размещение бота на ваших сайтах

Добавьте свои домены в разделе Установка → Ограничить вашими доменами. Как только список будет заполнен, доступ с других сайтов будет заблокирован.

  • Поддомены указанного домена включены: добавление example.com также разрешает shop.example.com.
  • Ваша ссылка на бота и QR-код работают всегда — они размещены на нашей странице.
  • Локальная разработка (localhost) всегда разрешена, чтобы вы могли тестировать.

Это предотвращает встраивание вашего бота на чужой веб-сайт. Это не является и не может быть защитой от запросов, выполняемых скриптами — браузеры обеспечивают это, скрипты могут заявлять что угодно. Для этого существует ежемесячный лимит, указанный ниже.

Лимит ответов в месяц

Каждый тарифный план включает определенное количество ответов в месяц. Когда лимит исчерпан, помощник перестает отвечать до начала следующего месяца, чтобы вам не пришлось платить по счетам, на которые вы не соглашались.

Ответ засчитывается, когда наш ИИ подготовил ответ — включая случаи, когда он прочитал вопрос и пришел к выводу, что не может на него ответить. Он не засчитывается, когда:

  • ваш сохраненный ответ отправлен напрямую, или
  • ассистент отказался отвечать до обращения к ИИ.

Поскольку сохраненные ответы бесплатны, бот, достигший своего лимита, продолжает отвечать всем, что написал его владелец вручную — он деградирует до вашего собственного FAQ, а не замолкает.

Вы можете отслеживать использование лимитов на главной странице личного кабинета. Напишите нам, если нужно увеличить лимит.

Дневной лимит

Также существует ограничение на ответы в день: одна пятая часть вашего месячного лимита, и никогда не менее 50. Бот, достигший этого лимита, перестает использовать ИИ до следующего дня (UTC), и посетители видят сообщение «Этот бот ответил на необычно большое количество вопросов сегодня и отдыхает до завтра». Сохраненные ответы продолжают работать, как и при месячном ограничении.

Это существует потому, что скрипт, обнаруживший ваш публичный Client ID, может иначе потратить ваш месячный лимит за одну ночь. Реальный бизнес, расходующий пятую часть месячного лимита каждый день, все равно исчерпал бы его за пять дней, поэтому ограничение — это не то, что сдерживает честное использование, а то, что ограничивает ущерб от действий посторонних лиц до того, как вы это заметите. Если у вас действительно такой большой трафик, попросите нас увеличить лимит; потолок будет поднят.

Лимиты запросов

Посетители могут задавать до 60 вопросов в минуту с одного IP-адреса. Реальный диалог никогда не приближается к этому лимиту, а вот скрипт, атакующий вашего бота, — вполне.

Лимит намеренно сделан щедрым, так как мобильные сети часто объединяют множество пользователей под одним адресом — ваши клиенты никогда не должны получать сообщение «слишком много запросов» из-за чужого трафика. Ваш ежемесячный лимит ответов, который рассчитывается на бизнес, а не на адрес, — это то, что на самом деле защищает вас от неожиданных счетов.

Файлы от посетителей

ФотоJPG, PNG, WebP или GIF — до 5 МБ каждый
ДокументыPDF, Word (.docx), обычный текст, CSV или Markdown — до 10 МБ каждый
За сообщение3 файла
На диалог10 файлов
На бота в день300 файлов (UTC)
Загрузок с одного адреса10 в минуту

Тип файла проверяется по самим байтам, а не по имени, поэтому SVG или программа, переименованная в .png, будет отклонена. Файлы хранятся вместе с диалогом и удаляются вместе с ним. Они никогда не учитываются в лимите ответов — их ограничивает только дневной потолок, указанный выше, — а полностью отключить файлы можно в разделе Установка.

Сводки

У сводок по чатам и ежедневных сводок есть собственный лимит — 40 в день на бота, — который учитывается только при создании новой сводки. Повторное чтение или скачивание PDF уже существующей сводки бесплатно. Чтобы составить сводку, в чате должно быть минимум два сообщения. Сводки не учитываются в лимите ваших ответов.

Приветственный сценарий

Ответы на приветственный сценарий принимаются не чаще 30 в минуту с одного адреса, а в сценарии может быть не более 12 шагов.

Действия

Действие вызывает ваш собственный API с наших серверов. У бота может быть 8 действий; каждое может запросить у клиента 6 значений и отправить 8 заголовков, а у вашего API есть 8 секунд на ответ. Один чат может выполнить 6 запросов за десять минут, один интернет-адрес — 20 в час, а ваш API получает от вашего бота не более 120 вызовов в минуту. Запрос считается одним ответом.

Вызывать можно только адреса https:// в публичном интернете, редиректы не выполняются, и каждый запрос подписывается, чтобы ваш сервер мог проверить, что он пришел от вашего бота. Ваш API-ключ хранится в зашифрованном виде и никогда не отправляется в браузер или приложение.

Меню или список услуг вмещает до 500 позиций, у каждой — до шести вариантов; один импорт считывает до шести фото за раз, а импорты, которые мы считываем за вас (фото, документы, ваши источники «Обучить»), можно запускать до 10 раз в день. В заказе может быть до 30 позиций и до 50 штук каждой. В одном чате одновременно может быть три открытых заказа и три открытые записи, с одного интернет-адреса можно оформить 30 в час, а бот принимает до 500 заказов и записей в день, включая тестовые. Письма о каждом новом заказе или записи перестают приходить после 200 в день; на экранах «Заказы» и «Записи» видны все. Уведомления в WhatsApp ограничены 100 в день на компанию, а каждый член команды может отправить три тестовых сообщения в час. Во время раннего доступа ничего из этого не стоит денег.

Лимиты файлов базы знаний

Документы, которые вы загружаете как базу знаний в разделе Обучение:

Максимальный размер файла8 МБ
Принятые типыPDF, Word (.docx), обычный текст, Markdown, CSV
Текст, прочитанный из документаБольшие документы читаются до определенного предела, и источник сообщает вам, когда это произошло.
Next: Your data →