ретенси-боты
ГлавнаяИнтеграцииСправка
ВойтиНачать бесплатно

Справка

Как устроен конструктор: сценарии, триггеры, подключения, рассылки и тарифы.

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

TelegramMAX
Начало работыСценарии и канвасИИ-агентыТриггеры (точки входа)ПодключенияБот приостановлен: конфликт токенаЧат на сайтеПодписчикиДиалогиРассылкиПубликацииЗаписьАналитикаСтраницыMCP-токеныТарифы и оплатаПартнёрская программаКакие данные собирает кабинетПоддержка

Начало работы

retensy-bots — конструктор ботов для Telegram и MAX. Вы собираете цепочку из блоков на визуальном холсте, и она сама общается с людьми и связывает ваши сервисы. Бот — только один из входов: ту же цепочку запускают вебхук, расписание и прошедшая оплата. Ниже — как это устроено и с чего начать.

Как устроен продукт

Всё крутится вокруг сценария — схемы из блоков, соединённых стрелками. Человек (или событие из вашей CRM) попадает в начало схемы и проходит её по шагам: получает сообщения, отвечает на вопросы, попадает в разные ветки в зависимости от ответов.

Сценарий привязывается к каналу связи (Telegram- или MAX-бот) либо запускается вебхуком без всякого бота. Один и тот же кабинет держит сколько угодно ботов и сценариев — лимит зависит от тарифа.

Первый сценарий за 5 шагов

  1. Подключите бота: раздел «Подключения» → «Добавить» → Telegram, вставьте токен от @BotFather. Сразу после подключения откроется выбор шаблона сценария: возьмите готовый (меню, FAQ, заявка, ИИ-агент) — редактор откроется на нём — или нажмите «Собрать бота за 5 минут» и ответьте на несколько вопросов без холста.
  2. Если шаблон не нужен, закройте окно и откройте «Сценарии» → «Новый сценарий», выбрав этого бота.
  3. На холсте добавьте точку входа (например команду /start) и блок «Сообщение» с приветствием, соедините их стрелкой. Проверьте путь кнопкой «Тест-прогон» — подписчикам при этом ничего не уходит.
  4. Нажмите «Опубликовать» — конструктор проверит схему и сделает её активной. Пока сценарий «Черновик», бот его не использует.
  5. Напишите боту /start в Telegram и убедитесь, что пришло ваше сообщение. Затем раздайте бота: ссылка и QR-код появятся сразу после публикации.

Обучение и первые шаги

После регистрации кабинет показывает короткое обучение из шести шагов с подсветкой нужных элементов: подключение канала, чек-лист первых шагов, разделы кабинета, публикация и меню «Помощь». Листайте кнопками «Далее» и «Назад», стрелками на клавиатуре; Escape и «Пропустить» закрывают обучение. Если поставить галочку «Больше не показывать», оно не вернётся; без галочки закрытое обучение предложится снова при следующем визите.

При первом открытии редактора сценария и страницы ИИ-агента появляются свои короткие подсказки (пять и четыре шага). Любое обучение можно пройти заново: меню «Помощь» → «Пройти обучение заново» (на странице редактора или агента — подсказки именно по ним), а в редакторе ещё и кнопка «?» в шапке.

Что пройдено и что скрыто, хранится в вашем профиле, а не в браузере: на другом устройстве и после очистки браузера обучение не повторяется. Чек-лист «Первые шаги» (бот, канал, сценарий, тест, публикация) доступен и в редакторе — кнопка «Первые шаги (N/5)» в шапке. Шаг «Тест» засчитывается только после успешного тест-прогона в этом браузере.

Черновик, публикация и «Запустить бота»

Это две разные вещи. «Опубликовать» делает рабочим сценарий: пока он «Черновик», бот на него не отвечает и подписчики видят прежнюю версию. «Запустить бота» (группа «Бот» справа в шапке редактора) включает самого бота; остановленный бот не отвечает ни по какому сценарию. Чтобы бот отвечал, нужны оба.

Если сценарий — черновик, под шапкой редактора висит жёлтая плашка «Черновик: бот этот сценарий не использует» с кнопкой «Опубликовать». После успешного тест-прогона то же предложение появляется в окне теста — публиковать можно, не закрывая его. «Опубликовать» недоступна, пока идёт сохранение правок.

Бот за 5 минут без холста

Кнопка «Собрать бота за 5 минут» есть в окне выбора шаблона (оно открывается сразу после подключения токена), на странице бота без сценариев и в окне «Новый сценарий». Мастер задаёт три вопроса: что бот должен делать (собирать заявки, записывать клиентов, отвечать на частые вопросы, выдавать лид-магнит, продавать), как назвать бота и чем поприветствовать, какой контакт и ссылку показывать клиентам. Вместо ссылки можно указать адрес сайта: он подставится в кнопку и сообщения. Для FAQ добавьте до пяти вопросов с ответами.

Мастер показывает пример диалога по вашим ответам, а кнопка «Опубликовать бота» собирает и публикует сценарий одним нажатием. Тариф не нужен: сценарий строится из обычных блоков без ИИ, поэтому потом открывается и правится в редакторе как любой другой. Ответы клиентов попадают в переменные (name, phone, email, when) и на подписчика ставится метка (lead, booking, magnet, buyer). Сразу после публикации мастер показывает «Раздайте бота». Если нужно улучшить тексты с помощью ИИ, в редакторе есть помощник сборки (на платном тарифе). Лимит сценариев по тарифу мастер учитывает так же, как «Новый сценарий».

Если вы больше 20 минут в редакторе без публикации или дважды подряд не получилось опубликовать или пройти тест, внизу появится карточка «Помочь собрать?»: она открывает чат поддержки. Карточка показывается один раз за сессию и закрывается крестиком.

Симулятор диалога и галерея шаблонов

Кнопка «Тест» в редакторе открывает симулятор: сценарий проигрывается как живой чат в рамке телефона (на телефоне открывается на весь экран). Бот пишет с короткими паузами, кнопки и ответы текстом работают, вопросы проверяют телефон, почту и регулярные выражения, ветки и переменные считаются сразу. Долгие паузы («через час», «завтра») ускорены и отмечены серой пометкой. Выполненные узлы подсвечиваются на холсте. Ничего не уходит подписчикам и не пишется в аудиторию. Старый серверный тест-прогон остался по ссылке внутри панели симулятора.

Узлы ИИ-ответа в симуляторе помечены. На платных тарифах агент отвечает по-настоящему (тратит ИИ-бюджет), на бесплатном тарифе показана только пометка. Условия по UTM, времени и подписке симулятор не проверяет: он отмечает это и идёт по ветке «Нет». Успешно пройденный до конца сценарий засчитывается как шаг «Тест» в чек-листе и предлагает опубликовать черновик.

Тот же симулятор показывает диалог в мастере «Бот за 5 минут» и в карточках шаблонов.

Галерея шаблонов открыта без регистрации: страница /templates. Около 30 готовых сценариев под русские ниши: салон и клиника, стоматология, недвижимость, школа, магазин и доставка, фитнес, ресторан, автосервис, юрист, сбор отзывов, розыгрыш, квиз, запись на вебинар. Фильтры по нише и каналу (Telegram, MAX, VK), поиск, а в каждой карточке — «Посмотреть диалог». Кнопка «Использовать шаблон» ведёт на регистрацию, после подключения бота копия сценария появляется в аккаунте. У уже зарегистрированных та же галерея в окне выбора шаблона. Шаблоны не содержат платных узлов и работают на бесплатном тарифе; тексты русские, перевод есть у названий и описаний карточек.

Первый экран: опишите бота словами

Если у вас ещё нет ботов, список ботов начинается с поля «Что должен делать бот». Опишите задачу своими словами или выберите быструю цель (заявки, запись, частые вопросы, лид-магнит, продажи) — диалог сразу показан в симуляторе, токен пока не нужен. Нажмите «Подключить канал и продолжить»: после подключения бота выбранный сценарий создастся в нём и откроется редактор. Выбор хранится в браузере до 7 дней.

Детерминированная сборка по цели работает на любом тарифе. Сборка ИИ по описанию доступна на платных тарифах, пока есть ИИ-бюджет (пробный период на неё не распространяется), не больше 5 запросов в час; в остальных случаях вы увидите причину и диалог, собранный по подобранной цели. Если шаблон выбран на странице /templates, а у вас уже есть боты, над списком появится плашка с выбором бота, к которому применить шаблон.

Первые шаги после публикации

На странице опубликованного бота показан чек-лист: раздать ссылку, набрать первые 10 подписчиков и сделать первую рассылку. Для рассылки не нужен тариф: доступны две пробные рассылки в месяц до 100 получателей каждая, чек-лист показывает остаток. Когда все три шага выполнены, чек-лист исчезает.

Через 3 дня после первой публикации приходит одно сообщение (в привязанный Telegram или MAX и на почту) с цифрами бота: подписчики и сообщения от них, и одним следующим шагом. Если вы пропали на 7 дней и больше, придёт один вопрос «что помешало» со ссылкой на страницу ответа: входить в кабинет не нужно. При отмене оплаты кабинет тоже задаёт один вопрос о причине. Письма можно отключить ссылкой «Не хотите получать такие письма» внизу; в тихие часы (с 22:00 до 9:00 по Москве) они не отправляются.

Раздайте бота

Сразу после публикации сценария Telegram- или MAX-бота редактор показывает окно «Раздайте бота»: прямая ссылка (кнопка «Скопировать»), QR-код и вход в стартовые ссылки. Тот же блок — вверху страницы «Ссылки» бота.

Стартовая ссылка с меткой (раздел «Ссылки» → «Создать стартовую ссылку») нужна, чтобы различать источники: отдельная ссылка для рекламы, поста и рассылки показывает, откуда пришли подписчики.

Шаблоны «Меню» и «FAQ»

В обоих шаблонах после ответа на вопрос остаются кнопки: в «FAQ» это остальные вопросы и «Все вопросы», в «Меню» — «В меню». Если подписчик нажал кнопку, которой нет в схеме, или написал произвольный текст, бот не молчит, а отвечает «Не понял» и снова показывает кнопки меню.

Это сделано отдельным входом «Любой текст» и выходом «По умолчанию» у блока «Ветвление». Без такого входа текст, который не совпал ни с одним триггером, остаётся без ответа (в запусках такой прогон помечен «Не сработал»). Добавьте его и в свои сценарии, если бот должен отвечать на всё.

Токен не принимается

При подключении бота ошибка объясняется по причине и на языке интерфейса. «Telegram/MAX не принял токен» — токен скопирован не целиком, с пробелом или перевыпущен: возьмите актуальный из @BotFather (Telegram, команда /revoke выпускает новый) или из кабинета MAX. «Этот бот уже подключён» — токен занят вашим или чужим аккаунтом: перевыпустите токен и подключите новый.

Для MAX проверяется чужой вебхук: если на токене уже стоит вебхук другого сервиса, сообщения уходят туда, и бот молчал бы. Подключение остановится с подсказкой «Отключите бота в том сервисе или перевыпустите токен». «Не удалось связаться с Telegram/MAX» — временный сбой, повторите через минуту. Если вебхук другого сервиса появился уже после подключения, см. раздел «Токен занят другим сервисом».

Вход по коду из письма: не пришёл код

Вход и регистрация — один экран: введите почту, решите капчу, и мы пришлём шестизначный код. Незнакомая почта заводит аккаунт сама, отдельной регистрации нет. Код действует 15 минут.

Письма нет больше минуты? Загляните в «Спам» и «Промоакции». На шаге ввода кода есть кнопка «Отправить ещё раз»: после отправки она ждёт 60 секунд, и тем же кодом можно воспользоваться трижды. Если лимит исчерпан, нажмите «Запросить новый код» — придётся снова пройти капчу.

Опечатались в адресе или хотите войти иначе? Кнопка «Изменить почту или способ входа» возвращает на первый экран, где рядом с почтой есть вход через Яндекс и VK. Неверный код можно ввести пять раз, потом он сгорает и нужен новый.

Разделы кабинета

«Сценарии» — все ваши схемы и их источники. «Подключения» — боты, каналы, CRM и сервисы. «Подписчики» и «Диалоги» — люди, которые вам написали, и переписка с ними.

«Рассылки» — массовые сообщения. «Страницы» — сайты из блоков и Telegram Mini Apps. «Аналитика» — что происходит в сценариях. «Тариф» — лимиты и оплата. «MCP» — управление ботами из внешних инструментов. «База знаний» — эта справка.

Сценарии и канвас

Сценарий — это визуальная схема поведения. Вы не пишете код: логику задаёте блоками и стрелками между ними.

Холст, блоки и стрелки

Блок — это один шаг: отправить сообщение, задать вопрос, проверить условие. Стрелка ведёт от одного блока к следующему и определяет порядок прохождения.

У блока может быть несколько выходов. Например, «Условие» имеет выходы «да» и «нет», а вопрос в «Сообщении» — «Ответил», «Не ответил» и, если задано время ожидания, «Нет ответа». От каждого выхода тянется своя стрелка в свою ветку.

Черновик и публикация

У бота один основной (активный) сценарий — именно он отвечает людям. Рядом с ним можно держать дополнительные сценарии: их запускают только VK-лендинги и ссылки на бота, у которых этот сценарий выбран целью (см. «Дополнительные сценарии» ниже).

Черновик — рабочая копия сценария: он сохраняется автоматически по мере правок и на бота не влияет. «Опубликовать» копирует черновик в опубликованный сценарий бота. Если такой сценарий у бота уже есть, его содержимое целиком заменяется, поэтому перед публикацией редактор спросит подтверждение. Прежняя активная версия при этом не теряется: если её нет ни в одном черновике (например, вы правили активный сценарий вживую), она сохранится отдельным черновиком «… (была активной до дата время)» — его можно открыть и опубликовать обратно. Сам черновик после публикации остаётся в списке карточкой «Черновик»: его дальнейшие правки в бой не идут, а повторная публикация снова целиком заменит активный сценарий. Открытые у соредакторов редакторы активного сценария перечитают его сразу.

Активный сценарий редактируется вживую: каждая правка сохраняется автоматически и сразу применяется к боту. Перед сохранением она проходит те же проверки, что и публикация. Прежнее состояние попадает в историю версий, откатиться можно кнопкой «История». Правка с ошибкой (например, к сценарию подключён пустой блок «Сообщение») не сохранится: редактор покажет «Изменения не сохранены», подсветит проблемные блоки, а бот продолжит работать на последней корректной версии. Поправьте ошибку — и правка сохранится.

Пропала связь — редактор покажет «не сохранено» и повторит сам через 10 секунд; закрыть вкладку с несохранёнными правками браузер без вопроса не даст, а уйти по ссылке с правкой, которую сервер не принял, редактор не даст без подтверждения. Истекла сессия — откроется вход, после него вы вернётесь в сценарий.

Правка неактивного опубликованного сценария сохраняется, но активным его не делает: какой сценарий у бота активный, переключает «Сделать активным» на странице бота.

Дополнительные сценарии (для лендингов и ссылок)

Дополнительный сценарий опубликован рядом с основным и основной не заменяет: подписчик попадает в него только по VK-лендингу или ссылке на бота с этим сценарием-целью (при создании ссылки в «Ссылках на бота» выберите сценарий; «Скопировать диплинк» на шаге дополнительного сценария сам ведёт в него). Так у одного бота может быть общая воронка и отдельные сценарии под каждый лендинг или рекламную кампанию.

Как опубликовать: откройте черновик и нажмите «Как дополнительный» рядом с «Опубликовать» (или кнопку «Опубликовать как дополнительный» прямо в редакторе VK-лендинга). Проверки те же, что у основного: ошибки блокируют публикацию, сценарий с запуском по расписанию или отправкой в заданный чат токену MCP нужно право «Рассылки и сообщения». Публикуется сам сценарий, без копии: его правки дальше применяются вживую, как у основного. Кнопка есть, только если у бота уже есть основной сценарий; основной сценарий дополнительным сделать нельзя. В дополнительном сценарии не работают триггеры, которые слушает только основной: «По расписанию», «Заявка с сайта», события канала или группы, комментарии и вебхук — с ними публикация не пройдёт. Если сценарий — копия основного, при первой публикации его блоки получают новые внутренние номера, чтобы кнопки и ответы двух сценариев не путались. В режиме «сессия на сценарий» дополнительные сценарии недоступны.

Что видит подписчик: по лендингу или ссылке он начинает с команды /start дополнительного сценария (если её нет — с первого триггера или первого блока; у ссылки на шаг — с этого шага). Ответы на его вопросы, его кнопки, задержки и оплаты продолжаются в нём, даже если основной сценарий другой — как при «Перейти в другой сценарий». Команды и ключевые слова матчатся по основному сценарию, а любой старт — /start, /start с кодом ссылки на основной сценарий, кнопка «Начать» в VK — ведёт в основной: если подписчик в этот момент ждал ответа на вопрос дополнительного сценария, ожидание снимается. Триггер «Оплата прошла» в дополнительном сценарии срабатывает только для подписчика, который сейчас в нём (тогда основной на эту оплату не запускается). Когда дополнительный сценарий доходит до блока «Конец» или подписчик запускает команду или ключевое слово основного сценария, он возвращается в основной. Если сценарий открыт в редакторе у кого-то со старой копией после такой публикации, его правки не сохранятся с подсказкой перезагрузить страницу.

Если цель лендинга или ссылки не опубликована как дополнительный сценарий (черновик), удалена или это сам основной сценарий — подписчик попадает в основной сценарий, как раньше. Редактор лендинга показывает, что именно запустится, а в списке лендингов такой лендинг помечен «цель не опубликована».

В списке сценариев бота такие сценарии помечены «Дополнительный», основной — «Основной». В меню карточки: «Снять с публикации» — сценарий снова черновик, ссылки и лендинги ведут в основной, подписчики, остававшиеся в нём, возвращаются в основной, его задержки отменяются; «Сделать основным» — он становится основным сценарием бота. Публикация основного сценария дополнительные не трогает. Журнал прогонов и аналитика считаются по самому дополнительному сценарию; «Тест» в его редакторе работает как обычно. Дополнительный сценарий занимает место в лимите сценариев тарифа.

Что проверяется перед публикацией

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

Ошибки (красный баннер) блокируют публикацию; предупреждения (жёлтый баннер) — нет, но их стоит прочитать. Частое предупреждение — «нет точки входа»: схема есть, а начать её некому.

Те же проверки проходит каждая правка активного сценария — в том числе платные блоки и лимит блоков вашего тарифа.

История версий и откат

История версий: в редакторе кнопка «История» открывает панель со снимками сценария. Снимок создаётся при каждой публикации, при правке работающего сценария (не чаще раза в 10 минут: сохраняется состояние до правки) и по кнопке «Сохранить версию» (можно добавить подпись). Каждая версия показывает дату, автора, причину (публикация, ручное сохранение, автосохранение, откат) и число блоков.

Что можно сделать с версией: открыть её отличия от текущего сценария (сколько блоков добавлено, удалено, изменено и отличаются ли связи), нажать «Просмотр» — версия откроется на холсте только для чтения, ничего не меняя, — или «Восстановить». Откат равносилен публикации выбранной версии: у работающего сценария он применяется к боту сразу и проходит те же проверки, что и обычная правка (если проверка не пройдена, бот остаётся на текущей версии и редактор покажет причину). Текущее состояние перед откатом само сохраняется отдельной версией, так что откат можно отменить тем же способом. Откат доступен владельцу и редакторам, наблюдатель только смотрит; перед ним дождитесь сохранения правок.

Сколько хранится: последние 50 версий каждого сценария и все публикации и откаты за последние 90 дней; ещё у сценария есть общий потолок по объёму снимков, и в первую очередь освобождается место от самых старых автосохранений. Версии удаляются вместе со сценарием. История привязана к опубликованному (работающему) сценарию: черновик, из которого вы публиковали, свою историю не ведёт. Для надёжной копии перед крупной переделкой по-прежнему есть «Экспорт». Агенты через retensy-mcp видят те же версии инструментами graph_versions_list и graph_version_rollback.

Какие бывают блоки

Блоки сгруппированы по назначению. Ниже — что делает каждая группа.

Сообщения

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

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

«Случайный текст» — блок выдаёт подписчику один случайный текст из вашего списка целиком (например, случайную историю, цитату или совет дня). Тексты вводятся в настройках блока по одному, либо вставляются пачкой (разделитель — строка из трёх дефисов ---), либо загружаются из файлов .txt (несколько файлов сразу). В списке до 500 текстов, каждый до 65 536 символов, все вместе до 1 500 000 символов (сценарий целиком не больше 4 МБ). Два режима: «Отправить сообщением» — текст уходит подписчику (если он длиннее лимита канала, Telegram 4096 знаков, MAX 4000, он автоматически делится на несколько сообщений по границам абзацев; галочка «Делить длинный текст» отключает деление, тогда лишнее обрезается) или «Сохранить в переменную» — текст кладётся в переменную, и дальше его можно вставить в любое сообщение как {{var.имя}} (в переменную помещается до 65 536 знаков). Галочка «Не повторять, пока не выданы все тексты» запоминает у каждого подписчика, что он уже получил, и выдаёт каждый текст по разу, пока список не кончится, затем круг начинается заново (новый круг не начинается с текста, которым закончился прошлый). В текстах работают подстановки {{from.first_name}} и {{var.имя}}. Выходы: «Дальше» и «Ошибка» (пустой список, не получилось отправить, переменная не сохранилась). В режиме «Тест» блок работает как обычно. Чтобы выдать длинный текст целиком, используйте именно этот блок, а не базу знаний агента.

Логика и ветвления

«Условие» — развилка «да / нет» по одному или нескольким условиям: метка, поле или переменная, имя, email, телефон, username, UTM-метка, подписка на канал, клик по ссылке из шага, текущая дата, время, день недели, канал «Telegram Business» (сообщение пришло через бизнес-аккаунт или из обычного чата с ботом). «Рандомайзер» — случайно делит подписчиков между ветками для A/B-теста. «Формула» — вычисление над переменными (например посчитать сумму).

«Развилка по значению» — когда веток больше двух: указываете, что сравнивать (обычно переменную), и перечисляете значения. Каждое значение — свой выход, всё остальное уходит в выход «Иначе». Сравнение без учёта регистра и пробелов по краям. Оба вида развилки добавляются одной кнопкой «Условие»: клик открывает выбор — «да / нет» или по значению.

«ИИ-развилка» — ветвление по смыслу сообщения для всех ботов. Это режим блока «ИИ-разбор» («ИИ-развилка по правилам»): в поле правил вы простым языком описываете, когда куда идти, и помечаете ветки метками с решёткой, например «Если клиент согласен купить - #да. Если спрашивает цену - #цена. Если отказывается - #нет». Каждая метка (буквы, цифры и _, до 10 штук, без повторов) сразу появляется выходом блока на холсте, плюс выход «Иначе». ИИ видит последнее сообщение клиента, короткую историю чата и переменные сценария и выбирает одну метку; выбранная метка сохраняется в переменную ai_route (или в вашу), а короткая причина в ai_route_reason. Если ИИ не ответил за 8 секунд (время можно изменить от 1 до 30), вернул ошибку, не выбрал известную метку или кончились ИИ-токены тарифа, сценарий идёт по выходу «Иначе» и не ломается. Каждый вызов тратит ИИ-токены тарифа (вид расхода «разбор»). В режиме «Тест» модель не вызывается — путь идёт по «Иначе». Все метки должны быть соединены со следующим шагом, иначе сценарий не опубликуется.

«Действия» — список шагов, которые в основном ничего не пишут в чат: теги и переменные подписчика, строка в Google Таблицы, сделка в CRM, внешний запрос, счёт на оплату. Клик по «Действие» открывает список всех действий, сгруппированный по темам: выбранное сразу ложится в новый блок первым, остальные добавляются кнопкой внутри блока. «Отправить уведомление» пишет вам в бот уведомлений, подключённый в профиле (Telegram или MAX); если он не подключён, блок уйдёт в выход «Ошибка».

«Остановить с ошибкой» — служебный блок: обрывает прогон и помечает его ошибочным с вашим текстом, чтобы неудачная ветка не выглядела в журнале успешной. В палитре его нет — он приходит в сценариях, собранных через MCP или импорт, и работает там как обычно.

Живой Telegram-бот — три действия блока «Действия» (только Telegram). «Показать «печатает…»» — в шапке чата появляется статус «печатает…», «записывает голосовое…» или «отправляет фото…»; он держится около 5 секунд или до следующего сообщения, поэтому ставьте его перед «Задержкой» на 2–4 секунды. «Поставить реакцию» — бот ставит эмодзи-реакцию (👍, ❤, 🔥, 🎉 и другие стандартные) на последнее сообщение подписчика или на сообщение с указанным id: живой отклик на ответ в анкете или квизе. «Бросить кубик» — анимированный кубик, дартс, мяч, боулинг или слот; выпавшее число (кубик, дартс, боулинг — 1–6, мяч — 1–5, слот — 1–64) сохраняется в переменную, дальше «Условие» решает, выиграл ли подписчик скидку. Если Telegram не принял действие (реакции в чате выключены), блок уходит в выход «Ошибка».

Блок «Опрос / квиз» (только Telegram) — нативный опрос Telegram: вопрос и от 1 до 12 вариантов. У каждого варианта на холсте свой выход, «Дальше» — любой ответ без своей ветки. Сценарий ждёт голос подписчика, его текстовые сообщения ожидание не снимают. Режим «Квиз» — один верный ответ (Telegram подсветит его и покажет пояснение), можно разрешить несколько ответов в обычном опросе (ветка по первому). Ответ сохраняется в переменную: текст варианта, {имя}_index — номер варианта с 0, у квиза {имя}_correct — 1 или 0. Опрос неанонимный: бот видит, кто как ответил.

Ещё про кнопки Telegram: тип «Неактивная» — плашка без действия («Мест нет», «Скоро»); в поповере цвета кнопки можно указать id кастомного эмодзи — он встанет иконкой слева от текста. У блока «Вопрос» с текстовым ответом галочка «Сразу открыть поле ответа» открывает у подписчика поле ответа на сообщение бота (удобно в группах), с подсказкой в поле ввода.

ИИ-ответ в простом режиме с отправкой подписчику может «печататься» по мере генерации — галочка «Печатать ответ по мере генерации» (Telegram, личный чат): подписчик видит текст, пока модель пишет, итог приходит обычным сообщением. У ИИ-агента ответ проверяется целиком до отправки, поэтому там стриминга нет.

Кнопка «Копировать» в сообщении (тип кнопки рядом с «Переход», «Ссылка» и «Mini App», только Telegram): по нажатию Telegram копирует заданный текст в буфер — промокод, реквизиты, адрес. Текст до 256 символов, подстановки {{var.…}} работают, перехода дальше по такой кнопке нет.

«Удалить сообщение» — убирает сообщение у подписчика. Что удалить: предыдущее сообщение бота; последнее сообщение выбранного блока (например, блока со ссылкой-приглашением, которую нужно убрать после того, как человека исключили из канала); последнее сообщение подписчика (только Telegram, в личке); сообщение, которое отправит следующий блок. Можно удалить сразу или через паузу меньше 24 часов, сценарий при этом не останавливается. Режим «сообщение следующего блока» работает, только если следующий блок отправляет сообщение сразу (без «Задержки» между ними); если блок «Действия» отправил несколько сообщений, удаляется последнее; удаление сообщения подписчика работает только в личке Telegram. Ограничения платформ: Telegram даёт удалить сообщение бота в течение 48 часов, VK в течение 24, в MAX удаляются сообщения бота. Если удалить нельзя (прошло слишком много времени, сообщение уже удалено), сценарий идёт дальше, а шаг в журнале помечается ошибкой и попадает в аналитику.

«Выгнать или забанить в канале/группе» — действие блока «Действия» (раздел «Группы»). Режим «Выгнать»: человек уходит из канала или группы, но не заблокирован — если у него есть ссылка-приглашение, он сможет вернуться (в Telegram бот банит и сразу разбанивает). Режим «Забанить»: вернуться по ссылке нельзя, срок бана в днях можно задать (от 1 до 366), без срока бан бессрочный. Канал или группу выбирают из подключённых к боту, либо вводят ID, @username или переменную; пользователь — текущий подписчик. Бот должен быть администратором с правом блокировать участников. Если прав нет или человека нет в чате, блок уходит в выход «Ошибка» (появляется на карточке сам), а сценарий не падает. Платформы: Telegram — все режимы; MAX — «Выгнать» и бан навсегда, бан на срок недоступен; VK — только «Выгнать» из беседы сообщества (бот — админ беседы, указывается номер беседы), бан в VK недоступен: в конструкторе появится предупреждение. В пробном прогоне ничего реально не вызывается. Хорошо сочетается с «Удалить сообщение»: выгнали — и сразу убрали сообщение со ссылкой-приглашением.

«Перейти в другой сценарий» — действие блока «Действия» с двумя режимами (выбираются в настройках). «Перейти» — подписчик уходит в выбранный сценарий этого же бота и продолжает там, а текущий сценарий на этом заканчивается. Удобно, чтобы не держать всю воронку на одном холсте: меню, оплата, анкета — отдельными сценариями. «Вызвать и вернуться» — то же самое, но когда вызванный сценарий дойдёт до конца, подписчик автоматически возвращается сюда и продолжает со следующего шага после этого блока; это работает, даже если между вызовом и возвратом сервер перезапустился — состояние хранится у подписчика, а не только в оперативной памяти. Удобно для переиспользуемых кусков вроде «спросить адрес» или «проверить подписку», к которым обращаются из разных мест. Ответы на вопросы и нажатия кнопок вызванного сценария обрабатывает он сам, даже если активный сценарий бота другой. Старт — с команды /start выбранного сценария, если её нет — с первого триггера, а у сценария без триггеров (подсценария) — с первого блока без входящих связей. В настройках можно передать переменные: они сохраняются подписчику до перехода, значения поддерживают подстановки {{var.…}}. Действие ставится последним в блоке — после перехода (или вызова) остальные не выполнятся. Защита от зацикливания общая для обоих режимов: в одной цепочке переходов/вызовов сценарий не может повториться, и суммарно их не больше 5 подряд — иначе шаг завершается ошибкой и блок уходит в ветку «Ошибка». Переход возможен только в сценарии своего бота; вебхук-сценарии, где бот лишь отвечает, и сценарии других ботов выбрать нельзя. Целевой сценарий может быть черновиком — тогда его правки сразу видят подписчики, которые в него уже перешли или вызвали его. Кнопки и вопросы вызванного сценария продолжают работать и позже. Служебные переменные (имя начинается с «_») передать нельзя.

Ожидание и ввод

Вопрос — карточка «Вопрос» в блоке «Сообщение»: бот спрашивает и сохраняет ответ в переменную. Выходы: «Ответил»; «Не ответил» — ответ не прошёл проверку за отведённые попытки; «Нет ответа» — появляется, если задано время ожидания, и срабатывает, когда человек так и не ответил.

«Задержка» — пауза перед следующим шагом. «Расписание» — запуск ветки в заданное время. Если у многих подписчиков пауза заканчивается в одно время (например, «завтра в 12:00»), сообщения уходят не разом, а постепенно — примерно по 10 в секунду на бота (1000 подписчиков — около 2 минут, 10 000 — около 17 минут), так бот не упирается в лимиты Telegram. Если Telegram всё же попросил бота подождать, срабатывания задержек ждут конца этой паузы. Ответ подписчику, который пишет боту прямо сейчас, отправляется сразу, без ожидания; если Telegram откажет и ему, шаг уходит в ветку «Ошибка», если она проведена, иначе сценарий идёт дальше по обычному выходу.

Внешние сервисы

«Внешний запрос» — HTTP-запрос к вашему API или CRM: отправить данные или получить ответ и разложить его по переменным. Живёт он действием внутри блока «Действия» — отдельного блока для него нет, чтобы одна и та же возможность не была в двух местах; в палитре ищите его в списке действий под кнопкой «Действие».

Код ответа и тело целиком можно сохранить в переменные и дальше ветвиться по ним «Развилкой по значению»; отдельные поля достаются по пути JSONPath. При сетевой ошибке и таймауте код будет 0, а тело пустым. Таймаут настраивается от 0,5 до 30 секунд.

Если запрос не удался (чужой сервис лёг, таймаут, код 400 и выше), блок «Действия» уходит в свой выход «Ошибка» — он появляется на карточке сам, как только в блоке есть действие, которое ходит наружу. Не нарисовали ветку «Ошибка» — сценарий просто идёт дальше по обычному выходу.

Внешний запрос доступен на платных тарифах.

«Отправить письмо» — ещё одно действие внутри блока «Действия»: шлёт письмо на один адрес (шаблон {{var.*}} в поле «Кому» — например {{var.email}}), с темой, текстом и необязательным Reply-To. Текст — только обычный текст: HTML-теги не поддерживаются и уйдут в письме как есть, без разметки. Массовой рассылкой это действие не станет — адрес один, и в сутки с одного аккаунта (и в целом по сервису) уходит ограниченное число писем; при превышении лимита, неверном адресе или сбое почтового сервера блок «Действия» уходит в выход «Ошибка», как и любое внешнее действие.

«AI-агент» — блок с ответом языковой модели, два режима (переключаются в настройках блока). «Простой» — модель отвечает по вашему промпту, ответ можно отправить подписчику и/или сохранить в переменную. «Агент» — модель ищет ответ по подключённой базе знаний, умеет уходить в отдельные ветки-действия и помнит историю разговора на этом блоке. Оба режима доступны на платных тарифах и расходуют общий месячный бюджет ИИ — подробнее в разделе «Тарифы и оплата». Если модель не отвечает (сбой у провайдера), блок уходит в выход «Ошибка» примерно через минуту.

Агента можно проверить в разделе «ИИ-агенты» → «Тестирование».

«Прямой ответ на точное совпадение» — отдельная галочка в настройках блока, по умолчанию ВЫКЛЮЧЕНА. Включив её, вы получаете бесплатный ответ без обращения к модели: срабатывает, только если вопрос подписчика почти дословно совпал с одной из ваших пар вопрос-ответ в базе знаний. На произвольный вопрос так агент не ответит — для этого и нужна модель. Прямой ответ, как и обычный, не сработает, если месячный бюджет ИИ уже исчерпан (бюджет проверяется раньше поиска по базе).

Без найденных в базе фрагментов (нет базы вовсе или релевантность ниже порога) агент в ЛЮБОМ режиме уходит в ветку «не знаю» — до модели дело не доходит. Исключение — блок с «Действиями»: просьбу вроде «запишите меня на завтра» в базе не найти, поэтому такой блок и без фрагментов спросит модель, чтобы та могла выбрать действие; ответить от себя без фрагментов она не сможет ни в каком режиме — уйдёт в «не знаю». «Строгий режим» (включён по умолчанию) решает, что происходит, когда фрагменты УЖЕ нашлись: агент отвечает только по ним, не выдумывая. Без строгого режима агент может дополнить найденное общими знаниями модели, но не про цены, сроки и обещания — их он всегда берёт только из базы и вашей инструкции. Строгий режим без выбранной базы знаний публиковаться не даст; сняв галочку, сценарий опубликуется, но агент без базы всё равно ничего не найдёт и будет неизменно отвечать «не знаю» — «нестрогий» не означает «работает без базы».

«Действия» агента — ветки, между которыми модель выбирает сама по смыслу разговора (например «Оформить заказ» или «Позвать менеджера»): дайте каждому название (без него действие никак не появится на холсте) и, если нужно, условие «когда применять», и протяните от блока свою стрелку для каждого — публикация не пройдёт, пока у действия нет своей стрелки: иначе модель могла бы выбрать его, а идти было бы некуда. Ветку «не знаю» стрелкой лучше тоже не оставлять пустой — публикацию она не блокирует, но не подключенная, оставит диалог в тупике там, где нужен человек.

«Извлекать из разговора» — переменные, которые агент сам заполняет, если клиент их упомянул (например телефон или город); это слова клиента, а не проверенный факт. При уходе в действие агент готовит и краткую сводку разговора для менеджера — она доступна как {{var.ai_summary}} без отдельной настройки, тоже словами клиента, не проверенными данными.

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

Инструкция агента (system prompt) — до 10 000 символов: длиннее модель хуже держит середину, и каждый ответ дороже. Жёсткий потолок — 30 000 символов, длиннее сценарий не опубликуется. В отличие от промпта простого режима, подстановки вида {{var.x}} в инструкции агента не работают — текст уходит модели как есть. Так же, без подстановок, уходит и текст на случай исчерпания бюджета (ниже) — в обоих режимах.

Исчерпание бюджета ИИ у агента — не «идёт дальше как обычно»: у этого блока нет обычного выхода, поэтому он уходит в свою ветку «Бюджет ИИ исчерпан» (если вы её подключили) либо в ветку «Ошибка». Запасной текст на этот случай задаётся прямо в настройках блока — для обоих режимов.

База знаний агента собирается из файлов, сайтов и пар вопрос-ответ — подробнее в подразделе «База знаний» ниже.

«Выставить счёт» — приём оплаты на вашу кассу ЮKassa (для Telegram-ботов есть и «Выставить счёт в звёздах», см. раздел «Оплата звёздами Telegram»). Это тоже действие внутри блока «Действия», в группе «Оплата», отдельного блока для него нет. Если протянуть от блока ветку «Оплачено», сценарий дождётся платежа и продолжится только после него; появится и ветка «Не оплатили вовремя». Не протянули — бот просто пришлёт счёт и пойдёт дальше. Счёт ставьте последним действием в блоке: после него блок ждёт оплату, и следующие действия не выполнятся. Подробнее — в разделе «Подключения».

База знаний

В режиме агента блок выбирает готового агента, а не базу прямо тут: ссылка «Открыть агента» ведёт на его страницу, где база наполняется тремя способами — загрузкой файла (PDF, DOC, DOCX, TXT, MD, HTML, CSV, XLSX, XLS — до 20 МБ), парами вопрос-ответ и обходом сайта. Блок, собранный до перехода на агентов, может хранить прежнюю базу или инструкцию прямо в своих настройках — тогда вместо выбора агента в нём виден прежний список и ссылка «Открыть базу»: она ведёт на страницу агента-владельца или, если его не нашли, на прежний адрес /bots/knowledge, который сам перенаправит, куда нужно.

Как агент видит документы. Текст документа режется на фрагменты по 800 знаков с небольшим перекрытием (разделы с заголовками стараются не смешиваться), и агент отвечает по тем фрагментам, которые нашёл по вопросу подписчика, — не по документу целиком. Короткий документ (до 2500 знаков текста) хранится одним фрагментом и виден агенту целиком; таблицы режутся построчно, а пара вопрос-ответ — это один фрагмент. Ранее загруженные документы остаются в прежней нарезке, пока вы не загрузите их заново. Агент не пересказывает и не отдаёт документ целиком: если нужно выдать подписчику готовый текст дословно (историю, письмо, инструкцию, случайный текст из набора), используйте блок «Случайный текст» в сценарии, а не базу знаний.

Файл должен содержать настоящий текст: скан страницы без текстового слоя (просто картинка) агент не прочитает — распознавания изображений здесь нет. Таблицы (CSV/XLSX) режутся построчно, и им нужна строка заголовков — без неё поиск по таблице выйдет хуже, редактор предупредит об этом отдельной строкой у документа.

Источник «Сайт» обходит только страницы указанного домена — на чужие сайты обход не уходит. Соблюдаются запреты robots.txt (агент представляется как RetensyBot); число страниц одного сайта, которое обходится за раз, задаёт тариф. Можно задать расписание повторного обхода — «Не обновлять», «Каждый день» или «Раз в неделю» — либо запустить его вручную кнопкой «Пересканировать»; повторный обход переиндексирует только изменившиеся страницы, не всё заново.

Загрузка и обход отвечают сразу: документ появляется в статусе «В очереди», затем «Обрабатывается», пока идёт разбор и эмбеддинги — это может занять минуту-другую, статус в списке обновляется сам и заканчивается «Готово» или «Ошибка». Одновременно индексируется не больше нескольких документов и обходится не больше нескольких сайтов на владельца — при превышении редактор попросит подождать окончания текущей загрузки/обхода. Ещё один обход того же сайта, пока предыдущий не завершился, тоже придётся подождать.

Пары вопрос-ответ добавляются пачкой прямо в редакторе — до 200 пар за раз, вопрос не длиннее 500 символов, ответ — не длиннее 4000.

Число фрагментов базы ограничено тарифом — лимит общий на ВСЕ ваши базы знаний, а не на каждую отдельно: несколько баз не в обход лимита. Для пар вопрос-ответ превышение редактор покажет сразу, при добавлении пачки. Для файла и обхода сайта точное число фрагментов известно только после разбора — лимит проверяется в фоне, и при превышении документ закончится статусом «Ошибка». В карточке (и в сообщении при загрузке на странице «База знаний») будет сказано, что произошло, сколько текста вы пытались добавить и сколько места свободно из лимита тарифа, и что делать: удалить ненужные источники или повысить тариф.

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

Проверка ИИ-клиентами

Автоматическая проверка агента и сценария: ИИ играет клиента с заданной персоной и целью, ведёт диалог, а ИИ-судья оценивает его по вашим критериям. Вкладка «Проверка» есть у агента и в редакторе сценария (кнопка «Проверка» рядом с «Тест»). Тестовые диалоги не попадают в аналитику агента и в статистику бота.

Тест-кейс — это персона клиента (кто он и как пишет), цель (чего хочет добиться) и критерии успеха своими словами, например «назвал цену из базы» или «не обещал сроков». У сценария можно добавить точные ожидания: значения переменных, метки и узел, до которого должен дойти диалог — они проверяются без ИИ. Реплик клиента в кейсе от 1 до 6, кейсов на цель до 30, в один прогон идут до 10.

Кнопка «Создать кейсы с ИИ» придумывает до 10 кейсов по базе знаний, инструкциям агента, частым вопросам без ответа или по сообщениям сценария. Кейсы можно править и удалять.

Как идёт прогон. Агента проверяет сервер: ИИ-клиент пишет агенту через ту же песочницу, что и «Тестирование» (инструменты записи в ней работают только в режиме песочницы, ничего не уходит в CRM и таблицы по-настоящему). Сценарий проходит браузер движком симулятора, ИИ-узлы сценария в проверке не отвечают — агента проверяйте на его вкладке. В конце судья выносит вердикт по каждому кейсу: пройден или нет, причина и дословная цитата из диалога. Диалог можно открыть в рамке симулятора.

Расход. Каждый запуск, создание кейсов и черновики ответов тратят ИИ-бюджет тарифа (вид расхода «тест», в цену ответа он не входит) и всегда спрашивают подтверждение с оценкой числа вызовов. Пробные ИИ-ответы без подписки не используются: без бюджета тарифа проверка недоступна. Лимиты: до 120 вызовов ИИ на прогон и до 30 прогонов в сутки; если бюджет или лимит кончились посреди прогона, он останавливается и сохраняет уже проверенное.

История и регрессии. Прогоны хранятся 180 дней; для каждого кейса видно вердикт прошлого прогона, а кейс, который раньше проходил и перестал, помечен как регрессия. Галочка «Запускать проверку перед публикацией» предлагает прогнать кейсы при публикации агента или сценария; если есть проваленные, вы получите предупреждение, но публикация не блокируется.

Инсайты. У агента под результатами есть блок «Инсайты»: из вопросов клиентов, на которые агент не ответил, и из проваленных кейсов ИИ готовит черновики пар вопрос-ответ. Места, где ИИ не знает факта, помечены [в скобках] — впишите данные и нажмите «Добавить в базу знаний»; без вашего нажатия в базу ничего не попадает. В MCP: agent_tests_run запускает проверку агента, agent_tests_list показывает кейсы и историю прогонов.

Инструменты агента (живые данные)

Кроме базы знаний агент может во время разговора заглянуть в живые данные — инструменты чтения ничего не меняют. Настраивается в кабинете агента, вкладка «Инструменты»: до 10 инструментов, каждый — своего типа. Инструменты, которые что-то записывают, описаны в следующем разделе.

amoCRM — поиск контакта по телефону/почте и статус сделки по её номеру (с человекочитаемым названием воронки и статуса, не просто номером), через уже подключённую интеграцию amoCRM. Google Таблицы — поиск строки по значению в колонке подключённой таблицы, возвращает указанные колонки. Свой HTTP-запрос — GET по шаблону адреса с именованными параметрами ({variable}), с извлечением нужного значения из JSON-ответа.

Адрес свой HTTP-запрос проверяется на внутренние/служебные адреса (localhost, локальная сеть, метаданные облака) — такие адреса инструмент не примет. Ответ ограничен по размеру и времени ожидания.

У каждого сохранённого инструмента в настройках есть кнопка «Проверить» — вызывает именно его, с параметрами, которые вы впишете, без похода к модели: удобно проверить само подключение/таблицу/адрес, не дожидаясь, когда агент решит позвать инструмент сам.

В тест-чате агента виден журнал вызовов: какой инструмент дёрнут и что вернул (или какая ошибка). Стоимость вызова инструмента входит в бюджет ИИ — так же, как обычный ответ агента.

Инструменты записи: сделки, таблицы, свой API, поля и теги

Агент может не только читать, но и записывать: создать сделку в amoCRM, обновить сделку или контакт, добавить строку в Google Таблицу, отправить POST на ваш API, сохранить поле или тег подписчика, передать диалог оператору. Каждый такой инструмент владелец включает отдельно и явно в «Инструменты» (группа «Запись»). Пока инструмент не добавлен, агент ничего не записывает.

Для каждого инструмента записи вы задаёте описание («когда использовать») и JSON-схему аргументов: какие данные агент обязан собрать у клиента (имя, телефон и т.д.), их типы, enum, pattern, длины, границы. Агент не вызовет инструмент с лишними аргументами или с данными, не подходящими под схему. Аргументы подставляются в ваши шаблоны как {имя_аргумента}: название сделки, ячейки строки, тело запроса; в Таблицу значения вида =... записываются как текст, в JSON-тело подставляются как значения, а не как кусок разметки.

Подтверждение у пользователя: для записей во внешние системы включено по умолчанию. Агент сначала описывает, что собирается сделать, и спрашивает согласие; выполняется только после ответа клиента «да» в следующем сообщении. Подтверждение действует 10 минут. Для полей, тегов и передачи оператору подтверждение по умолчанию выключено, включить можно галочкой.

Лимиты и повторы: на каждый инструмент задаются лимит вызовов на диалог (по умолчанию 3, максимум 20) и в сутки (по умолчанию 100, максимум 1000). Одинаковый вызов (тот же диалог, инструмент и данные) в течение суток второй раз не выполняется, чтобы не получить дубль сделки. Запись не начинается, если у владельца кончился бюджет ИИ.

amoCRM берёт ваше подключение из раздела «Подключения» (ошибки и повторная авторизация видны там же, а вызовы попадают в журнал интеграций). POST на свой API проходит ту же защиту, что и «Свой HTTP-запрос»: адреса из внутренней сети и метаданных облака, а также редиректы отклоняются; заголовки (например Authorization) хранятся в настройках агента и не попадают в журнал.

Проверка в песочнице: у сохранённого инструмента записи кнопка «Проверить» по умолчанию работает в режиме песочницы: проверяет аргументы и показывает, что было бы отправлено, но ничего не отправляет. Отправить по-настоящему можно галочкой «Отправить по-настоящему». Тест-чат агента тоже ничего не пишет вовне и показывает вызовы в журнале хода.

Журнал: под списком инструментов виден журнал вызовов: когда, какой инструмент, кто инициатор (агент, тест владельца, песочница), статус (выполнено, ошибка, ждёт подтверждения, отклонено лимитом), аргументы и результат. Ключи с названиями вроде token, password, secret, key в аргументах скрываются, длинные значения обрезаются; журнал хранится 90 дней.

Ограничения: в публичном чате на сайте (виджет и публичный API агента) инструменты записи не работают, там собеседник анонимный. Поле, тег и передача оператору действуют только в диалоге бота с подписчиком. Выбор модели не настраивается: модель одна для всех агентов. Через MCP инструменты настраиваются так же: agent_update с полем tools, проверка через agent_tool_test (live:true отправляет по-настоящему), журнал вызовов в agent_tool_calls.

Ограничения выполнения

Чтобы сценарий не зациклился и не завис, один проход ограничен по числу шагов, по количеству отправленных сообщений и по времени: проход без пауз длится не дольше 5 минут — дольше он обрывается и помечается в журнале ошибкой. Если упёрлись в лимит, обычно в схеме есть петля без паузы. Длинные цепочки внешних запросов и ответов ИИ разносите «Задержкой»: после паузы начинается новый проход.

Цикл в схеме разрешён, если в нём есть шаг, который ждёт человека или время: вопрос, «Задержка», «Расписание» — или переход по кнопке (сценарий стоит, пока её не нажмут). Мгновенная петля без ожидания считается ошибкой и подсветится при проверке.

Сценарий хранится целиком и не может быть больше 4 МБ — это тысячи блоков, обычному сценарию лимит не мешает. Правку, после которой сценарий стал бы больше, сервер не сохранит — и в черновике тоже: редактор покажет «Изменения не сохранены» с подсказкой сократить тексты или разделить сценарий на несколько.

Значение одной переменной подписчика — до 65 536 символов: текст длиннее обрезается (так же, как тело ответа внешнего запроса), а список или объект длиннее (например, извлечённый из JSON-ответа) не сохраняется. Все переменные одного подписчика вместе с их именами — до 262 144 символов: запись сверх этого не сохраняется, переменная остаётся прежней. Большие ответы сервисов не складывайте в переменную целиком — вытаскивайте нужные поля.

Тест сценария

Кнопка «Тест» в редакторе прогоняет сценарий от выбранной команды, текста или нажатия кнопки и показывает путь: какие шаги прошли и что бот отправил бы. Сообщения никому не уходят.

Тест ничего не делает снаружи: внешние запросы, CRM, Google Таблицы, GetCourse, Метрика, письма подписчикам, уведомления вам, счета на оплату и ответы ИИ в нём пропускаются — у таких шагов пометка «в тесте не выполняется», и блок идёт дальше обычным выходом. Метки, переменные, условия, формулы и развилки считаются как в жизни.

Агента можно проверить в разделе «ИИ-агенты» → «Тестирование».

Поэтому переменные, которые заполняет ответ внешнего сервиса или ИИ, в тесте остаются пустыми, и развилки по ним уходят в «Иначе». Ответ ИИ, счёт и запись в CRM проверяйте в настоящем чате с ботом.

ИИ-агенты

ИИ-агент отвечает клиентам в боте или в чате на сайте по вашим документам, сайту и ответам на вопросы. У каждого агента своя база знаний, своё поведение и своя статистика — всё в разделе «ИИ-агенты».

Что такое ИИ-агент

Агент — это ассистент с собственной базой знаний: он ищет ответ в ваших материалах и формулирует его словами, а не выдумывает. У одного агента одна база; если нужны разные знания для разных задач (поддержка, продажи), заведите несколько агентов.

Клиентам агент отвечает через сценарий: в блоке «AI-агент» выбирается агент, и с этого момента в блоке не нужно писать указания или настраивать базу — всё берётся из агента. Один и тот же агент можно подключить к нескольким ботам и сценариям; поменяли знания или поведение агента — изменения сразу действуют везде.

Создание агента

Каждый шаг мастера сохраняется сразу: закрыли вкладку — агент останется черновиком, а на его странице появится «Настройка не завершена — продолжить».

  1. «ИИ-агенты» → «+ Создать ИИ-агента», придумайте название.
  2. Добавьте знания: файлы, сайт, вопросы-ответы или текст. Можно и позже, но без знаний агент будет отвечать «не знаю».
  3. Настройте поведение: язык, тон, длину ответа и что делать, если ответа нет.
  4. Проверьте агента в тестовом чате.
  5. Опубликуйте агента и подключите его к боту.

Обзор агента

Страница агента открывается на вкладке «Обзор»: статус («Активен», «Требует внимания», «Черновик» или «Ошибка»), дата публикации и, если агент подключён к сценарию, — к какому; если ни к одному — кнопка «Подключить».

Ниже — здоровье базы знаний: «База знаний готова» либо список проблем, и у каждой сразу кнопка, чтобы её исправить. Те же проблемы видны и в самой базе знаний — здесь просто собраны в одном месте.

Показатели за последние 30 дней: диалоги, вопросы, доля с ответом, вопросы без ответа, переданные оператору. Пока агенту не задали ни одного настоящего вопроса, вместо нулей показывается пояснение, что данных пока нет.

Справа — быстрые действия: добавить источник, открыть тестовый чат, запустить «Проверку знаний», перейти к вопросам без ответа, открыть настройки или аналитику, а если в базе есть сайт — обновить его прямо отсюда. Под ними — те же рекомендации «Что стоит улучшить», что и в аналитике.

Источники знаний

Файлы: PDF, DOC, DOCX, TXT, MD, HTML, CSV, XLSX, XLS — до 20 МБ каждый. Можно перетащить сразу несколько: одновременно обрабатываются три файла, остальные ждут очереди и запускаются сами.

Документ режется на куски (около 800 знаков), и агент отвечает по тем кускам, которые нашёл по вопросу, а не читает файл целиком; короткий документ (до 2500 знаков) хранится одним куском. Ранее загруженные документы остаются в прежней нарезке, пока вы не загрузите их заново. Чтобы выдать подписчику готовый текст дословно, используйте в сценарии блок «Случайный текст», а не базу знаний.

Таблицы (CSV, XLSX, XLS) агент читает построчно, и ему нужна строка с названиями колонок. Нет её — у источника появится «Требует внимания» и кнопка «Исправить структуру»: укажите строку заголовков или впишите названия колонок.

Ещё три вида источников: сайт (ниже), пары вопрос-ответ и просто текст. На точный вопрос из пары вопрос-ответ агент отвечает готовым ответом — бесплатно и без обращения к ИИ.

Тот же самый файл повторно агент не примет молча: предложит заменить прежний источник или добавить файл новой версией. Скан без текстового слоя (картинка) агент не прочитает — распознавания изображений нет.

Статусы источников и как их исправить

У каждого источника есть статус: «В очереди», «Анализируем документ…», «Готово», «Требует внимания» или «Ошибка». Статусы обновляются сами, перезагружать страницу не нужно. Сверху вкладки «База знаний» — сводка проблем базы.

Для каждой проблемы агент пишет, что произошло, почему и как исправить, и даёт кнопку действия. Частые случаи: скан без текста — замените файл на PDF с распознанным текстом или DOCX; закончился бюджет ИИ — пополните баланс и нажмите «Повторить»; не хватило места в базе — удалите ненужные источники или повысьте тариф; сайт закрыл обход в robots.txt — разрешите доступ для RetensyBot или добавьте страницы файлами; источник обрабатывается дольше часа — нажмите «Повторить».

Сайт и расписание обновления

Агент обходит только страницы указанного сайта и соблюдает запреты robots.txt; сколько страниц обходится за раз, задаёт тариф. Повторный обход обрабатывает заново только изменившиеся страницы.

Расписание: «Не обновлять», «Каждый день», «Раз в неделю» или «Раз в месяц»; обновить вручную — кнопка «Обновить сейчас». В карточке сайта видно, когда был последний обход и когда будет следующий, какие страницы не открылись и почему, а на вкладке «История» — что менялось.

Тестовый чат

«Тестирование» → «Чат»: задайте вопрос так, как спросил бы клиент, и увидите ровно тот ответ, который он получил бы. Чат работает и для черновика — проверить агента можно до публикации.

Тестовые ответы тратят бюджет ИИ так же, как настоящие, но в аналитику агента не попадают. Справа — «Почему агент ответил так?»: из каких источников взят ответ и насколько они совпали с вопросом. В тесте используются стандартные настройки поиска — в блоке сценария их можно изменить в «Для специалистов».

Проверка знаний

«Тестирование» → «Проверка знаний» показывает, находит ли агент ответы в своей базе. Проверка ваших пар вопрос-ответ бесплатна — ИИ в ней не участвует.

Можно дополнительно сгенерировать вопросы по документам и сайту: до 20 вопросов, до 40 обращений к ИИ — они спишутся с бюджета, поэтому кабинет попросит подтверждение. В результате видно, сколько ответов корректны, сколько требуют проверки и сколько не нашлось, а у каждой проблемы — кнопка «Исправить».

Публикация и подключение к боту

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

Агент-черновик можно выбрать в блоке «AI-агент», но такой сценарий не опубликуется, пока агент не опубликован. После публикации нажмите «Подключить к боту»: появится черновик сценария «ИИ-агент: …», который отвечает агентом на любой текст. Откройте его в редакторе и опубликуйте — работающий сценарий бота без вас не подменяется.

Снять агента с публикации можно в его настройках — кабинет заранее покажет, в каких сценариях он перестанет отвечать. Удалить агента можно только после того, как его уберут из всех сценариев.

Настройки агента

«Настройки» разбиты на разделы с быстрым переходом сверху: Основные, Поведение, Если агент не знает ответа, Ограничения, Знания, Интеграции, Публичный API и Опасная зона.

Основные — имя, описание, аватар и язык ответов: русский, английский или как у клиента.

Поведение — тон (дружелюбный, нейтральный или официальный, у каждого своя фраза-пример), длина ответа (короткая, средняя или подробная), формат (обычный текст или со списками), свои дополнительные указания — до 4000 символов — и переключатель «Указывать источник ответа»: по умолчанию выключен, под ответом из базы знаний не будет пометки с названием документа; включите, если клиентам нужно видеть, откуда взят ответ. «Если агент не знает ответа» и «Ограничения» — соседние разделы там же, подробно о них — ниже.

Знания показывает, сколько источников в базе, и кнопкой открывает её. Интеграции — список сценариев, где подключён агент (бот, сценарий и его статус — черновик или в бою), ссылка открыть каждый в редакторе и кнопка «Подключить к боту»: подключать можно только к своим ботам, через чужого бота, где вы соредактор, — нельзя.

Публичный API

Агента можно подключить напрямую к своему сайту или приложению, без бота: создайте ключ в настройках агента (раздел «Публичный API», кнопка «Создать ключ») — секрет показывается один раз, сохраните его сразу. Отозвать ключ можно там же в любой момент, он перестаёт отвечать мгновенно.

Запрос: POST https://bots.retensy.com/api/public/agents/<ID агента>/chat с заголовком Authorization: Bearer <ключ> и телом {"message": "Текст вопроса"}. В ответ приходит {"reply": "Текст ответа", "conversationId": "..."} — тот же conversationId, переданный в следующем запросе, продолжает тот же разговор; без него каждый раз начинается новый.

Пример для командной строки: curl -X POST https://bots.retensy.com/api/public/agents/<ID агента>/chat \ -H "Authorization: Bearer <ключ>" -H "Content-Type: application/json" \ -d '{"message": "Какой у вас график работы?"}'

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

Браузерный JavaScript с чужого сайта запрос по умолчанию не отправит — добавьте домен в список «Разрешённые домены (CORS)» там же, в настройках. Вызовы с сервера (не из браузера) ключ не ограничивает.

Если агент не знает ответа

Варианты (настройки агента → «Если агент не знает ответа»): честно сказать, что не знает; предложить связаться с оператором; передать вопрос оператору; отправить свой текст. Стандартную фразу любого варианта можно заменить своим текстом. Если в блоке сценария подключена ветка «не знаю», сценарий идёт по ней, а не по этим вариантам.

«Передать вопрос оператору» отправляет клиенту «Передаю ваш вопрос сотруднику — он ответит здесь же», а диалог остаётся в разделе «Диалоги» как ждущий ответа — со счётчиком и звуком. Ответьте клиенту прямо оттуда.

В «Ограничениях» можно перечислить темы, которые агент не обсуждает, и темы, которые сразу передаёт оператору. Тему вопроса агент определяет сам и иногда может ошибиться.

Аналитика агента

За 7, 30 или 90 дней: диалоги, вопросы, доля найденных ответов, вопросы без ответа, переданные оператору и ушедшие в действия сценария. Считаются только настоящие разговоры с клиентами — тестовый чат и проверка знаний в статистику не входят.

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

Триггеры (точки входа)

Триггер — это с чего сценарий начинается. Точек входа может быть несколько, и не все они про Telegram.

Где выбрать триггер

Триггер спрашивается при создании сценария — шаг «С чего запускать?». Позже добавить ещё один можно кнопкой «Триггеры» в панели блоков справа или на пустом холсте.

Команда не подставляется сама: поле пустое, и вы вписываете нужную — например start. Опубликовать сценарий с пустой командой нельзя.

Входы из бота

Команда

Запуск по команде, которую вводит человек в чате — например /start. Поле команды по умолчанию пустое, впишите свою.

Текст

Запуск, когда человек прислал определённый текст, а не команду.

Нажата кнопка

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

Событие в канале или группе

Реагирует на апдейты Telegram, а не только на сообщения: вступление в канал или группу и выход из них, пост в канале, реакция на сообщение, заявка на вступление, изменение статуса участника и другие.

Обрабатываются в предсказуемом приоритете, а набор отслеживаемых событий пересобирается при публикации.

Для Telegram Business есть три события: «Сообщение через бизнес-аккаунт» (клиент написал на ваш аккаунт), «Редактирование сообщения через бизнес-аккаунт» и «Удаление сообщений через бизнес-аккаунт», а ещё «Вы сами написали клиенту» (сообщение отправили вы, а не бот). Первое срабатывает на то же сообщение, на которое отвечают и обычные триггеры «Команда» и «Текст»; используйте его, когда сценарий нужен только для бизнес-чатов. Подробности — в разделе «Подключения», «Telegram Business».

Если ничего не подошло

Запасной вход: срабатывает, только когда сообщение не подошло ни под один другой триггер. Удобно для ответа «не понял вас».

Уточняющие фильтры события

У события в канале или группе набор доступных фильтров зависит от самого события — конструктор показывает только то, что применимо.

Канал или чат

Можно ограничить событие конкретным каналом/чатом — выбрать из привязанных к боту или указать ID вручную. Полезно, когда бот админит несколько каналов, а реагировать нужно на один.

Статус участника

Для событий об участниках — фильтр по статусу: вступил, вышел, стал администратором и т.п. Реагируйте только на нужный переход.

Текст сообщения

Для событий с текстом (сообщение, пост в канале) — фильтр «содержит» или «равно», без учёта регистра. Условия складываются по И: можно требовать и канал, и текст одновременно.

Вход без бота: вебхук

Сценарий не обязан начинаться с сообщения в Telegram. Точкой входа может быть вебхук — HTTP-запрос из вашей CRM, с сайта или из другого сервиса.

Так автоматизируются процессы, где Telegram — лишь один из шагов: пришла заявка на сайте → сценарий сходил в CRM → отправил уведомление в нужный чат.

Вебхук-сценарий создаётся и без бота: редактор откроется сразу, а бота для ответов можно выбрать позже в панели источника. Без бота сценарий работает только с внешними сервисами — CRM, таблицами, письмами: писать в мессенджер ему не через кого. Кнопки «Тест» у вебхук-сценария нет — его запускает запрос на адрес вебхука: отправьте тестовый запрос из своей системы.

Отвечать вебхук-сценарий может только через бота, которого вы можете править: своего или того, где вы соредактор Editor или Admin. Если такой доступ у вас забрали, вебхук по-прежнему принимается, но новые запуски идут без бота — как будто бот не выбран, а уже начатые прогоны останавливаются на ближайшей паузе: задержке, ожидании ответа или оплате. Секрет вебхука видит только автор сценария: соредакторам бота он не показывается.

Вебхук-сценарий живёт в «Сценариях» своего автора. В списке сценариев бота, через которого он отвечает, его нет — и в счётчик сценариев бота он не входит.

Смена бота или адресата у активного вебхук-сценария проходит те же проверки, что и публикация: если с новым ботом сценарий работать не сможет (например, выбранный бот не поддерживает какие-то его блоки) или адресат указан без бота, настройки не сохранятся — сценарий продолжит работать с прежними, а панель покажет причину.

В том же списке есть «Google Таблицы» — помечены «Скоро» и пока недоступны для выбора: это будущая точка входа, которой в продукте ещё нет.

Триггер „Заявка с сайта“

Запускает сценарий, когда посетитель отправил форму на вашем опубликованном сайте из блоков. В настройках триггера выберите сайт и форму; «Любая форма сайта» — сценарий сработает на заявку с любой формы этого сайта. Список форм берётся из черновика сайта, но заявки принимаются только с опубликованного — после правок формы опубликуйте сайт.

Поля формы приходят переменными по своим именам: {{var.name}}, {{var.phone}}, {{var.email}} и так далее; метки UTM — {{var.utm_source}} и другие. Если поле названо иначе, имя, телефон и почта всё равно найдутся по подписи поля («Имя», «Телефон», «Почта»).

У заявки нет чата с посетителем: блок отправки сообщения сработает, только если в нём явно указан получатель (например, ваш чат). CRM, таблицы, вебхуки и другие действия работают как обычно — от вашего имени.

Триггер доступен и в сценарии бота, и в сценарии без бота: в мастере «Новый сценарий» такой сценарий создаётся без бота, как вебхук-сценарий. Запускаются только ваши сценарии и только для ваших сайтов — при публикации сценария с чужим сайтом будет ошибка.

Одна заявка запускает сценарий один раз. Если этот же сценарий выбран в настройках сайта как «Сценарий» и у него есть вход «Вебхук», запускает его канал доставки, а не триггер. Повтор неудачной доставки заявки сценарий заново не запускает. Запасной вход «Если ничего не подошло» на заявки с сайта не срабатывает.

Вход по оплате

Триггер «Оплата прошла» запускает сценарий, когда в вашей кассе прошёл платёж: ЮKassa, а также подключённые CloudPayments, Robokassa, Т-Банк, Prodamus и bePaid. Это способ выдать доступ, не держа человека в ожидании: счёт выставили, отпустили, а когда деньги придут — бот сам отреагирует.

Если счёт выставлял бот (действие «Выставить счёт»), получателя искать не нужно — счёт запоминает, кому он выставлен. Сценарий запустится в диалоге с этим подписчиком: можно сразу отправить ему сообщение и повесить метку.

Если оплата пришла мимо бота — по ссылке из рассылки или счётом из кабинета ЮKassa — подписчика нет. Тогда указывайте получателя в блоке отправки вручную либо пишите в CRM и таблицы.

Обязательно задайте фильтр — минимальную сумму или слово в описании платежа. Без фильтра сценарий сработает на любую оплату в кассе, включая продажи, к боту не относящиеся.

Сценарий запускается один раз на платёж: если ЮKassa пришлёт уведомление о той же оплате повторно, второго запуска не будет.

Сценарий по оплате отвечает только через ботов владельца кассы. Если ваш вебхук-сценарий привязан к боту другого владельца (например, где вы соредактор), оплата в вашей кассе запустит его без бота: писать подписчикам чужого бота и работать с его подключениями ваша касса не может.

Что доступно в сценарии

Подстановки платежа: {{payment.amount}} — сумма, {{payment.description}} — за что платили, {{payment.id}} — номер платежа в ЮKassa, {{payment.currency}} — валюта.

Чтобы дождаться оплаты прямо в диалоге, этот триггер не нужен — ведите ветку «Оплачено» от блока со счётом. Оплату, пришедшую уже после «Не оплатили вовремя», получает именно этот триггер.

Другие кассы: CloudPayments, Robokassa, Т-Банк, Prodamus, bePaid

Триггер «Оплата прошла» срабатывает не только от ЮKassa, но и от этих пяти касс — они подключаются через «Интеграции», а не через отдельный узел счёта в сценарии. Ветки «Оплачено» у них нет: она есть только у блока со счётом ЮKassa, поэтому не ждите оплату этих касс в диалоге — реакцию на платёж стройте от триггера «Оплата прошла» (или от «Внешних событий» этого подключения).

Действия сценария «Ссылка CloudPayments», «Ссылка Robokassa», «Ссылка Т-Банк», «Ссылка Prodamus» и «Создать ссылку на оплату bePaid» привязывают выданную ссылку на оплату к подписчику, которому её отправили: когда касса подтвердит платёж, «Оплата прошла» сработает именно в чате этого подписчика — так же, как со счётом ЮKassa. Исключение — скидочные промокоды Prodamus: у них нет привязки к чату, такой платёж уходит headless-прогоном.

Только по-настоящему подтверждённый платёж считается оплатой: тестовые и демо-платежи (тестовый терминал Т-Банка, TestMode CloudPayments, тестовый режим Robokassa — IsTest или включённый «Тестовый режим» подключения, демо-режим формы Prodamus, тестовая транзакция bePaid) запускают обычные вебхук-сценарии «Внешние события» этого подключения — с переменной test_mode=1 — но «Оплата прошла» на них никогда не срабатывает и доступ не выдаётся.

Подключение и события этих касс — в разделе «Триггеры» → «Внешние события». У CloudPayments там несколько событий (оплата, отказ, возврат) — событие нужно выбрать явно, «любое событие» для неё недоступно, иначе сценарий выдачи доступа сработал бы и на отказ или возврат.

Внешние события (интеграции)

Отдельный вид вебхук-триггера: сценарий реагирует на событие уже подключённого сервиса, без ручного разбора JSON.

Добавляется как обычный триггер вебхука, но вместо произвольного адреса вы выбираете сервис и конкретное событие: подключение (из «Интеграций» — подключить можно прямо тут, если его ещё нет) и тип события из списка, который зависит от сервиса. Для Tilda и JivoSite подключение создаётся без ключей — просто дайте ему название.

После выбора подключения конструктор показывает готовый адрес вебхука и подсказку «Куда вставить» — где именно в интерфейсе сервиса найти поле для вставки этого адреса. Адрес можно скопировать кнопкой, а при подозрении на утечку — «Обновить» (ротация): старый адрес сразу перестаёт приниматься, новый нужно вставить в сервис взамен.

Поддерживаются: Tilda (заявка с формы), JivoSite (офлайн-сообщение, чат завершён, чат принят оператором), WooCommerce (заказ создан/обновлён), amoCRM (сделка создана/сменила этап, контакт добавлен), Битрикс24 (лид создан/обновлён, сделка создана/обновлена, контакт создан), GetCourse (события процесса), CloudPayments (оплата прошла, платёж отклонён, возврат — событие выбирается обязательно), Robokassa (платёж подтверждён), Т-Банк (оплата прошла), Prodamus (оплата прошла), bePaid (оплата прошла). Подтверждённая оплата этих касс, кроме того, запускает триггер «Оплата прошла» (см. выше).

Переменные события приходят как {{body.<ключ>}} — какие ключи есть у выбранного события, со своими примерами значений, показывает панель «Переменные триггера» в инспекторе узла.

Переменные по провайдерам

Tilda — «Заявка с формы»: formid, tranid, name, email, phone.

JivoSite — «Офлайн-сообщение»: chat_id, widget_id, visitor_name, visitor_email, visitor_phone, message; «Чат завершён»: те же, без message; «Чат принят оператором»: плюс agent_name, agent_email.

WooCommerce — «Заказ создан»/«Заказ обновлён»: id, status, total, currency, billing_first_name, billing_last_name, billing_phone, billing_email.

amoCRM — «Сделка создана»: id, name, status_id, price, responsible_user_id, subdomain; «Сделка сменила этап»: id, status_id, old_status_id, subdomain; «Контакт добавлен»: id, name, subdomain. amoCRM часто присылает пачку сущностей одним запросом (несколько сделок, сделку и контакт сразу) — сценарий запускается по КАЖДОЙ из них отдельно, со своими переменными; порядок: сначала новые сделки, затем смены этапа, затем контакты.

Битрикс24 — все пять событий (лид создан/обновлён, сделка создана/обновлена, контакт создан): event (код события Bitrix24, например ONCRMLEADADD), id (ID лида/сделки/контакта).

GetCourse: id, email, user_id, first_name, phone.

CloudPayments — «Оплата прошла» (Pay): transaction_id, invoice_id, account_id, amount, currency, email, description, test_mode; «Платёж отклонён» (Fail): те же плюс reason, reason_code; «Возврат» (Refund) — см. переменные триггера в инспекторе.

Robokassa — «Платёж подтверждён»: out_sum, inv_id, email, shp_custom (любой Shp_<имя> из ссылки → data.shp_<имя> в нижнем регистре), test_mode.

Т-Банк — «Оплата прошла»: order_id, payment_id, amount, status, test_mode.

Prodamus — «Оплата прошла»: order_id, order_num, sum, currency, payment_status, payment_type, customer_phone, customer_email, date, demo_mode.

bePaid — «Оплата прошла»: uid, tracking_id, amount, currency, status, description, test_mode.

Подключения

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

Боты

Telegram и MAX

Бот подключается по токену. Для Telegram токен выдаёт @BotFather, для MAX — кабинет MAX.

Если токен бота отозван (перевыпущен у провайдера), бот перестаёт получать сообщения — откройте бота → «Настройки» → «Сменить токен» и вставьте новый. Бот перезапустится с новым токеном.

Если тот же токен одновременно подключён в другом сервисе (BotHelp, Salebot, свой скрипт), Telegram делит сообщения между ними. Через 10 минут такого конфликта бот (или один его канал) встаёт на паузу, если другой сервис держит вебхук, а если токен просто опрашивается кем-то ещё — бот работает дальше с предупреждением «Теряет сообщения: токен занят». Что делать — в разделе «Бот приостановлен: конфликт токена».

Удаление бота необратимо: вместе с ним удаляются его сценарии, подписчики с тегами и переменными, история переписки, запуски, рассылки, ссылки и каналы. Из повторяющихся рассылок бот убирается, а рассылка, где ботов не осталось, выключается. Вебхук-сценарий, который только отвечал через этого бота, остаётся у своего автора — уже без бота. Страница, проверявшая вход через этого бота, остаётся, но отвязывается от него.

Один токен — один бот. Если этот бот уже подключён — здесь или в другом аккаунте, — подключение не пройдёт с подсказкой: если бот ваш, перевыпустите токен (в Telegram — /revoke в @BotFather) и подключите новый. То же правило — для дополнительных каналов бота: чужой или свой же токен вторым каналом не добавить.

  1. Создайте бота у провайдера и скопируйте токен.
  2. «Подключения» → «Добавить» → выберите Telegram или MAX.
  3. Вставьте токен и сохраните — бот появится в списке и станет доступен в сценариях.

ВКонтакте

Бот подключается токеном сообщества (Управление сообществом → Работа с API → Создать ключ, доступ «Сообщения сообщества») и числовым id сообщества. После подключения нужно вручную включить Callback API в настройках сообщества (Управление → Работа с API → Callback API): адрес сервера и секретный ключ показываются в карточке подключённого бота — вставьте их и нажмите «Подтвердить сервер», тип события — «Входящее сообщение».

В сценарии доступны обычные блоки «Сообщение» с клавиатурой (инлайн-кнопки), условия по тексту и нажатию кнопки — как в Telegram. Фото, галерея (до 10 картинок в сообщении, больше — несколькими сообщениями), видео, файлы, аудио и голосовые уходят во ВКонтакте настоящими вложениями, а не ссылкой; то же в рассылках. Загруженный файл запоминается на 30 дней и повторно не заливается. Если VK не принял файл (видео недоступно для токена сообщества, сбой загрузки), подпись и кнопки всё равно придут, а видео, файл или аудио — ссылкой в тексте. Всплывающий ответ на нажатие callback-кнопки показывается как подсказка VK.

Контакт-вопрос (кнопка «Поделиться номером») и диплинк-ссылки из раздела «Ссылки на бота» для VK недоступны — вместо них используйте VK-лендинги.

  1. Создайте сообщество VK (если ещё нет) и зайдите в Управление → Работа с API.
  2. Создайте ключ сообщества с доступом «Сообщения сообщества», скопируйте токен.
  3. «Подключения» → «Добавить» → ВКонтакте → вставьте токен и id сообщества.
  4. В открывшейся карточке бота скопируйте адрес Callback API и секретный ключ.
  5. В VK: Управление → Работа с API → Callback API → вставьте адрес и ключ, тип события «Входящее сообщение», нажмите «Подтвердить сервер».

VK-лендинги (Mini App)

Мини-апп внутри ВКонтакте: заголовок, картинка, текст и кнопка подписки — открывается по ссылке вида vk.com/app<ID>_-<сообщество>#l=<лендинг>, без установки отдельного приложения пользователем. Редактор — на странице подключённого VK-бота → «VK-лендинги».

Режим «Авто-подписка» запускает сценарий сразу при открытии ссылки, без нажатия кнопки — подходит для рекламных переходов, где лишний клик снижает конверсию; обычный режим ждёт нажатия кнопки.

Поле «Сценарий-цель»: не выбрано или выбран основной сценарий — подписчик попадает в основной сценарий бота (его триггер /start). Выбран сценарий, опубликованный как дополнительный, — подписчик стартует в нём, основной не меняется. Черновик пока ведёт в основной — рядом есть кнопка «Опубликовать как дополнительный».

У каждого лендинга — две готовые ссылки (обычная и с авто-подпиской) и счётчики просмотров/кликов/подписок. Поле «старый id лендинга BotHelp» — для тех, кто переносит существующие ссылки с BotHelp: по нему видно, какой новый лендинг соответствует старому, ссылки публикуются заново (адрес меняется — страница BotHelp не продолжит работать сама).

Оплата звёздами Telegram (Stars)

Только для Telegram-ботов. Покупатель платит звёздами Telegram прямо в окне оплаты, без кассы и подключений: звёзды копятся на балансе бота у владельца (вывод и курс — по правилам Telegram). В MAX, VK и чат-виджете блок не опубликуется, сервис покажет ошибку.

Это действие «Выставить счёт в звёздах» внутри блока «Действия», в группе «Оплата». Поля: сумма в звёздах (целое число от 1 до 10 000, можно подстановку вроде {{var.price}}), название товара (до 32 знаков), описание (до 255 знаков, необязательно) и сколько минут ждать оплату (по умолчанию 60).

Ветки те же, что у ЮKassa: «Оплачено» и «Не оплатили вовремя». Протянули «Оплачено» — сценарий ждёт платёж и продолжается только после него; не протянули — бот просто пришлёт счёт и пойдёт дальше. Счёт должен быть последним действием в блоке, а в блоке может быть только один счёт (ЮKassa или звёзды, не оба).

После оплаты в переменные подписчика записываются {{var.stars_charge_id}} (номер платежа Telegram, он нужен для возврата), {{var.stars_amount}} (сколько звёзд заплатили) и {{var.stars_paid_at}}. Платёж также попадает в историю: «Платежи звёздами» (страница /bots/stars).

Повторная доставка того же платежа ничего не задваивает: платёж однозначно определяется номером Telegram. Если оплата пришла после таймаута, ветка «Оплачено» уже не запускается, но платёж виден в истории, и его можно вернуть. Если подписчик повторно дошёл до счёта, бот выставит новый, а прежний перестанет приниматься.

Ежемесячная подписка в звёздах: включите в действии галочку «Ежемесячная подписка». Telegram выставляет подписку только ссылкой, поэтому подписчику придёт сообщение с кнопкой (текст кнопки можно задать). Период — 30 дней, продлевает Telegram сам. Первая оплата ведёт в «Оплачено», срок подписки записывается в {{var.sub_until}} и обновляется при каждом продлении — проверяйте его действием «Проверить подписку», как у подписок, которые продлевает сценарий.

Платная подписка на канал: в действии «Создать пригласительную ссылку» укажите цену в звёздах в месяц — бот создаст многоразовую ссылку на вход в канал за Telegram Stars, Telegram сам списывает оплату каждый месяц и убирает из канала тех, кто перестал платить. Бот должен быть администратором канала с правом приглашать.

Платный контент: у фото- и видеокарточки «Сообщения» в Telegram есть поле «Платный контент, звёзд» (1–25000). Подписчик видит размытое превью и открывает медиа после оплаты; без цены карточка уходит как обычно.

Возврат: «Платежи звёздами» → выберите бота → «Вернуть» у нужного платежа. Звёзды вернутся покупателю, платёж получит статус «Возвращено». Повторное нажатие безопасно.

  1. В сценарии Telegram-бота добавьте блок «Действия» → «Выставить счёт в звёздах».
  2. Укажите сумму в звёздах и название товара, при желании описание и время ожидания.
  3. Протяните от блока ветки «Оплачено» и «Не оплатили вовремя».
  4. Опубликуйте сценарий: бот сам включит приём pre_checkout_query от Telegram, отдельных настроек не нужно.

Приём оплат через ЮKassa

Деньги идут на ВАШУ кассу, не на счёт сервиса: вы подключаете свой магазин ЮKassa, и бот выставляет от него счета. Секретный ключ хранится зашифрованным и обратно не показывается — только последние 4 символа.

Чтобы сценарий узнал об оплате, касса должна о ней сообщить. Для этого в карточке подключения есть адрес уведомлений — его нужно вписать в кабинете ЮKassa. Так ветка «Оплачено» срабатывает сразу после оплаты. Если уведомления не настроены или не дошли, сервис сам проверяет статус ожидающих счетов в ЮKassa: первый раз примерно через 30 секунд после счёта, затем всё реже — до раза в 10 минут, пока не выйдет время ожидания. Поэтому ветка «Оплачено» сработает и без уведомлений, но с задержкой до нескольких минут, и ровно один раз — даже если потом придёт и уведомление. Если ЮKassa отменила платёж, проверки прекращаются, а по истечении времени ожидания сработает ветка «Не оплатили вовремя».

Если подписчик не оплатил вовремя и снова дошёл до счёта, бот выставит новый счёт. Пока прежний счёт ещё ждёт оплаты, повторный проход покажет ту же ссылку — второго платежа не будет, даже если между ними подписчик писал в чат и проходил другие ветки сценария. Если же он за это время дошёл до другого счёта с веткой «Оплачено», бот ждёт уже этот новый счёт: оплата прежней ссылки сценарий не продолжит, такие случаи разбирайте вручную. Оплата, пришедшая уже после «Не оплатили вовремя», ветку «Оплачено» не запустит: подписчик уже ушёл по таймауту, а отменить такой платёж сервис не может — оплата ЮKassa одностадийная. Зато она запустит ваши сценарии с триггером «Оплата прошла» в диалоге с этим подписчиком — один раз на платёж; если бот в этот момент выключен, ЮKassa будет повторять уведомление, и сценарий запустится, когда вы включите бота. Заведите такой сценарий, чтобы опоздавшие получали доступ сами; без него деньги просто придут на вашу кассу.

Без ветки «Оплачено» бот оплату не ждёт, поэтому каждый проход по такому счёту выставляет новый счёт с новой ссылкой.

Если в момент оплаты бот выключен или ЮKassa не подтвердила проверку платежа (сбой или устаревший ключ в подключении), сервис просит её повторить уведомление. ЮKassa повторяет его до суток, и ветка «Оплачено» сработает на первом удачном повторе — если таймаут оплаты к тому времени ещё не сработал. Если за сутки повтор так и не удался (бот всё ещё выключен, ключ не исправлен), по этой оплате сценарий не продолжится, хотя деньги уже на вашей кассе. Если срок оплаты истёк, пока бот был выключен, ветка «Не оплатили вовремя» уже не сработает. Когда подписчик снова дойдёт до счёта, бот проверит платёж в ЮKassa: оплачен — сразу пойдёт ветка «Оплачено»; не оплачен — бот выставит новый счёт; если ЮKassa не ответила — пришлёт прежнюю ссылку.

  1. «Подключения» → «Добавить» → ЮKassa. Введите shopId и секретный ключ из кабинета магазина.
  2. Скопируйте адрес уведомлений из карточки подключения.
  3. В ЮKassa: Интеграция → HTTP-уведомления → вставьте адрес и включите событие payment.succeeded.
  4. В сценарии добавьте блок «Действия» → «Выставить счёт», выберите кассу, укажите сумму и за что платят.
  5. Счёт делайте последним действием в блоке: после него блок ждёт оплату, и следующие действия не выполнятся.
  6. Протяните от блока ветку «Оплачено» — сценарий будет ждать платёж и продолжится только после него. Если до оплаты подписчик напишет в чат и пройдёт другую ветку (например, ответ на любой текст), ожидание не сбросится: ветка «Оплачено» сработает, когда деньги придут.
  7. Ветка «Не оплатили вовремя» сработает, если оплаты не было в течение заданного времени (по умолчанию 60 минут).
  8. Если ждать в сценарии не нужно, ветку «Оплачено» не ведите, а сделайте отдельный сценарий с триггером «Оплата прошла»: когда деньги придут, бот сам поймёт, кто заплатил, и выдаст доступ — счёт запоминает получателя.

Telegram Business: бот отвечает от вашего имени

Telegram Business позволяет подключить бота к вашему личному или бизнес-аккаунту Telegram: клиенты пишут вам как обычно, а отвечает бот, и ответ выглядит как ваше сообщение. Нужен Telegram Premium у владельца аккаунта. Работает только для Telegram-ботов.

Сообщения клиента запускают сценарий так же, как обычные: срабатывают триггеры «Команда» и «Текст», ИИ-агент, вопросы и задержки. Каждый клиент Business живёт в отдельной сессии подписчика, не связанной с его личным чатом с ботом (это два разных диалога, даже если человек один). Отличить такие чаты можно условием «Канал Telegram Business» или триггером-событием «Сообщение через бизнес-аккаунт».

Бот не отвечает на ваши собственные сообщения в этих чатах и на сообщения, которые он сам отправил от вашего имени. Если подключение отключено или у бота снят пункт «Отвечать на сообщения» (can_reply), сценарий не запускается и ничего не отправляется.

Ограничения: Telegram разрешает отвечать только в чатах, где клиент писал за последние 24 часа; рассылки и операторские ответы из «Диалогов» в бизнес-чаты не идут; удаление отправленных сообщений и оплата Stars в бизнес-чатах не поддерживаются.

Несколько аккаунтов: один бот может вести несколько личных аккаунтов (сколько — зависит от тарифа: на бесплатном 1, на платных втрое больше числа ботов). Каждый клиент живёт в отдельной сессии своего аккаунта, поэтому клиент, написавший двум вашим аккаунтам, не перепутается. В карточке «Telegram Business» у каждого аккаунта есть название (меняется прямо в карточке), переключатель «Бот отвечает» (пауза без отключения в Telegram: сообщения пишутся только в «Диалоги») и список прав, которые вы выдали боту в Telegram. Сверх лимита тарифа бот на аккаунте не отвечает, об этом сказано в карточке.

Разные ответы для разных аккаунтов: у триггеров «Текст», «Команда», «Нажатие кнопки», «Если ничего не подошло» и «Событие» есть поле «Где срабатывает»: везде, только чат с ботом или только бизнес-аккаунты, и можно выбрать конкретные аккаунты. Если подходят два триггера, выигрывает более узкий (с выбранным аккаунтом).

Если вы ответили клиенту сами, бот не перебьёт вас: в чате включается пауза. Настройка в карточке аккаунта: выключена, молчать N минут (по умолчанию 30, каждое ваше сообщение продлевает срок) или молчать, пока вы не нажмёте «Вернуть боту» в «Диалогах». У нового подключения пауза включена, у подключённых раньше — выключена, включите её в карточке. Для отдельного сценария можно задать своё правило. Событие «Вы сами написали клиенту» запускает сценарий, например, чтобы сделать заметку в CRM (ответы бота в нём не отправляются).

Действие «Отметить прочитанным (бизнес-аккаунт)»: бот ставит клиенту две галочки от имени аккаунта (нужно право «Читать сообщения»). Отправка из сценариев, запущенных не из бизнес-чата (расписание, оплата, заявка сайта), идёт от аккаунта, если в блоке сообщения выбрать «От имени» нужный аккаунт.

Сценарии аккаунта: в карточке «Telegram Business» под каждым аккаунтом выберите сценарий и условие (всегда, слова в сообщении или время по Москве) — правило добавится в основной сценарий обычными блоками, их можно открыть в редакторе. Готовые шаблоны: «Автоответ вне рабочих часов от лица менеджера», «ИИ-менеджер в личке с передачей человеку» (ИИ-развилка понимает, о чём речь, и зовёт человека) и «Заявка сайта: написать с личного аккаунта».

Управление аккаунтом из сценария (блок «Действия»): удалить сообщения, поменять имя, описание, фото или username, отправить чек-лист (отметки клиента ловит событие «Клиент отметил пункты чек-листа»), узнать баланс звёзд, посмотреть подарки, настроить их приём, опубликовать историю. Каждое действие требует своё право, выданное в Telegram, иначе шаг покажет понятную ошибку, а сценарий пойдёт дальше. Необратимые операции (перевод звёзд, превращение в звёзды, улучшение и передача подарка) требуют явной суммы или получателя и галочки подтверждения: без неё сценарий не опубликуется.

  1. Откройте бота в кабинете: «Настройки» → «Telegram Business» — там инструкция и статус подключения.
  2. В Telegram: Настройки → Telegram для бизнеса → Чат-боты, укажите @username вашего бота.
  3. Выберите, каким чатам бот отвечает, и разрешите право «Отвечать на сообщения».
  4. Вернитесь в кабинет: подключение появится в статусе «Подключён». Отключить бота можно там же, в настройках Telegram.

Каналы и группы

К боту привязываются каналы и группы: добавьте бота администратором, и канал станет доступен в условии «Подписан на канал» и в фильтрах события. Так проверяют подписку и постят от имени бота.

Соредакторы

Карточка бота → «Доступ»: пригласите соредакторов по email или ссылкой. Admin — полный доступ (правка, рассылки, пользователи, настройки), Editor правит и публикует сценарии, Viewer только смотрит. Приглашение по email ждёт согласия: приглашённый увидит его в списке ботов и примет или отклонит (если аккаунта нет — после регистрации на этот email). Приглашение видит только аккаунт, который входит по этой почте (вход по email); тому, кто входит через Google, VK или Telegram, отправьте ссылку. По ссылке доступ появляется сразу: ссылку человек открывает сам.

Сценарии бота принадлежат его владельцу. Сценарий, который соредактор создал на вашем боте — в том числе из раздела «Сценарии», — появится у вас в «Сценариях» и засчитается в лимит вашего тарифа; соредактор найдёт его на странице бота.

Удаление соредактора и смена его роли действуют сразу: если у него открыт редактор сценария, он переподключится уже с новой ролью, а удалённого обратно не пустит.

Передать бот можно только соредактору и только с его согласия: владелец предлагает в «Доступе», получатель принимает в списке ботов. Если у получателя нет места под ещё один активный бот по тарифу, принять не получится — он увидит, что сделать. После передачи лимиты, подключения и рассылки бота считаются по тарифу нового владельца, прежний остаётся администратором. Его повторяющиеся рассылки этот бот больше не отправляют, а правило, где других ботов нет, останавливается. Пока предложение не принято, владелец может его отозвать.

CRM и сервисы

Каталог сервисов открывается кнопкой «Добавить» в «Подключениях». В нём — поиск по названию, категории и логотипы; искать можно и по названию действия («отправить сделку»).

Доступны amoCRM, Битрикс24, GetCourse, Google Таблицы и другие. Подключённый сервис используется в блоке «Внешний запрос» и в действиях сценария.

Добавить несколько сразу

В каталоге можно отметить несколько сервисов и пройти мастер очередью «Шаг 1 из N». Если один сервис не подключился, очередь не падает — в конце виден итог: подключено / пропущено / с ошибкой.

Управление ключами

Уже подключённый сервис можно переименовать, заменить ключ или удалить. Честно: сервисы без своей формы подключения (например узлы-сценарии) в мастере помечены отдельно и фейковую форму не показывают.

Интеграции: каталог и проверка подключения

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

Ключи и токены хранятся зашифрованными и обратно не показываются — ни в кабинете, ни через MCP. Чтобы заменить ключ, введите новый.

У подключения есть статус: «Работает», «Нужно переподключить» (сервис отказал в доступе — ключ отозван или устарел) и «Ошибка» (сервис недоступен или ответил сбоем). Статус обновляется по результату действий сценария и фоновых проверок; пока подключение не проверялось, статуса нет.

Кнопка «Проверить» в карточке подключения делает живую проверку ключа у сервиса — без побочных эффектов: ничего не создаёт и не отправляет. Проверку поддерживают не все сервисы.

Если подключение перестало работать, владельцу приходит уведомление. Переподключите сервис — замените ключ, — и статус вернётся к «Работает» после следующей удачной проверки.

Сервисы в статусе «Бета» (новые подключения, ещё без полного прогона на реальных аккаунтах): Telegram-уведомления в чат, SMS.RU, SMS Aero, SMSC.ru, Unisender, RetailCRM, МойСклад, CloudPayments, Т-Банк эквайринг, Robokassa, Prodamus, Google Analytics 4, Roistat, REST API (свой сервис), СДЭК, WordPress/WooCommerce, Ozon, Wildberries, Яндекс Маркет, Яндекс Доставка.

Действия интеграций: обязательные поля и переменные

Действия подключённых сервисов добавляются в блок «Действия». Обязательные поля в форме действия помечены звёздочкой и подписью «Обязательное поле»: если оставить такое поле пустым или заполнить неверно, сервис не вызывается, а блок уходит в выход «Ошибка» с понятной причиной. Под формой написано, какие переменные действие запишет после успешного выполнения — их же предлагает выбор переменных в следующих блоках.

Яндекс Доставка: расчёт стоимости

Действие «Рассчитать стоимость доставки Яндекс» требует все поля: координаты точек (fromLat, fromLon, toLat, toLon), адрес отправления и адрес назначения (fromAddress, toAddress — город, улица, дом, без квартиры и подъезда), вес в килограммах (weightKg) и габариты упаковки в сантиметрах (lengthCm, widthCm, heightCm — положительные числа, дробь можно через запятую).

Без адресов или габаритов действие вернёт ошибку и не будет считать цену по «условной коробке» — раньше такие расчёты занижали стоимость. Если в сценарии уже есть переменные с адресом или размерами, подставьте их: {{var.address}}.

После расчёта доступны: {{var.ydelivery_price}} — стоимость, {{var.ydelivery_currency}} — валюта, {{var.ydelivery_eta}} — крайний срок доставки (дата и время).

СДЭК: итоговая сумма

Действие «Рассчитать тариф СДЭК» кладёт в переменные {{var.cdek_price}} — стоимость самой доставки, {{var.cdek_total_sum}} — итог к оплате вместе с дополнительными услугами (страховка и т. п.), и сроки {{var.cdek_days_min}}–{{var.cdek_days_max}} дней. Клиенту показывайте cdek_total_sum: если доп. услуг нет, она равна стоимости доставки. Сумма — с точностью до копеек, без «хвостов» округления.

МойСклад: остаток товара

«Найти товар в МойСклад» теперь, кроме названия и цены, сохраняет {{var.moysklad_product_id}} — ID найденного товара.

«Остаток товара в МойСклад» (moysklad_product_stock) — сколько товара на складах. Поле «ID товара» обязательное: это UUID товара или модификации, обычно {{var.moysklad_product_id}} из предыдущего действия. «Тип остатка» необязателен: stock (остаток, по умолчанию), freeStock (свободный остаток), quantity (доступно), reserve (резерв) или inTransit (ожидается).

Результат — в {{var.moysklad_stock}}. Товар без движений по складу получает остаток 0. Дальше удобно ветвиться «Условием»: если {{var.moysklad_stock}} больше 0 — предлагаем купить, иначе — «нет в наличии, сообщим о поступлении».

Unisender: отправить SMS

«Отправить SMS через Unisender» (unisender_send_sms) — одиночное SMS без создания рассылки. Все три поля обязательные: «Телефон» — с кодом страны (можно {{var.phone}}), «Имя отправителя» — зарегистрированное в Unisender альфа-имя от 3 до 11 символов, «Текст» — до 1000 символов, можно с переменными.

После отправки ID сообщения в Unisender лежит в {{var.unisender_sms_id}} — по нему можно найти SMS в кабинете Unisender. Если Unisender отказал (например, имя отправителя не подтверждено), блок уходит в выход «Ошибка» с текстом причины.

Яндекс Маркет: статус заказа

Для подключения нужны «ID кампании» (кабинет Маркета → Настройки → API и модули → «Идентификатор кампании») и API-ключ оттуда же. Кабинет (businessId) сервис определяет сам по ID кампании — уже созданные подключения переподключать не нужно. Кнопка «Проверить» проверяет и ключ, и ID кампании.

Действие «Статус заказа Яндекс Маркет» (ymarket_order_status) принимает «ID заказа» — число, можно {{var.order_id}}. Результат: {{var.ymarket_status}} — статус (PROCESSING, DELIVERY, DELIVERED, CANCELLED и т. д.) и {{var.ymarket_substatus}} — этап обработки или причина отмены.

Статус берётся новым методом Маркета для кабинетов, который ищет заказы, оформленные за последние 30 дней. Более старый заказ вернёт ошибку «заказ не найден» — блок уйдёт в выход «Ошибка».

REST API: числа и да/нет в теле запроса

В теле JSON действия REST API подстановка {{var.x}} сама ставит кавычки строкам. Если в переменной число или логическое значение (да/нет), оно уходит своим типом: {"qty": {{var.qty}}} превращается в {"qty": 5}, а не {"qty": "5"}; true/false — без кавычек. Тип берётся из самой переменной: введённый подписчиком текст, даже из одних цифр (например телефон 79991234567), остаётся строкой.

Бот приостановлен: конфликт токена

Если на карточке бота плашка «Приостановлен: токен занят другим сервисом», «Канал приостановлен: токен занят» или «Теряет сообщения: токен занят», значит, этот же Telegram-токен одновременно подключён где-то ещё. Ниже — что это значит и как исправить.

Токен бота отозван

Это другая ситуация: токен перестал существовать. Так бывает, если в @BotFather нажали «Revoke current token», удалили бота или сменили владельца. Telegram или MAX отвечают «Unauthorized», и повторять опрос бессмысленно: сколько ни пробуй, ответ не изменится.

Retensy в этом случае сразу останавливает опрос бота, помечает его и один раз присылает вам уведомление на почту и в подключённые мессенджеры. Мы не запускаем бота заново при каждом рестарте и каждой публикации, пока токен не поменяется.

Что делать: в @BotFather выпустите новый токен (команда /token) и вставьте его в настройках бота через «Сменить токен». Как только токен другой, бот снова считается живым и опрос запускается сам.

Что случилось

Telegram отдаёт каждое сообщение бота только одному получателю. Если токен одновременно подключён к Retensy и к другому сервису (BotHelp, Salebot, другой конструктор или ваш собственный скрипт), часть сообщений уходит туда: эти подписчики бота в Retensy не видны, сценарии у них не запускаются.

Retensy замечает такой конфликт сам: Telegram отвечает, что токен уже занят. Пока конфликт идёт, сервис реже обращается к Telegram (пауза растёт до 30 секунд между попытками). Что происходит дальше, зависит от того, как именно другой сервис держит токен.

Другой сервис поставил вебхук — бот на паузе

Если на токене стоит вебхук другого сервиса, Telegram отправляет все сообщения туда, а Retensy не получает ничего. Через 10 минут такого конфликта бот автоматически ставится на паузу — так же, как кнопкой «Остановить»: сценарии, подписчики, рассылки и история сохраняются, ничего не удаляется. Токен и вебхук другого сервиса Retensy не трогает.

Если у бота несколько Telegram-каналов и конфликт только у одного из них, выключается только этот канал — бот продолжает работать через остальные, а на его странице написано, какой канал выключен.

В уведомлении и на плашке указан адрес того сервиса (например tghook.bothelp.io), если Telegram его сообщил — по нему проще понять, где искать.

Токен опрашивает другая программа — предупреждение

Если токен одновременно забирает сообщения другой сервис или скрипт (режим опроса), бот на паузу не ставится и продолжает работать, но часть сообщений теряется. Через 10 минут такого конфликта на карточке появляется предупреждение «Теряет сообщения: токен занят», а владелец получает одно уведомление. Предупреждение исчезает само через несколько минут после того, как конфликт закончился.

Как вы узнаете

Красная точка на пункте «Боты» (или «Подключения») в меню кабинета, плашка на карточке и на странице бота. Если в профиле включены уведомления — ещё и сообщение в привязанный Telegram/MAX и на почту: о паузе — сразу, о потере сообщений — не чаще раза в сутки.

Если конфликт одновременно начался и держится у многих ботов сразу, это почти наверняка сбой на нашей стороне: тогда сервис не ставит ботов на паузу и не рассылает уведомления, а сигнал получает команда Retensy.

Как исправить

Если после запуска вебхук другого сервиса остался, через 10 минут пауза повторится и придёт новое уведомление. Значит, нужно ещё раз проверить первый шаг или перевыпустить токен.

Пока конфликт был, часть сообщений подписчиков могла не дойти до Retensy — Telegram доставил их другому сервису, повторно он их не отдаст.

  1. Найдите, где ещё подключён этот бот: BotHelp, Salebot, другой конструктор, сервис рассылок или скрипт программиста. Подсказка — адрес сервиса в плашке на странице бота, если он указан.
  2. Отключите или удалите бота в том сервисе. В конструкторе вроде BotHelp или Salebot удалите там этого бота (канал), свой скрипт — остановите.
  3. Не помните, где он подключён, или нет доступа — перевыпустите токен: в @BotFather отправьте /revoke, выберите бота и скопируйте новый токен. Старый токен перестанет работать везде, в том числе в чужом сервисе. Затем в Retensy откройте бота → «Настройки» → «Сменить токен» и вставьте новый.
  4. Если бот или канал на паузе — нажмите «Запустить» на карточке бота или в плашке на его странице. Пауза снимется, бот снова начнёт получать сообщения. Предупреждение о потере сообщений кнопки не требует — оно исчезнет само.

Чат на сайте

Виджет — это чат на вашем собственном сайте, в котором отвечает тот же сценарий, что и в мессенджерах: сообщения, кнопки, вопросы, ИИ-агент с базой знаний. Вставляется одной строчкой кода.

Как подключить

Виджет считается ботом тарифа: он входит в лимит ботов, а каждый посетитель, написавший в чат, — в лимит подписчиков.

  1. «Подключения» → карточка «Виджеты на сайт» → «Открыть подключение» (или сразу /bots/connect/web). Нажмите «Создать виджет».
  2. Скопируйте код кнопкой «Скопировать код» и вставьте его на каждую страницу сайта перед закрывающим тегом </body>. В Tilda — блок «HTML-код» (T123), в WordPress — поле «Код в подвале» темы или плагин вставки кода.
  3. Соберите сценарий бота и опубликуйте его. Код виджета потом всегда есть в «Настройках» бота.

Как начинать сценарий виджета

Диалог в чате начинается с первого сообщения посетителя. Простое открытие чата сценарий не запускает и подписчика не создаёт — иначе каждый заглянувший съедал бы лимит тарифа. Команда /start в виджете сама не приходит.

Поэтому начните сценарий с триггера «Текст» в режиме «Любой текст». Триггер «Команда» нужен для входа со страницы через retensy('start', …) — см. ниже. Сценарий, скопированный из Telegram, начинайте заново с «Текста» — редактор предупредит об этом.

До первого сообщения посетитель видит приветствие из настроек виджета — его рисует сам виджет.

Что умеет чат и чего нет

Работают сообщения, кнопки-ответы и кнопки-ссылки, вопросы, условия, переменные, задержки, интеграции и ИИ-агент с базой знаний — ответы агента приходят в чат так же, как в Telegram. Фото, видео и аудио показываются в чате, файлы — ссылкой.

Форматирование в чате не отображается: жирный и курсив приходят обычным текстом, ссылка — «текст (адрес)».

Нет кнопки «поделиться контактом» — посетитель вводит номер вручную. Условие «подписан на канал» в чате неприменимо: ветка всегда идёт по «нет». Правка и удаление уже отправленных сообщений в чате не поддерживаются.

Все переписки видны в разделе «Диалоги» и в карточке подписчика, как у остальных каналов. Неактивный посетитель (90 дней без сообщений) забывается, переписка в самом окне чата хранится сутки.

Внешний вид, домены и приглашение

«Настройки» бота → «Внешний вид, домены и приглашение»: шесть положений на экране (в углах — круглая кнопка, по центру сверху или снизу — длинная плашка с текстом), акцентный цвет и цвет текста, светлая или тёмная тема, скругление, аватар по ссылке https, заголовок, подзаголовок, приветствие и подсказка в поле ввода. Справа — превью. На телефоне чат всегда открывается во всю ширину.

Разрешённые сайты: код виджета виден в исходниках страницы, и без списка его можно вставить на чужой сайт. Перечислите свои домены по одному в строке («*.shop.ru» — все поддомены). Пустой список — виджет работает на любом сайте.

Приглашение — приветствие у кнопки чата, которое появляется само: через N секунд на странице (0–600), когда посетитель пытается уйти со страницы (только на компьютере) и только на страницах по маске: «/catalog/*» — все страницы раздела, «/pricing» — одна страница, путь без домена и без «?». Показывается не чаще раза за визит и не показывается тем, кто уже открывал чат. Гео-таргетинга и A/B-вариантов приглашения нет.

Свой бренд (без подписи)

Внизу чата — подпись «Собрано на bots.retensy.com». На тарифах от «Бизнеса» (Бизнес, Максимум, Премиум, Корпорация — любой период оплаты) её можно скрыть галочкой в настройках вида.

Та же возможность — у опубликованных сайтов из блоков (подпись «Сделано на Retensy» в углу страницы, галочка в настройках страницы) и у публичной страницы записи /book/<slug> (галочка в настройках календаря, раздел «Публикация»). Право решает тариф — проверка на сервере, обойти галочкой в настройках на младшем тарифе нельзя.

Если подписка закончилась или тариф сменился на младший, подпись возвращается сама везде — в чате, на сайте и на странице записи, — а сделанный выбор (галочка) сохраняется: при продлении подпись снова скроется без повторной настройки.

JS-API: управление чатом из кода сайта

Первый тег из кода виджета — заглушка: благодаря ей retensy(...) можно вызывать сразу, даже до загрузки чата, вызовы выполнятся по порядку.

retensy('open') — открыть чат, как по клику на кнопку.

retensy('setVariables', {plan: 'pro'}) — передать данные страницы в сценарий. Они уезжают с ближайшим сообщением и доступны в сценарии как {{var.page_plan}}: префикс page_ ставится сам и не даёт затереть переменные сценария. Имя — латиница a-z, цифры и _, с буквы, до 32 символов; значение — строка, число или да/нет до 256 символов; до 20 переменных за раз. Это данные посетителя: цену и скидку берите из сценария, а не отсюда.

retensy('start', 'buy') — открыть чат и запустить ветку: сработает триггер «Команда» с командой buy, строка /buy в ленте не показывается. Без такого триггера /buy уйдёт в сценарий как обычный текст. Ключ — латиница, цифры и _, до 32 символов.

retensy('onMessage', fn) — fn(m) на каждую реплику бота и посетителя: m.from (bot или visitor), m.text, m.type, m.mediaUrl, m.buttons. Текст простой — вставляйте его на странице через textContent.

retensy('onEnd', fn) — fn() когда сценарий явно завершён: блок «Конец» или действие «Остановить бота». Ветка, которая просто закончилась сообщением с кнопками, концом не считается.

Пример — кнопка «Купить» на странице тарифа: <button onclick="retensy('setVariables',{plan:'pro'});retensy('start','buy')">Купить</button>.

Подписчики

Все, кто когда-либо писал вашим ботам, собираются в одном месте — с тегами, переменными и перепиской за последние 90 дней.

База подписчиков

Список ищется по chatId или username. У каждого человека — теги и переменные (например имя, город, этап воронки) и статус: активен или заблокировал бота.

Если человек остановил бота в Telegram, он помечается «заблокировал бота»: рассылки ему не уходят. Запустит бота снова — метка снимется сама.

Дата подписки видна с момента, когда функция появилась; у подписчиков, заведённых раньше, этой даты нет (прочерк) — восстановить её задним числом нельзя, сортировка и фильтр по ней таких подписчиков не теряют, но и не упорядочивают точно.

Фильтр и сортировка

Кнопка «Фильтры» открывает построитель: теги (любой из / все из / кроме — с поиском по реальным тегам бота), статус (активен / заблокировал), дата подписки и дата последней активности, и условия по переменным — оператор зависит от типа переменной (текст: равно/не равно/содержит; число: равно/больше/меньше/между; дата: раньше/позже/между; да/нет: равно), несколько условий можно связать «И» или «ИЛИ». Активные условия показаны чипами сверху, кнопка «Сбросить» убирает всё разом.

Список сортируется по дате подписки, последней активности, username, chatId, статусу или боту (на странице «Подписчики», где показаны все боты сразу) — по возрастанию или убыванию.

Тип переменной (текст/число/дата/да-нет) подсказывается автоматически по последним заполненным значениям — отдельно заводить тип не нужно.

Импорт и экспорт

Списки выгружаются в CSV/JSON (быстрый экспорт всего списка бота) и так же импортируются — удобно переносить аудиторию или готовить сегмент для рассылки.

Кнопка «Экспортировать» на странице подписчиков выгружает именно текущую отфильтрованную выборку (не только открытую страницу) в CSV или XLSX — потоково, с ограничением по числу строк; если выборка больше лимита, сузьте фильтр. Работает и по одному боту, и сразу по нескольким выбранным (или по всем доступным, если ни один не выбран) — тогда в файле появляется колонка «Бот».

Если человек из файла уже есть в боте, импорт дополняет его карточку: добавляет теги и переменные, которых у него ещё нет, а уже заполненное не меняет.

Не импортируются переменные с точкой в имени или с $ в начале, переменные, внутри значения которых (например, во вложенном объекте) есть такой ключ, служебные имена бота (например, _last_msg_id) и переменные сверх лимита подписчика (262 144 символа на все его переменные вместе с уже заполненными) — итог импорта назовёт каждую.

Импорт из другого конструктора

Кнопка «Импорт из другого конструктора» на странице подписчиков — мастер переноса аудитории из BotHelp, SaleBot, Senler, Leadteh, Smartsender или ManyChat (или любого другого сервиса — пункт «Универсальный CSV»). Для SaleBot/Senler/Leadteh/Smartsender/ManyChat переносятся только подписчики: ни у одного из них нет документированного публичного формата экспорта сценария/воронки, поэтому воронки мы не парсим и не придумываем формат под них — мастер честно говорит это на первом шаге.

Подписчики переносятся универсальным CSV column-mapper'ом: вы загружаете выгрузку из сервиса (CSV, первая строка — заголовки), мастер сам читает заголовки и подсказывает, какая колонка похожа на id/username/теги (по распространённым именам вроде ID, user_id, username, tags), но сопоставление всегда подтверждаете вы. Нераспознанные колонки становятся переменными подписчика. Поддерживаются и дата подписки, и источник/UTM, и статус (активен/отписан/заблокирован — заблокированным и отписанным рассылка и сценарий больше ничего не шлют), если они есть в выгрузке.

Перед импортом — обязательный предпросмотр (dry-run): сколько подписчиков добавится, сколько уже есть и будет дополнено, сколько строк пропущено (нет корректного id) и сколько новых не поместится в лимит тарифа. В базу ничего не пишется, пока вы не нажмёте «Импортировать». Дальше действуют те же правила, что у обычного импорта: дедуп по (боту, id чата), уже заполненное не перезаписывается, лимит подписчиков тарифа соблюдается.

Файл стримится на сервере с капами: до 10 МБ и 20 000 строк за раз — более крупную выгрузку нужно разбить на части.

id подписчика в файле должен быть числовым Telegram ID (как в своём экспорте CSV/JSON) — он уникален для каждого конструктора и у некоторых сервисов (например ManyChat) штатного CSV-экспорта нет вовсе: мастер говорит об этом в описании платформы и предлагает выгрузить контакты вручную (например, через Google Таблицы) и загрузить получившийся файл как обычный CSV.

Если бот ещё живой в старом конструкторе (BotHelp и т.п.): создайте его в Retensy неактивным, перенесите сценарий и подписчиков, затем включите — так старый конструктор не теряет вебхук раньше времени. Подробности — в следующем разделе.

BotHelp: перенос самого сценария (воронки), не только подписчиков

Для остальных перечисленных конструкторов воронку переносят пересборкой через ИИ-агента: опишите сценарий словами (или сделайте скриншоты экранов старого конструктора) и отдайте агенту, подключённому через MCP (раздел «MCP») — готовый шаблон запроса есть в мастере миграции и в уроке «Как подключить MCP и собрать бота через ИИ».

Для BotHelp — иначе: формат его собственного экспорта сценария (JSON-дамп одного бота plus файлы внешних запросов) структурно разобран, его переносит отдельный конвертер, а не пересказ агенту словами.

Сделать это может MCP-агент, подключённый к вашему кабинету, инструментами bothelp_scenario_preview и bothelp_scenario_commit: preview прогоняет конвертер в режиме просмотра (ничего не пишет в базу) и возвращает отчёт — сколько узлов получилось и что перенеслось приближённо или вовсе не перенесено, с понятной причиной на каждый такой случай; commit делает то же самое и сохраняет сценарий черновиком. Повторный запуск с тем же файлом обновляет тот же черновик, а не создаёт второй.

Перенести можно не всё 1:1 — часть блоков BotHelp (amoCRM-действия без заранее подключённой интеграции, часть редких типов шагов) требует ручной донастройки после импорта; отчёт preview/commit называет каждый такой блок прямо, не умалчивает.

После импорта черновик остаётся черновиком — проверьте его на холсте и опубликуйте сами, когда убедитесь, что всё верно.

Если старый бот всё ещё отвечает (вебхук в BotHelp живой), создайте бота в Retensy неактивным (MCP-инструмент create_bot с inactive:true — токен проверяется безопасно, вебхук/поллинг не трогаются), перенесите сценарий и подписчиков, а затем включите бота (bot_resume) — это и есть переключение (cutover). До включения старый конструктор продолжает отвечать как обычно.

Карточка подписчика

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

История переписки хранится 90 дней, запуски сценариев с их шагами — 30 дней; более старые удаляются автоматически. Поэтому «Первое сообщение», «Сообщений» и «Запусков» в карточке считаются за эти сроки. Сам подписчик, его теги и переменные хранятся, пока вы их не удалите.

Диалоги

Живая переписка по всем ботам в одном окне.

Переписка по всем ботам

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

Диалог открывается справа: переписка за последние 90 дней (более старые сообщения удаляются автоматически), а по кнопке «Профиль» — данные подписчика и ссылка на полную карточку.

Поиск вверху ищет сразу по имени, username, user id, названию бота и тексту сообщений — по всем ботам сразу, с небольшой задержкой после ввода. Поиск по тексту смотрит в переписку за последние 90 дней (она и так хранится не дольше).

Ответить самому

Внизу открытого диалога — поле ответа: Enter отправляет, Shift+Enter переносит строку. Сообщение уходит от имени бота в тот же мессенджер (Telegram, MAX или чат на сайте) и появляется в переписке с пометкой «Вы».

Ответ не влияет на сценарий: подписчик остаётся на том же шаге, таймеры и ожидания продолжают работать как раньше.

Если мессенджер ограничивает время ответа (например, 24 часа после последнего сообщения подписчика), позже отправка не пройдёт, пока он не напишет снова. Подписчику, который заблокировал бота, сообщение не доставить. Если отправка не удалась, под сообщением появится причина и кнопка «Повторить».

Передача диалога оператору

Пока диалог передан оператору (кнопка «Забрать диалог», действие «Передать оператору» в сценарии или ИИ-агент решил позвать человека), бот молчит: входящие сообщения видны в «Диалогах», но сценарий и ИИ-агент на них не отвечают. «Вернуть боту» возвращает диалог сценарию — со следующего сообщения он снова отвечает сам.

Если у подписчика уже шла «Задержка» сценария (например, серия напоминаний с паузами) и в этот момент диалог забрал оператор, пауза останавливается — оставшееся время не идёт, пока диалог у оператора — и досчитывается с того же остатка, как только оператор нажмёт «Вернуть боту». Таймер SLA ниже — другое: он часть самой передачи и тикает всё время, пока диалог у оператора, иначе не сработала бы эскалация.

Срок ответа оператора (SLA)

Чтобы обращение не зависло у оператора, после действия «Передать оператору» поставьте «Задержку» на срок ответа (например, 30 минут), а за ней блок «Действия», первым в котором — «Проверить срок ответа оператора (SLA)». Ниже в том же блоке — эскалация: метка, уведомление руководителю.

Эскалация срабатывает, только если оператор так и не написал в чат после передачи. Тогда уровень растёт на 1: переменные sla_breached = 1, sla_level = 1, 2, 3… и sla_at — время эскалации со смещением часового пояса. Если оператор ответил, диалог вернули боту или тот же таймер сработал повторно, sla_breached = 0, а остальные действия блока пропускаются. Следующий уровень — ещё одна «Задержка» и такой же блок; ветвиться можно «Условием» по {{var.sla_level}}. Новая передача диалога начинает отсчёт уровней заново.

В настройках действия можно задать максимальный уровень (0 — без ограничения): когда sla_level его достиг, следующие проверки дают sla_breached = 0 и эскалация больше не повторяется — до новой передачи оператору.

Уведомления о новых сообщениях

Число у пункта «Диалоги» — сколько разговоров ждут ответа: последнее сообщение в них от подписчика, а ни бот, ни вы после него не ответили (учитываются разговоры за последнюю неделю). Число гаснет само, когда разговор получил ответ.

Когда приходит новое сообщение, кабинет тихо звенит — не чаще раза в 10 секунд и только после того, как вы хоть раз кликнули на странице (так требуют браузеры). Выключить звук можно колокольчиком в заголовке «Диалогов» или в «Профиле → Настройки».

Рассылки

Массовые сообщения подписчикам — разово или по расписанию.

Прямая рассылка

Мастер ведёт через три шага. По шагам вверху можно переходить в любом порядке: заполненный шаг отмечается галочкой, шаг с ошибкой — восклицательным знаком. «Отправить» проверяет всё сразу и, если что-то не заполнено, откроет нужный шаг и подсветит поле.

  1. Аудитория: выберите ботов и, при необходимости, сузьте охват фильтром — теги (любой из / все из / кроме, с поиском по реальным тегам бота), условия по переменным (оператор зависит от типа — текст, число, дата, да/нет), дату подписки и последней активности, статус. Фильтр берётся для первого выбранного бота; если ботов несколько, у остальных теги и переменные могут называться иначе. «Посчитать аудиторию» показывает число получателей по текущему фильтру до отправки. В одну рассылку берутся боты одного владельца — квоту получателей и тариф считают по нему; по ботам, где вы соредактор, делайте отдельную рассылку.
  2. Сообщение: соберите до 5 блоков — текст, фото, видео, аудио, файл, голосовое, кружок, галерея, кнопки. У каждой кнопки-ссылки есть галочка «Считать клики» (у новых кнопок включена): ссылка уходит через короткий редирект retensy, и в аналитике бота видно, сколько человек нажали кнопку (CTR рассылки); клики считаются 90 дней с отправки. Снимите галочку — ссылка уйдёт как есть. Ссылки на Telegram (t.me, приглашения), VK (vk.me), MAX и другие мессенджеры не оборачиваются никогда, а кнопки рассылок, созданных до появления галочки, не меняются.
  3. Отправка: сразу или запланировать на конкретное время.

Сегменты, охват и тест себе

Сохранённые сегменты: на шаге «Аудитория» настройте фильтр, введите имя и нажмите «Сохранить» - сегмент появится в списке «Сохранённые сегменты». Выбор сегмента заменяет текущий фильтр его условиями; удалить сегмент можно кнопкой рядом со списком. Сегменты общие для всех ваших ботов (до 50), хранится именно фильтр, а не список людей: состав пересчитывается в момент отправки.

Оценка охвата: «Посчитать аудиторию» показывает, сколько человек получат рассылку по текущему фильтру, до отправки и без списания квоты. Потолок - 50 000 получателей на бота.

Тест себе: на шаге «Сообщение» кнопка «Отправить тест себе» шлёт эти блоки на ваш привязанный Telegram через первого выбранного бота. Чтобы тест дошёл, в профиле должен быть привязан Telegram и вы должны хотя бы раз нажать «Старт» у этого бота. Тест не тратит квоту, не попадает в очередь и не подчиняется тихим часам.

Через MCP: инструменты audience_segments, broadcast_preview {segmentId}, broadcast_send {segmentId, localTime}, broadcast_test и bot_delivery_window.

Тихие часы и «по времени подписчика»

Тихие часы - настройка бота (бот → «Настройки» → «Тихие часы рассылок», по умолчанию выключено). Укажите «с» и «до» (например, 22:00-09:00; окно может переходить через полночь) и пояс бота. Рассылка, которая попадает в окно, не отправляется в него: получатель ждёт конца окна и получает сообщение сразу после него. Окно считается по поясу подписчика, если он известен (переменная timezone или tz: Europe/Moscow, Asia/Yekaterinburg, UTC+3), иначе по поясу бота (по умолчанию Москва). Текущие рассылки без включённых тихих часов не меняются.

«Отправить в одно и то же время по часам каждого подписчика»: на шаге «Отправка» отметьте галочку и задайте время, например 10:00. Каждый получит рассылку в ближайшие 10:00 по своему поясу (для запланированной - не раньше выбранного момента); если пояс неизвестен, берётся пояс бота. Опция недоступна вместе с повтором и распределением по ботам. Если это время попало в тихие часы, отправка переносится на их конец.

Переход на летнее время учитывается: «10:00 по часам подписчика» остаётся 10:00 в его поясе, а время, которого нет в сутках перехода, сдвигается на ближайшее существующее.

Блок «Задержка»: в инспекторе у «Время отправки» → «В интервале» появился «Часовой пояс окна»: Москва (как раньше) или «Пояс подписчика (если известен)» - окно и дни недели считаются по переменной timezone подписчика, а без неё по Москве.

Список и карточка рассылки

Рассылки разложены по вкладкам «Черновики», «Запланированные» и «Отправленные». На карточке — статус, бот, аудитория, дата и доставка; остальные действия — в меню «⋮».

Клик по рассылке открывает её целиком: настройки (бот, аудитория, сообщения, время) и результат — сколько получателей, доставлено, ошибок и вне квоты, а также частые причины ошибок. Причины хранятся 30 дней. Пока рассылка отправляется, цифры обновляются сами.

Запланированную рассылку можно «Изменить»: после отправки из мастера она создастся заново, а исходная отменится.

Если к моменту отправки бот, через которого запланирована рассылка, остановлен, она не ждёт его включения — получает статус «Пропущена» с причиной и не уходит, даже если бот включили позже. Запланируйте рассылку заново, когда бот снова работает.

«Дублировать» и «Повторить рассылку» создают новый черновик «… (копия)» с той же аудиторией и сообщениями и сразу открывают его в мастере. Исходная рассылка не меняется, время отправки и статистика в копию не переносятся. Рассылку по сценарию так скопировать нельзя — её «Повторить» отправляет тот же сценарий заново.

Повторяющиеся рассылки

Во вкладке «Запланировать» задаётся повтор: каждый день, каждый месяц или каждый год. Первая отправка — в указанное время, дальше повтор идёт автоматически.

Правило повтора останавливается в списке рассылок в любой момент.

Правило отправляет только через ботов, которыми его владелец владеет или где он Admin. Если доступ к боту забрали или понизили роль, в следующих прогонах этот бот пропускается, остальные боты правила рассылку получают.

Если на момент прогона бот остановлен, этот прогон для него пропускается — правило не копит пропущенные отправки и не досылает их разом при включении бота обратно: следующий прогон по расписанию уйдёт как обычно.

Несколько ботов: один раз на человека и распределённый запуск

Эти две настройки появляются в мастере, как только выбрано больше одного бота (для разовой и для повторяющейся рассылки).

«Отправлять каждому человеку только один раз» определяет человека по ID его аккаунта в переписке с ботом (для Telegram и для MAX — свой численный id внутри каждой платформы), а не по имени или username: два разных человека с одним именем не схлопнутся, а вот один и тот же человек под двумя разными аккаунтами будет посчитан дважды — такое разделение ID по аккаунтам технически не устранить. Получает тот, кто первым по порядку выбранных ботов (как вы их расставили в списке, а не порядок фактического запуска) имеет действующую, не заблокировавшую бота переписку. Выключено — рассылка уходит каждому из своих ботов, как раньше.

«Распределить отправку по ботам» запускает ботов не разом, а по очереди: время старта первого бота, интервал между стартами следующих и порядок (как выбраны, или по размеру аудитории — сначала меньшие/большие). Интервал сдвигает только МОМЕНТ ЗАПУСКА каждого бота — сама отправка получателям одного уже запущенного бота идёт как обычно, с тем же лимитом Telegram ~30 сообщений в секунду.

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

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

После отправки появляется статус группы: какие боты (и какие их порции) уже запущены, у кого ошибка и сколько получателей ушло каждому. Группу можно поставить на паузу — новые запуски останавливаются, а уже запущенным ботам новые сообщения тоже не уходят (они продолжат рассылку сами, как только группу возобновить — сообщения, отправленные до паузы, не повторяются). «Отменить» снимает оставшиеся незапущенные боты/порции и отменяет уже запущенные ботов этой группы — как обычную отмену рассылки.

Квота получателей

Каждый получатель рассылки расходует месячную квоту тарифа. Рассылка «сразу» проверяет квоту при создании: если аудитория в остаток не помещается, рассылка не создастся.

Запланированная и повторяющаяся рассылка считает подписчиков в момент отправки. Если их больше, чем осталось в квоте, сообщение получат первые подписчики в пределах остатка, а в карточке рассылки появится «вне квоты N». Квота обновляется с началом нового оплаченного периода.

Пробный объём без подписки

Без активного тарифа рассылки и ответы ИИ не закрыты наглухо: каждый календарный месяц (по Москве) доступен небольшой пробный объём. По умолчанию это 2 рассылки в месяц, не более 100 получателей в каждой, и 30 ответов ИИ-агента в месяц. Считаются именно рассылки, а не получатели: рассылка на 100 человек и на 5 человек занимает одну из двух. Значения задаёт администратор сервиса, 0 отключает соответствующую пробу.

Остаток виден как «Пробно: осталось X из Y» на странице тарифа, в мастере рассылки и в настройках агента. Если аудитория рассылки больше потолка, «сразу» она не создастся; в запланированной и повторяющейся получат сообщение первые подписчики в пределах потолка. Рассылка, которая уже запущена, считается использованной, даже если её отменили.

ИИ-ответы пробного объёма идут через тот же бюджет ИИ, что и у тарифов, и ограничены ещё и потолком расходов на месяц. Пробный объём покрывает только ответы подписчикам (агент); помощник сборки, база знаний и блок «ИИ-ответ» по-прежнему требуют тариф. Когда пробный объём кончился, на тех же экранах появляется предложение выбрать тариф; новый месяц обнуляет счётчики.

Скорость и паузы

Бот отправляет рассылку не быстрее 30 сообщений в секунду — это лимит Telegram на одного бота. Несколько рассылок одного бота делят этот темп между собой: раньше начатая идёт первой.

Если Telegram всё же просит подождать, рассылка встаёт на паузу на указанное им время и продолжается без потерь: получатель, которому успели отправить часть сообщений, получит только оставшиеся. Пока идёт пауза, счётчик в списке рассылок не растёт. Ответы подписчикам, которые пишут боту прямо сейчас, на время паузы не задерживаются.

Если сервис перезапустился посреди отправки, рассылка досылается сама: получатель, на котором её прервали, вернётся в очередь в течение 15 минут и может получить рассылку повторно — целиком, вместе с уже доставленными сообщениями. Без повторов рассылка продолжается только после паузы по просьбе Telegram.

Публикации

Разовый пост от имени бота в канал или группу Telegram и MAX или на стену VK — без сценария и рассылки. А «Цепочки» умеют публиковать автоматически: источник (канал Telegram, стена VK, RSS-лента) → обработка → назначения.

Пост в канал Telegram или MAX

Раздел «Публикации» отправляет пост с текстом, фото, видео или файлом в канал или группу, куда ваш бот добавлен администратором. Выберите бота и канал из привязанных к нему — если канала нет в списке, добавьте бота в канал администратором.

Файл загружается через форму; тип (фото, видео или документ) определяется по самому файлу. Пост должен содержать текст или файл.

Лимиты длины текста: в Telegram — 4096 символов без файла и 1024 символа подписи к файлу, в MAX — 4000 символов.

Если бот не администратор канала или платформа отклонила отправку, пост не уйдёт — раздел покажет причину.

  1. Добавьте бота администратором в канал или группу.
  2. Откройте «Публикации», выберите платформу, бота и канал.
  3. Напишите текст, при необходимости прикрепите файл и нажмите «Опубликовать».

Публикация в VK

Подключите сообщество или свою страницу VK двумя способами: вставьте токен сообщества (Сообщество → Управление → Работа с API → Ключи доступа, права минимум «Стена», для фото — ещё «Фотографии») — кабинет проверяет его реальным запросом к VK перед сохранением; либо войдите через VK ID (останетесь в кабинете ретенси-ботов — после подтверждения на стороне VK вас вернёт сюда же, а не на другой сайт) и выберите сообщество или страницу из списка, которым вы администратор.

После подключения отправляйте текстовый пост на стену, можно с одной фотографией (JPEG, PNG) — видео и другие файлы к посту в VK пока не поддержаны.

Каждая отправленная публикация (в Telegram, MAX или VK) считается отдельно, даже если это один и тот же текст, отправленный по очереди в разные места.

Лимит публикаций по тарифу

Число публикаций в календарный месяц задаёт тариф: бесплатный — 10, «Старт» — 50, «Про» — 200, «Бизнес» — 1000, от «Максимума» — без ограничений. Счётчик общий на аккаунт (не на одного бота) и сбрасывается 1-го числа по московскому времени.

Раздел показывает «X из N публикаций в этом месяце»; при исчерпанном лимите новый пост не отправится — кабинет покажет ссылку на тарифы. Автоматические публикации из «Цепочек» считаются в том же лимите, что ручные.

Цепочки публикаций (автоматический репост)

«Цепочка» — правило «источник → обработка → назначения»: новые посты из источника публикуются в назначения автоматически, без ручного нажатия «Опубликовать» на каждый. Источник — один из трёх: канал Telegram, где ваш бот администратор (новые посты подхватываются сразу); подключённая стена VK (опрашивается раз в несколько минут); RSS/Atom-лента по ссылке (тоже опрашивается периодически). «Новым» считается элемент, который цепочка видит впервые — правки и повторные показы того же поста заново не публикуются.

Между источником и назначениями можно добавить шаги обработки, по порядку: фильтр (публиковать только если текст содержит/не содержит слова, есть медиа, текст не короче N символов, есть хэштег), правка текста (добавить текст в начало/конец, убрать ссылки, убрать хэштеги, заменить фрагмент), UTM-разметка ссылок (с настройками поверх по умолчанию: не дублировать уже стоящие utm-метки или заменять их, не трогать внутренние ссылки — t.me, vk.com), и, по желанию, адаптация текста через ИИ (лёгкая правка или полная переработка под площадку/тон — расходует тот же месячный бюджет ИИ, что ответы бота).

Назначения — Telegram-канал, MAX-группа или сообщество VK (столько, сколько нужно, с разными настройками UTM у каждого); у каждого назначения можно переопределить UTM-метки цепочки по умолчанию.

Защита от зацикливания: нельзя сохранить цепочку, которая вместе с другой вашей цепочкой образует прямой цикл (A публикует в B, а B публикует обратно в A) — кабинет откажет с понятной причиной. Во время работы публикация в назначение также пропускается, если это назначение совпадает с исходным источником того же поста.

Режим «На согласовании»: можно включить для всех публикаций цепочки или только для тех, что прошли через шаг адаптации ИИ — тогда готовый пост не публикуется сразу, а ждёт в очереди «На согласовании» с предпросмотром, где его можно одобрить, отклонить или поправить.

История выполнения цепочки показывает каждое задание (один элемент источника → одно назначение) и его состояние: ждёт, на согласовании, выполняется, готово, ошибка, пропущено — с причиной ошибки и кнопкой «Повторить». Временные ошибки (площадка недоступна) цепочка повторяет сама с нарастающей паузой; постоянные (бот не администратор, лимит тарифа исчерпан) — нет, нужно вмешаться вручную.

Цепочку можно в любой момент приостановить («Пауза») — тогда новые элементы источника перестают подхватываться, но история и настройки сохраняются, включить обратно можно в любой момент.

Простая форма подходит для линейной цепочки (один источник → общая обработка → список назначений). Для ветвящихся сценариев — несколько каналов одного типа сразу (например, 10 Telegram-каналов или 6 сообществ VK) или общий шаг (например, адаптация ИИ), применяемый к части назначений, а другой — к остальным — откройте «Схему» у цепочки: отдельная полноэкранная страница с холстом (как у конструктора сценариев бота). Источник там один и тот же (меняется в простой форме), а дальше — дерево: от источника и от любого шага обработки можно провести несколько ветвей к разным наборам назначений; клик по узлу на холсте открывает его настройки справа, кнопка «+ Назначение(я)» добавляет сразу несколько каналов/аккаунтов одного типа за один раз, выбранный узел подсвечивается красным, если схема содержит ошибку (узел не подключён к графу, цикл, назначение без пути от источника). Общий шаг адаптации ИИ, из которого идёт несколько назначений, считается и оплачивается один раз на пост, а не по разу на каждое назначение. Простая форма и схема правят один и тот же набор данных — старые (линейные) цепочки открываются в схеме как обычное дерево без ветвлений.

Начать можно не с нуля: галерея шаблонов предлагает готовые каркасы — «Telegram → VK», «VK → Telegram», «RSS → Telegram + VK» (с готовой UTM-разметкой) и «Telegram → VK + MAX с адаптацией ИИ» (с шагом адаптации и «На согласовании» для ИИ-постов). Выбор шаблона просто предзаполняет форму — источник и названия назначений ещё нужно указать (ваш канал, сообщество, аккаунт); при необходимости ветвления шаблон можно дальше развить в «Схеме».

  1. Откройте «Публикации» → «Цепочки» → «Создать цепочку» или выберите готовый шаблон.
  2. Выберите источник (Telegram-канал, стена VK или ссылка на RSS-ленту) и, по желанию, добавьте шаги обработки.
  3. Добавьте одно или несколько назначений и, если нужно, включите «На согласовании»; сохраните.
  4. Для ветвящейся настройки (много каналов одного типа, общий шаг ИИ на часть назначений) откройте «Схему» у сохранённой цепочки и донастройте там.
  5. Включите цепочку — новые посты источника начнут публиковаться автоматически.

Запись

Календари для онлайн-записи клиентов: рабочие часы, типы встреч, буферы и подтверждение — с публичной страницей-ссылкой или прямо в сценарии бота.

Мастер создания календаря

Раздел «Запись» → «Новый календарь» открывает мастер: выберите готовый шаблон («Индивидуальная консультация», «Услуга фиксированной длительности», «Несколько типов встреч», «Рабочие часы по графику») или начните с пустого календаря — все настройки шаблона можно изменить.

Мастер разбит на секции: «Основное» (название, описание, часовой пояс), «Расписание» (рабочие часы по дням недели визуальной сеткой с выбором времени, повторяющиеся перерывы вроде обеда, разовые исключения на конкретные даты), «Правила» (длительность слота или несколько типов встреч своей длительности, а в дополнительных настройках — буфер до/после брони, минимальный срок записи и горизонт записи вперёд), «Клиенты» (какие поля формы показывать клиенту — имя всегда обязательно, телефон/email/комментарий и свои поля — и подтверждать ли запись автоматически или вручную), «Публикация» (ссылка и включение публичной страницы). Та же разметка секций открывается при редактировании уже созданного календаря.

Справа от формы — живой предпросмотр: точно та же форма, которую увидит клиент, со свободными слотами по текущим настройкам, и список предупреждений (нет рабочих часов, перекрывающиеся перерывы, некорректные интервалы времени, часовой пояс календаря отличается от вашего, за две недели нет ни одного слота) с указанием, в какой секции искать проблему.

Публичная страница записи

На шаге «Публикация» укажите ссылку (слаг) и включите публичную страницу — она откроется по адресу /book/<ссылка> без входа в аккаунт: клиент выбирает тип встречи, дату и время, заполняет форму и сразу видит подтверждение. Ссылку и готовый код для вставки на сайт (iframe) можно скопировать там же.

Двойная бронь исключена: слот резервируется атомарно, и если двое одновременно выбрали одно и то же время, второй увидит «слот уже занят» и сможет выбрать другое. Запросы с публичной страницы ограничены по частоте с одного адреса — это защита от перебора слотов ботами, отдельно от обычной защиты от спама в самой форме.

Брони с публичной страницы попадают в тот же список записей календаря, что и брони через бота или вручную, и работают с теми же уведомлениями.

Запись внутри сценария бота

В блоке «Действия» есть действия «Показать свободные слоты» и «Записать на слот» — так подписчик бронирует прямо в переписке, без перехода на отдельную страницу. Отдельное действие «Отменить запись» освобождает слот. Если у календаря заданы типы встреч, в обоих действиях появляется выбор типа — слот подбирается под его длительность; тип можно не указывать, тогда действует длительность слота по умолчанию.

Подтверждение записи вручную

В секции «Клиенты» мастера переключите «Подтверждение записи» на «Вручную владельцем» — новая бронь любого источника (бот, публичная страница, вручную) сразу занимает слот, но попадает в статус «Ждёт подтверждения», пока вы её не решите.

В списке записей календаря включите фильтр «Только ждущие подтверждения», чтобы видеть только такие брони, и нажмите «Подтвердить» или «Отклонить» у каждой. Подтверждение снимает статус ожидания, отклонение отменяет бронь и освобождает слот. Если запись пришла из бота (есть чат, с которым разговаривал подписчик), клиенту в тот же чат уйдёт сообщение об исходе.

Рядом с переключателем подтверждения задаётся «Держать слот неподтверждённым, часов» (по умолчанию 24) — если вы не подтвердите и не отклоните бронь за это время, она отменяется сама, слот освобождается, а клиенту, если с ним есть бот-чат, приходит уведомление об истечении срока.

Уведомления о новых записях

Включите «Уведомлять меня о новых записях» в секции «Клиенты» — сообщение о каждой новой брони придёт в те же каналы, что и другие уведомления аккаунта (привязанный Telegram- или MAX-бот, либо почта), без дополнительной настройки.

Аналитика

Что реально происходит на сайтах, в ботах и рассылках — без вымышленных цифр: там, где данных нет, страница честно показывает «нет данных».

Обзор

Сводка событий по активным сценариям каждого бота: сколько прошло успешно и сколько с ошибкой, за последние 24 часа, 7 или 30 дней. Всплеск ошибок — сигнал заглянуть в сценарий.

Та же статистика есть прямо на холсте редактора: кнопка «Аналитика» в панели инструментов включает на каждом блоке значки «вошло» (сколько раз сюда входили за период) и «% дальше» (доля входов, после которых блок успешно пошёл дальше, а не упал в ошибку). Рядом с кнопкой появляется выбор периода — 24 часа, 7 или 30 дней; статистика на холсте обновляется под выбранный период без перезагрузки страницы.

Источники входов (UTM) — по каким меткам подписчики заходили в сценарии ваших ботов. Каждый источник раскрывается в разбивку по кампании, каналу и контенту.

Единый дашборд по объекту

Вверху раздела «Аналитика» — выбор объекта (сайт / бот / сценарий / рассылка) и периода (сегодня, 7, 30, 90 дней или свой диапазон дат), с галочкой «Сравнить с предыдущим периодом». Выбор сохраняется в адресе страницы — можно поделиться ссылкой или вернуться по «Назад».

Дальше — показатели (KPI) объекта, график по дням, источники трафика и UTM, воронка (только там, где шаги действительно связаны последовательно — иначе честно написано, что воронки нет) и детали: у сайта это сырые события с постраничной подгрузкой, у сценария — шаги с ошибками.

Сайт: просмотры страниц, клики по отслеживаемым целям, отправки форм, уникальные посетители и заявки; воронка «просмотр → клик по цели → отправка формы → заявка». Данные — из первого party-счётчика сайта (без куки по умолчанию), не из внешних пикселей.

Бот: новые подписчики, активность по дням и сколько всего заблокировали бота (дата регистрации учитывается только у сессий, созданных после обновления — у более старых подписчиков показывается отдельным числом «без даты регистрации», а не нулём или выдумкой).

Сценарий: число запусков по дням с разбивкой «успешно / с ошибкой», плюс список шагов сценария, которые чаще всего падают — так проще найти проблемный узел, чем листать логи прогонов.

Рассылка: получатели, отправлено, ошибки отправки (с самыми частыми причинами) и пропущенные квотой тарифа.

Бот — сообщения, клики и конверсии: входящие и исходящие сообщения по дням и по каналам (Telegram, MAX, VK, виджет на сайте), недоставленные, ответы операторов, уникальные клики по отслеживаемым ссылкам шагов и рассылок (первое нажатие человека на каждую кнопку — повторные нажатия и клики по пересланному сообщению не добавляются), конверсии (подписчик поделился контактом, оплатил через кассу бота, оставил заявку на сайте, которая запустила сценарий бота) и сумма оплат в рублях. С галочкой «Сравнить» у каждого показателя — изменение к предыдущему периоду такой же длины.

Бот — воронка: проявили активность за период → из них написали боту → из них кликнули ссылку → из них оставили контакт или оплатили. Считаются уникальные люди за период, каждый шаг — часть предыдущего. Сообщения из групп и каналов в воронку не входят, а служебные события (блокировка бота, реакции, правки, заявки на вступление) не считаются входящими. Рядом — таблица рассылок периода: получатели, доставлено, ошибки, сколько человек кликнули и CTR (кликнувшие от доставленных).

Эти счётчики собираются с обновления платформы в октябре 2026 и задним числом не досчитываются: до первого дня с данными страница прямо пишет, с какого числа идёт сбор. Доставка и ошибки рассылок видны и для старых рассылок, клики по ним — только для отправленных после обновления. Текст сообщений в аналитику не попадает — только счётчики; дневные итоги хранятся 400 дней, данные воронки — 190.

Цели на сайте (клики)

В редакторе сайта у кнопки или ссылки есть необязательное поле «Цель аналитики» (там же, где выбирается действие кнопки — ссылка, страница, попап и так далее). Если его заполнить, каждый клик попадёт в аналитику сайта отдельной строкой с этим названием — так видно, что именно нажимают посетители, а не только общее число кликов.

Страницы

Сайты из готовых блоков и Telegram Mini Apps из ваших файлов. Страница доступна по своей ссылке и на вашем домене и открывается из бота кнопкой «Mini App».

Сайт из блоков

При создании выберите «Сайт из блоков» — откроется редактор со стартовым сайтом: шапка, обложка, текст, преимущества, форма заявки и подвал. Блоки: шапка, обложка, текст, картинка, галерея, кнопки, преимущества, форма заявки, видео (YouTube, VK Видео, Rutube), HTML-код, отступ, подвал и Zero-блок со свободным холстом.

Слева — страницы и блоки текущей страницы: порядок, копия, удаление, «+ Добавить блок». По центру — предпросмотр; кликните по блоку, чтобы открыть его настройки справа. Шапка и подвал общие для всех страниц, на отдельной странице их можно скрыть.

Переключатель «Десктоп / Планшет / Телефон» сверху показывает сайт на нужной ширине. Колонки, выравнивание, высоту и отступы можно задать отдельно для каждого размера экрана; пока не задано — берётся значение с большего экрана. Блок можно скрыть на любом из размеров.

Во вкладке «Тема» — цвета, шрифты (с кириллицей), скругление и ширина колонки текста, а также счётчики аналитики: Яндекс.Метрика, GA4, Google Tag Manager, Meta Pixel и VK/top.mail.ru — укажите только id счётчика, код вставится сам при публикации. Форматы строгие (например GA4 — G-XXXXXXXXXX): неверный id сайт не сохранит.

Правки сохраняются сами, но на сайт попадают только после кнопки «Опубликовать». Если сайт открыт в двух окнах, второе предупредит, что сайт изменён, и не перезапишет чужие правки. Прошлые публикации видны в «Истории публикаций» — любую можно вернуть.

Картинки загружаются прямо в поле блока и считаются в хранилище тарифа. HTML-код выполняется только на опубликованном сайте; в предпросмотре кабинета он изолирован.

Что зависит от тарифа: HTML-блок и HTML-элемент Zero доступны на платных тарифах — на бесплатном сайт с ними не опубликуется, редактор покажет, какие блоки убрать. Сайты бесплатного тарифа на pages.retensy.com не индексируются поисковиками; на своём домене индексация работает всегда.

Число сайтов тоже задаёт тариф: на бесплатном — 1 сайт, на «Старте» — до 3, на «Про» — до 10, со «Бизнеса» — без ограничений (лимит общий для сайтов из блоков и Mini App из файлов). Когда лимит исчерпан, создать новый сайт не получится — кабинет покажет ссылку на смену тарифа; уже созданные сайты продолжают работать, а после удаления ненужного место освобождается.

Сайт, нарушающий правила сервиса, модерация может заблокировать. Тогда посетители на всех его адресах, включая свой домен, видят страницу «Сайт недоступен», формы и проверка Mini App не работают. В списке сайтов появится отметка «Заблокирован модерацией» с причиной, а вам придёт уведомление — если считаете блокировку ошибкой, напишите в поддержку. Заблокированный сайт нельзя удалить: он и его свой домен остаются за вами до решения поддержки.

Zero-блок: свободный холст

Zero-блок — холст, на котором элементы (текст, картинка, кнопка, фигура, видео, HTML-код) ставятся куда угодно. Добавьте блок «Zero-блок (свободный)» и нажмите «Открыть холст».

Элементы перетаскиваются мышкой и тянутся за углы; они прилипают к сетке (шаг задаётся сверху), к краям и центрам соседей и к центру холста — розовая линия показывает, к чему прилипло. Стрелки двигают выбранный элемент на 1 px (с Shift — на 10), Delete удаляет, Ctrl+D делает копию. Порядок наложения — в списке «Слои».

Холст свой для десктопа (1200 px), планшета (768) и телефона (375). Пока на планшете или телефоне элемент не трогали, он повторяет десктоп в масштабе; первое перемещение задаёт свой вариант, «как на большем экране» возвращает масштаб. Элемент можно скрыть на любом размере экрана. На опубликованном сайте холст сжимается под ширину окна, не вылезая за край.

HTML-элемент выполняется только на опубликованном сайте, на холсте он показан заглушкой. Анимаций пока нет.

Формы, попапы и заявки

Форма заявки — блок «Форма заявки» на странице или в попапе. Попап — окно поверх страницы: создайте его во вкладке «Страницы» → «+ Попап с формой» и откройте кнопкой с действием «Попап». После отправки форма показывает сообщение, переходит по ссылке или открывает другой попап.

Заявки принимаются только с опубликованного сайта. Все они видны во вкладке «Заявки» сайта, их можно выгрузить в CSV. Боты-спамеры отсекаются скрытым полем и слишком быстрой отправкой, а с одного адреса — не больше 5 заявок в минуту.

Куда отправлять заявки, выбирается там же: бот уведомлений из профиля, почта аккаунта, вебхук (POST JSON на ваш адрес), сценарий с запуском «Вебхук» (поля формы приходят по своим именам: {{body.name}}, {{body.phone}}) amoCRM (сделка «Заявка с сайта» с контактом) и «Интеграция» — любое ваше подключение с действиями (см. ниже). Если отправка не удалась, повторим ещё дважды; статус каждой отправки виден под заявкой.

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

Поле формы «Файл» принимает вложение (до 10 МБ, изображения/PDF/офисные документы/zip — автор формы может сузить этот список, но не расширить); исполняемые файлы, HTML и SVG не принимаются, даже если их переименовать. Вложения видны и скачиваются только вам во вкладке «Заявки» — посетителям и в CSV они не показываются.

Доставка заявки „Интеграция“

Кроме бота уведомлений, почты, вебхука, сценария и amoCRM, заявку можно отправить через любое ваше подключение из раздела «Интеграции», у сервиса которого есть действия. В настройках заявок сайта выберите подключение в поле «Интеграция», затем действие (если их несколько) и при желании заполните его поля.

В полях действия можно подставлять данные заявки: {{var.name}}, {{var.phone}}, {{var.email}}, {{var.<имя поля>}}, а текст заявки целиком — {{var.lead_text}}. Пустые поля заполнятся из заявки сами: название «Заявка с сайта», имя, телефон, почта и текст.

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

Аналитика сайта

Опубликованный сайт сам считает просмотры страниц, клики по кнопкам и ссылкам с меткой отслеживания и отправки форм — без cookie и без хранения чего-либо в браузере посетителя. Посетитель узнаётся сервером по суточному хэшу (IP и браузер меняются — хэш меняется на следующий день), сам IP не сохраняется. Заголовок браузера «Не отслеживать» (DNT) уважается: при нём событие не принимается вовсе.

Сводка по сайту (просмотры, клики, отправки форм, примерное число посетителей, топ страниц, источники перехода, UTM-метки и тренд по дням) доступна в API кабинета за выбранный период; подробности каждого события — отдельным постраничным списком.

Мини-лендинг с кнопками мессенджеров

Мини-лендинг — страница-визитка на один экран, как Taplink: аватар, имя, пара строк о себе и большие кнопки «Написать в Telegram» и «Написать в MAX». Ссылку на него ставят в шапку профиля, в рекламу и на визитки.

Кнопки собираются из ваших ботов при публикации: Telegram — t.me/бот, MAX — max.ru/бот. Переименовали бота — опубликуйте сайт ещё раз, и ссылки обновятся. Удалённый бот с сайта пропадает. WhatsApp и VK ботами не подключаются — добавьте их в «Свои ссылки» (например https://wa.me/79001234567).

Если список «Мессенджеры» в блоке пуст, на сайте будут все ваши активные боты: сначала Telegram, потом MAX. Добавьте ботов в список, чтобы выбрать конкретных, поменять порядок или текст кнопки.

Метка старта — код ссылки из раздела «Ссылки на бота» у бота. С ней переход идёт через нашу ссылку-мост: клик и старт засчитываются этой ссылке, а UTM-метки из адреса лендинга (utm_source и другие) доезжают до бота и доступны в сценарии.

Блок «Кнопки мессенджеров» можно поставить и на обычный сайт: библиотека блоков → «Соц.сети».

  1. «Сайты» → в поле шаблона выберите «Мини-лендинг: кнопки мессенджеров», введите название и нажмите «Создать сайт». То же открывает карточка «Мини-лендинг» в «Интеграциях».
  2. Кликните по блоку: загрузите аватар или логотип, поправьте имя и текст. Без аватара показывается круг с первой буквой имени.
  3. При желании выберите ботов, тексты кнопок, метку старта и добавьте свои ссылки; «Цвета кнопок» — фирменные цвета мессенджеров или цвет темы.
  4. Проверьте «Предпросмотр» на телефоне (переключатель сверху) и нажмите «Опубликовать» — ссылка на сайт появится в настройках.

Адрес страницы

У каждой страницы адрес вида pages.retensy.com/k3m9qd/nazvanie/: первая часть — постоянный код страницы, вторая — название. Название не обязано быть уникальным и меняется в настройках в любой момент: ссылки со старым названием перенаправляются на новое.

Если название не задать при создании, оно получится из заголовка латиницей («Каталог паков» → katalog-pakov).

Страницы, созданные раньше, сохранили и прежний адрес pages.retensy.com/название/ — он продолжает работать без перенаправления, поэтому кнопки Mini App в ботах и в BotFather менять не нужно.

Свой домен

Страницу можно открыть на своём домене — например shop.example.ru или example.ru. Сертификат HTTPS выпускаем сами, адрес на pages.retensy.com тоже продолжает работать. На странице — один домен; у корневого домена можно сразу подключить и www: он будет перенаправлять на основной.

Свой домен доступен на платных тарифах; сколько сайтов может иметь свой домен, задаёт тариф (www-пара отдельно не считается).

Если домен в Cloudflare, запись должна быть в режиме «DNS only» (серое облако): с оранжевым облаком трафик идёт через Cloudflare, и проверка не пройдёт.

Если домен уже подключён к другому аккаунту, подключить его можно только после подтверждения владения: мы покажем TXT-запись, которую нужно добавить у регистратора.

  1. Откройте страницу → «Настройки» → «Свой домен», введите домен и нажмите «Подключить».
  2. У регистратора домена добавьте A-запись, которую покажет кабинет: на наш IP (имя @ для корневого домена или поддомен, например shop). Для www и поддоменов можно вместо A поставить CNAME на наш хост pages.retensy.com. Корню CNAME по стандарту DNS нельзя: там A на IP либо ALIAS/ANAME на pages.retensy.com, если DNS-хостинг это умеет (Cloudflare: CNAME flattening, режим DNS only). AAAA-записи для этого имени удалите.
  3. Подождите: обновление DNS занимает от нескольких минут до нескольких часов. Статус обновляется сам — «Ждём DNS», затем «Выпускаем сертификат», затем «Работает». Если ждать не хочется, нажмите «Проверить сейчас».
  4. Если за 3 суток DNS так и не указал на нас, проверка останавливается — поправьте запись и нажмите «Проверить сейчас».

MCP-токены

Управление ботами и сценариями из внешних инструментов — для тех, кто автоматизирует сборку.

Внешнее управление

Персональные токены (раздел «MCP») дают доступ к вашим ботам, сценариям и интеграциям снаружи — через retensy-mcp. Так сценарии можно собирать и править программно, из AI-инструментов, а подключения amoCRM, Битрикс24, GetCourse и других сервисов — создавать, обновлять и проверять без захода в кабинет.

Токен действует от вашего имени без второго фактора (2FA) — храните его как пароль и сразу отзывайте в разделе «MCP», если он утёк. Срок действия можно задать при создании (30, 90 или 365 дней) или оставить бессрочным. Управлять аккаунтом токен не может: выпускать новые токены, менять 2FA и профиль, передавать бота другому владельцу можно только из кабинета. Сохранённые пароли и ключи интеграций токен тоже не покажет — наружу идёт только маскированная подсказка, как и в кабинете.

Права токена

При создании токена выберите, что он может: «Только чтение», «Полный доступ» или свой набор прав. Права проверяет сервер на каждом запросе, а не MCP-клиент, поэтому прямой вызов API их тоже не обходит. Но права крупные — выдавайте токену только то, что нужно для задачи.

Права: «Чтение» (read) — смотреть ботов, сценарии, сайты, аналитику, делать превью и тестовые прогоны; это и персональные данные: подписчики, переписка в диалогах, заявки с сайтов и их файлы. «Боты и сценарии» (write:bots) — создавать и менять ботов, сценарии, цепочки, интеграции, ИИ-агентов, базу знаний и черновики рассылок; правка опубликованного сценария сразу меняет ответы бота подписчикам, можно сменить ключи и вебхуки интеграций, тестовый чат ИИ-агента тратит ИИ-бюджет. «Сайты» (write:sites) — сайты, VK-лендинги, статусы лидов. «Аудитория» (crm) — теги и переменные подписчиков, импорт подписчиков, передача диалога оператору, записи; подтверждение или отклонение записи отправляет клиенту сообщение. «Рассылки и сообщения» (broadcast) — отправка рассылок, ответы в диалогах, посты в каналы и VK, а также включение цепочки публикаций без согласования постов и публикация сценария с запуском по расписанию, с отправкой в заданный чат, канал или на заданный e-mail (не {{var.email}} подписчика), или вебхук-сценария с получателем из тела запроса или с отправкой писем — они сами отправляют сообщения; «Оплата» (billing) — покупка ИИ-пакетов, пополнение, подписка, выпуск API-ключей ИИ-агентов; «Удаление и выгрузка» (destructive) — любое удаление и выгрузка баз подписчиков и лидов в файл.

Если токену не хватает права, запрос отклоняется с ошибкой 403, где названо недостающее право, а агент увидит сообщение «токену не хватает права …». Такие отказы записываются в журнал безопасности аккаунта.

Права можно поменять кнопкой «Изменить права» в списке токенов — изменение действует со следующего запроса, переподключать клиента не нужно. Токены, выпущенные до появления прав, помечены «полный доступ (старый токен)» и работают как раньше; ограничьте им права или выпустите новый токен с нужным набором. Истёкший токен не ротируется — выпустите новый.

Как подключить MCP и собрать бота через ИИ

В разделе «MCP» (Мой аккаунт → MCP) наверху — пошаговый урок: создать токен, подключить клиента (Claude Desktop, Claude Code, Cursor и другие — у каждого своя вкладка с готовым конфигом или командой), проверить подключение и забрать готовые промпты для типовых задач.

Проверка подключения — одна фраза агенту: «покажи моих ботов». Если он вызвал инструмент и показал список (пустой список без ошибки — тоже нормально, если ботов ещё нет), подключение работает.

Готовые промпты в уроке: собрать воронку с нуля, сделать рассылку по сегменту с дедупом, собрать цепочку публикаций Telegram → VK, настроить запись на консультацию, разобрать аналитику воронки — их можно скопировать и отправить агенту как есть, подставив свои названия.

Если что-то не подключилось — в уроке есть раздел «Если не получилось»: ошибка 401 (токен не создан/отозван/не в конфиге), отсутствующий npx (нужен Node.js 18+) и типичная проблема Windows с путём к npx в конфиге.

Тарифы и оплата

Бесплатный тариф — навсегда. Платные снимают лимиты.

Что входит в тариф

Тариф задаёт лимиты: число ботов, подписчиков, рассылок и соредакторов, месячный бюджет ИИ в токенах, объём хранилища. На карточке тарифа честно показано и то, что входит, и то, чего в нём нет.

Бюджет ИИ считается в токенах — это расчётные единицы модели, не рубли и не символы текста напрямую: токен ответа стоит в несколько раз дороже токена запроса, поэтому длинные ответы расходуют бюджет быстрее. Токены тратятся и на блок «AI-агент» в сценарии, и на ИИ-помощника на холсте (кнопка «AI», который собирает и правит сценарий по вашему описанию) — бюджет на месяц у них общий. Под шкалой бюджета в разделе «Тариф» видно, сколько токенов в среднем уходит на один ответ ИИ — за последние 30 дней (пока ответов меньше десяти, показан типичный ответ (~2 тыс. токенов), это помечено), — и на сколько ответов хватит остатка. Это оценка по вашим же ответам, а не лимит: длинные промпты и ответы расходуют больше.

Когда бюджет ИИ на месяц заканчивается, сценарий не падает. В простом режиме блок «AI-агент» отправляет подписчику запасной текст, если он задан в настройках блока, — а если не задан, просто ничего не отправляет; в обоих случаях сценарий идёт дальше по обычному выходу, и если у блока настроено сохранение ответа в переменную, в этот раз она не обновится — останется прежнее значение. В режиме агента исчерпание работает иначе: у блока нет обычного выхода, поэтому он уходит в свою ветку «Бюджет ИИ исчерпан» (если она подключена) либо в ветку «Ошибка»; запасной текст, если задан, тоже отправляется. ИИ-помощник на холсте в этот момент ответит, что бюджет исчерпан, и предложит повысить тариф или дождаться следующего месяца.

Когда израсходовано 80 % месячного бюджета ИИ и когда ИИ останавливается из-за исчерпания бюджета, мы присылаем уведомление — туда же, куда предупреждения о конце тарифа: в бот для уведомлений (если он подключён в профиле) и на почту. Уведомление о 80 % приходит не чаще раза в месяц, а об остановке ИИ — не чаще раза в день, пока ИИ стоит: в первый раз за день, когда он не смог ответить.

Бесплатный тариф работает без срока с базовыми лимитами — попробовать конструктор можно, ничего не оплачивая.

Тариф ограничивает не только ботов и подписчиков: на каждом тарифе своё число сценариев, свой предел блоков в одном сценарии и своё количество переменных — общих и на сценарий. Состав показан на карточке тарифа.

Сколько сценариев занято, считается по сценариям вашего аккаунта: созданным вами, созданным соредакторами на ваших ботах и скопированным в ваших ботов. Снимок, который появляется при публикации, место не занимает, а вебхук-сценарий занимает всегда — и включённый, и привязанный к боту.

Если блоков в сценарии больше, чем даёт тариф, публикация не пройдёт и честно скажет, сколько блоков лишние; черновик при этом сохраняется, ничего не теряется. Правка активного сценария сверх лимита не сохранится — бот продолжит работать на прежней версии.

Пакеты ответов ИИ

Когда месячного бюджета ИИ не хватает, его можно разово докупить пакетом ответов — поверх тарифа, без смены тарифа. Три размера — 490, 1990 и 6990 ₽ — показаны в токенах (та же единица, что у шкалы бюджета), под каждым размером написано, на сколько ответов его хватит примерно.

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

Остаток пакетов виден в разделе «Тариф» (прямо под шкалой бюджета ИИ) и в настройках ИИ-агента (блок «Лимиты») — в токенах и в примерном числе ответов. Там же кнопка «Докупить пакет» открывает выбор размера пакета, не уходя на другую страницу; оплата — тем же способом, что и тариф, деньги зачисляются сразу после подтверждения оплаты.

Периоды и оплата

Тариф покупается на месяц, на 3 месяца или на год. Чем длиннее период, тем ниже цена за месяц — точный процент выгоды показан на карточке тарифа.

Автопродление списывает деньги с баланса аккаунта. Доступна ли сейчас привязка карты, показывает плашка в разделе «Тариф»: если нет — тариф без денег на балансе сам не продлится, оплатите его вручную.

Тариф продлевается автоматически с баланса, если включено автопродление и на балансе хватает средств — переключатель находится в разделе «Тариф». Пополнить баланс можно в профиле кнопкой «Пополнить»: от 100 до 300 000 ₽ за раз через СБП, карту, SberPay или ЮMoney. Деньги зачисляются, как только ЮKassa подтвердит оплату, обычно в течение минуты, — на почту придёт чек. Оплатите тариф сразу на 3 месяца или год, чтобы не возвращаться к оплате каждый месяц.

Когда тариф подходит к концу, мы предупреждаем за 7, 3 и 1 день до окончания и в день, когда он заканчивается. Каждое предупреждение называет точную дату, а не «через неделю» — на границе периода такая формулировка была бы неверна.

Предупреждения уходят сразу во все доступные каналы: в бота, если вы подключили его в профиле, и на почту, указанную в профиле. Если не подключены ни бот, ни почта, предупредить вас нечем — а у аккаунтов, заведённых через соцсеть, почты часто нет вовсе.

Если тариф закончился и не продлился — автопродление выключено или на балансе не хватило денег, — начинают действовать лимиты бесплатного тарифа: боты сверх его лимита приостанавливаются, данные сохраняются. Мы напомним об этом в течение суток после окончания, через 3 и через 7 дней. После оплаты приостановленного бота включите на его странице кнопкой «Включить обратно».

Если оплату тарифа вернули полностью, оплаченный ею период снимается; если оплаченного времени не осталось, сразу начинают действовать лимиты бесплатного тарифа.

Если платёж не прошёл

Мы сохраняем причину, по которой банк или ЮKassa отменили платёж, и показываем её понятными словами: не хватило денег на карте, не подтвердили 3-D Secure, вышло время на оплату, срок карты истёк, банк отклонил операцию без объяснения. Если оплата сорвалась, повторите её другой картой или напишите в поддержку — причина будет у нас перед глазами.

Автосписание прекращается само, если платёжный способ окончательно непригоден: вы отозвали разрешение в банке, карта просрочена или заблокирована. В этом случае мы отвязываем карту и просим привязать её заново; временные причины вроде нехватки денег карту не отвязывают, следующая попытка пройдёт в обычный срок.

Как отключить автопродление

Раздел «Тариф» → блок «Автопродление» → красная кнопка «Отключить автопродление». После подтверждения деньги больше списываться не будут, а доступ сохранится до даты окончания, которая указана под статусом. Включить обратно можно там же.

Кнопка «Отвязать карту» работает отдельно: она только удаляет сохранённую карту. Если автопродление включено, а карту отвязали, оно просто не сможет списать деньги, поэтому для остановки списаний нажимайте именно «Отключить автопродление».

Как подключить бота для уведомлений

Раздел «Уведомления» в профиле виден, только если хотя бы один бот для уведомлений настроен на сервере.

  1. В профиле, в разделе «Уведомления», нажмите «Подключить» напротив Telegram или MAX.
  2. Откроется ссылка на бота — она одноразовая и действует 15 минут.
  3. Перейдите по ссылке и нажмите в боте «Начать» — бот подключён.

Напоминания о незавершённой настройке

Если вы зарегистрировались, но не создали бота, или бот создан, а сценарий не опубликован, мы напомним об этом: первый раз примерно через час, второй через сутки. Каждое напоминание приходит один раз, а не по кругу: после того как вы создали бота или опубликовали сценарий, напоминаний нет.

Напоминание уходит туда же, куда и остальные уведомления: в подключённый Telegram или MAX и на почту. Ночью, с 22:00 до 9:00 по Москве, мы не пишем, письмо придёт утром. В каждом сообщении есть ссылка «Не хотите получать такие напоминания», после неё мы больше не напомним о настройке. Письма о платежах и важных изменениях аккаунта продолжают приходить.

Наши новостные каналы

Когда бот подключён, под ним появляется кнопка нашего канала в том же мессенджере: Telegram-канал — если подключён Telegram, канал в MAX — если подключён MAX, обе — если оба. Подпишитесь, чтобы следить за новостями, обновлениями и обучающими видео. Те же кнопки есть в начале справки и в подвале сайта.

Партнёрская программа

Партнёр зарабатывает двумя независимыми способами: оплатой за свою работу клиентам (перенос бота, новый бот, сайт, доработка) и комиссией за подписку клиентов, которых он привёл по своей ссылке. Раздел «Партнёрам» в боковом меню открывает кабинет /partner.

Как стать партнёром

В разделе «Партнёрам» (/partner) или с публичной страницы /partners — кнопка «Стать партнёром». Достаточно принять короткие условия программы: статус сразу становится «Активен», открываются партнёрская ссылка, никнейм и статистика начислений. Если включена ручная проверка партнёров, ссылка откроется после одобрения администратором.

Обучение — 5 коротких уроков и итоговый тест (около 20 минут) — рекомендовано, но не обязательно. Прогресс сохраняется на сервере, можно продолжить с того же урока. Каждый урок открывается после предыдущего, тест — после всех пяти; правильные ответы хранятся на сервере и не приходят в кабинет заранее. После сдачи теста обучение отмечается пройденным, а напоминание в кабинете исчезает. Если у вас уже был партнёрский статус до запуска обучения, вы считаетесь активным партнёром.

Партнёрская ссылка и никнейм

Ссылка `https://botesy.ru/?ref=<ваш_код>` доступна сразу — это тот же реферальный код, что и в разделе «Рефералы». Заняв свободный никнейм (3–30 символов, латиница и цифры, без двух дефисов подряд), партнёр получает короткую ссылку вида `https://<никнейм>.botesy.ru`.

Переход по любой из двух ссылок привязывает нового посетителя к партнёру на 30 дней (по последнему переходу); окончательная привязка происходит при регистрации и действует для аккаунта один раз.

Два источника дохода — не путать

Оплата за работу — партнёр сам договаривается с клиентом о цене, Retensy в этих расчётах не участвует и не гарантирует их.

Комиссия за подписку — начисляется только если клиент зарегистрировался по партнёрской ссылке и только с его подтверждённых оплат тарифа. Выполненный заказ сам по себе не делает клиента привлечённым, если он зарегистрировался не по ссылке партнёра.

Начисление проходит через статусы: ожидает подтверждения → доступно к выплате → выплачено (отметку о выплате ставит администратор вручную — сама выплата происходит вне системы). Возврат платежа клиента отменяет ещё не выплаченное начисление.

Работа в проекте клиента

Доступ к боту или сайту клиента партнёр получает только по приглашению клиента (на тарифе клиента от «Старт» — на бесплатном тарифе соредакторов нет), с ролью «Смотреть», «Править» или «Админ». Пароли и секретные ключи клиента партнёру не нужны и не запрашиваются.

Тот же персональный MCP-токен, который партнёр создал для себя один раз, работает со всеми проектами, куда его пригласили — список ботов и сайтов через MCP показывает и свои, и чужие (с именем владельца), а право на каждый конкретный проект проверяется заново при любом обращении. Если клиент отзовёт приглашение, доступ к его проекту пропадает немедленно.

«Получить первого клиента»

Раздел /partner/clients помогает новому партнёру: короткий опрос подсказывает подходящий тип услуги (перенос бота, новый бот, сайт, доработка), а конструктор собирает текст предложения клиенту (объём работ, что не входит, цена, срок, критерии приёмки).

Материалы для поиска клиентов построены на честных способах — личный ответ на реальный запрос в профильных чатах, биржах фриланса, сообществах предпринимателей; массовые рассылки и выдуманные примеры работ запрещены правилами программы.

Какие данные собирает кабинет

Кратко о том, что мы записываем о работе в кабинете. Сторонние трекеры в кабинете не используются: события приходят только на наш сервер.

Аналитика использования кабинета

Чтобы понимать, где пользователи застревают и какие функции помогают, кабинет записывает технические события: открытие разделов (маршрут без идентификаторов), шаги обучающего тура, добавление блоков в редактор, запуск теста и публикацию сценария (с кодами ошибок проверки), создание ИИ-агента и загрузку в базу знаний, шаги мастера рассылки, показ тарифных подсказок и окна оплаты, открытие меню «Помощь», а также сообщения об ошибках JavaScript (обрезанные, без адресов электронной почты, токенов и длинных чисел). Раз в минуту при открытой вкладке записывается сигнал активности.

К каждому событию привязаны: внутренний идентификатор аккаунта, случайный идентификатор вкладки (не связан с cookie входа), тип устройства (телефон, планшет или компьютер), семейство браузера и операционной системы, язык интерфейса и время. Строка User-Agent целиком, IP-адрес, имена, e-mail, тексты сообщений, содержимое сценариев и подписчиков в события не попадают.

События хранятся 400 дней и затем удаляются автоматически. Они используются только в сводной аналитике для команды сервиса и не передаются третьим лицам. События администраторов сервиса не записываются.

Аналитика ваших сайтов и ботов

Отдельно от аналитики кабинета работает статистика опубликованных сайтов (просмотры, клики, отправки форм, без cookie) и статистика ботов (подписчики, активность). Это данные ваших проектов: они доступны вам в разделе «Аналитика» и не смешиваются с аналитикой кабинета.

Поддержка

Если что-то не получается или не хватает возможности — напишите нам прямо из кабинета.

Как написать в поддержку

Кнопка «Поддержка» — внизу бокового меню, на телефоне — в меню «Ещё». Откроется чат: на компьютере — панелью справа, на телефоне — на весь экран. Напишите вопрос, ответ придёт туда же.

Если включена первая линия ИИ-помощника, на новый вопрос сначала отвечает он — по документации продукта, сообщения подписаны «ИИ-помощник». Он честно говорит «не нашёл», если ответа в документации нет, и никогда не придумывает факты про ваш аккаунт. Кнопка «Позвать человека» в любой момент передаёт обращение живому менеджеру — дальше отвечает уже он.

Ответ не потеряется, даже если чат сейчас не открыт: на кнопке появится счётчик непрочитанных, а если в профиле подключён Telegram-бот уведомлений — придёт сообщение в Telegram со ссылкой на чат (так уведомляют только ответы менеджера). В Telegram по одному обращению уведомление приходит не чаще раза в 15 минут — счётчик на кнопке при этом обновляется всегда.

Пишите текстом: вложения в чат поддержки пока не принимаются. Если нужен скриншот — опишите словами, что видите на экране.

Обращения

Переписка делится на обращения. Кнопка «Новый вопрос» закрывает текущее. Менеджер тоже закрывает обращение, когда вопрос решён, а если в обращении сутки нет сообщений, оно закрывается само.

Закрытое обращение остаётся видно, пока вы не напишете снова: следующее сообщение откроет новое обращение, и чат начнётся заново.

Предложить идею

В меню «Помощь» (внизу бокового меню, на телефоне — в меню «Ещё») — пункт «Предложить идею»: для идей и пожеланий, какой функции не хватает, что неудобно. Там же, в одном меню, ещё два пункта: «Поддержка» и «Документация», так что всё, что связано с вопросами и просьбами, собрано в одном месте. Идеи читает команда продукта. Если понадобится уточнить, менеджер напишет вам в чат поддержки.

Подписка на канал

Внизу раскрытого бокового меню — блок «Подпишитесь на наш канал» с кнопками Telegram и MAX. Если мессенджер ещё не привязан, кнопка открывает персональную одноразовую ссылку на наш бот уведомлений — ту же, что и в разделе «Уведомления» в профиле: после /start бот привязывает аккаунт (сюда же потом приходят уведомления об окончании тарифа) и сразу предлагает подписаться на канал кнопкой в сообщении.

Если мессенджер уже привязан, кнопка ведёт прямо в канал. Крестик скрывает блок навсегда — это сохраняется в профиле, а не только в этом браузере.

ретенси-боты
Конструктор ботовИнтеграцииСправкаВойтиMCP на GitHub

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

TelegramMAX
Шаблоны ботовБот для салона красотыБот для клиникиБот для интернет-магазинаИнтеграцииTelegram и amoCRMTelegram и ЮKassaБлог
Конструктор ботовБоты для TelegramКонструктор сайтовMCP для ИИ-агентовИИ-консультантАвтоматизацииАвтоматизация InstagramПубликацииTelegram + VKVKTelegramРассылки в Telegram и MAXАвтоворонка в TelegramБот для записи клиентовБот для магазинаБот для MAXЗамена другого конструктораПартнёрская программа
ОфертаПользовательское соглашениеПолитика конфиденциальностиСогласие на обработку ПДВозвратАвтосписание

© 2026 ретенси-боты · ИП Зайцев Илья Николаевич · ИНН 732817877506 · ОГРНИП 325730000078525

Названия и логотипы Telegram, MAX, amoCRM, Битрикс24, GetCourse, Google, Яндекс, ЮKassa, Claude, OpenAI, Cursor и Tilda принадлежат их правообладателям и приведены для обозначения совместимости.

Сервис использует YouTube API Services. Используя публикацию на YouTube, вы соглашаетесь с Условиями использования YouTube и Политикой конфиденциальности Google; подробнее — в Политике конфиденциальности.