Полное руководство пользователя Krypella

Платформа Krypella+ работает прямо в браузере, вам не нужно скачивать ничего из магазинов приложений (App Store или Google Play). Вы можете вынести иконку нашего сервиса прямо на рабочий стол своего телефона или компьютера, и она будет работать как полноценная программа.

💻 На Компьютере: Если вы зайдете с ПК через браузер Chrome, в адресной строке (там, где пишется название сайта www...) справа появится значок монитора со стрелочкой. Нажмите на него, чтобы установить Krypella на компьютер.

Тариф Free (Бесплатный) — Для старта

• Количество ботов: Вы можете создать только 1 бота. Если вы попытаетесь добавить второго (ввести новый токен от BotFather), система выдаст красную табличку: «Лимит достигнут. Перейдите на тариф Plus».
• Размер бота: На холсте можно поставить не больше 40 блоков (квадратиков логики). Если не хватает — можно докупить дополнительные блоки прямо в панели (2 рубля за 1 штуку).
• Реклама: Внизу сообщений вашего бота может автоматически приписываться наша маленькая рекламная ссылка.

Тариф Plus (Снятие всех ограничений)

Если вы делаете серьезный проект, вам нужен тариф Plus. Что он дает:

• Бесконечные боты: Создавайте 5, 10, 20 разных ботов на одном аккаунте.
• Бесконечный холст: Лимит в 40 блоков снимается. Делайте огромные лабиринты логики.
• Никакой усталости: Энергия больше не тратится. Конструируйте часами без остановок.
• Чистота: Никакой рекламы Krypella в ваших ботах.
• Доступ к разделу Аналитика: Вы сможете видеть красивые графики: сколько людей зашло сегодня, сколько кнопок нажали и т.д.

Чтобы управлять ботом через нашу платформу, его сначала нужно "родить" в самом Telegram. Этим занимается главный бот телеграма — @BotFather (Отец ботов).

1. Откройте приложение Telegram и в поиске введите @BotFather (у него должна быть синяя галочка). Запустите его кнопкой Start.
2. Отправьте ему команду /newbot (создать нового бота).
3. Он спросит Имя бота (то, что будет написано сверху чата). Напишите любое, например: Мой Супер Магазин.
4. Затем он спросит Username (никнейм, по которому бота будут находить в поиске, всегда начинается с @). Обязательное условие: никнейм должен заканчиваться на слово bot. Пример: mysuper_shop_bot.
5. Если никнейм не занят кем-то другим, BotFather пришлет вам длинное сообщение с поздравлениями.
6. В этом сообщении будет красная строчка из цифр и букв, похожая на это: 1234567890:ABCdefGhIJKlmNoPqRStUvWxYz. Это и есть ваш ТОКЕН.
7. Скопируйте этот токен, вернитесь на главную страницу Krypella, нажмите зеленую кнопку с плюсом + Новый бот и вставьте токен в специальное поле.

Всё! Теперь ваш бот подключен к нашей панели, и вы можете заходить в конструктор.

Зайдите в настройки бота, раздел «Команда». Там есть кнопка Добавить админа. Перед вами появится окно с галочками (Права доступа):

Как передать доступ: Выберите нужные галочки и нажмите большую желтую кнопку «Создать код». Система выдаст вам секретный код. Отправьте его своему партнеру. Он должен зайти в свой личный кабинет Krypella и ввести его. После этого ваш бот появится у него в списке, но с припиской GUEST (Гость).

Оформление текста (Иконки над полем ввода)

• Кнопка "B" (Жирный): Сделает текст толще, чтобы выделить важное.
• Кнопка "/" (Курсив): Сделает текст наклонным.
• Кнопка "Перечеркнутый глаз" (Спойлер): Очень крутая фишка Telegram. Выделенный текст скроется за красивым "мерцающим блюром". Чтобы прочитать текст, клиент должен будет тапнуть по нему пальцем. Удобно для сокрытия ответов на загадки или секретных промокодов!
• Кнопка "Два квадратика" (Копирование): Текст превратится в моноширинный код. Главная особенность: если клиент нажмет на такое слово, оно моментально скопируется ему в буфер обмена телефона! Идеально для выдачи номеров карт, кошельков или сложных паролей.

Конструктор кнопок

Внизу блока можно добавлять кнопки. У каждой кнопки есть 3 важные настройки:

1. Название: То, что написано на самой кнопке (можно использовать смайлики).
2. Где кнопка появится? (Выпадающий список)
   • In-line — прозрачные кнопки, которые "прилипают" прямо под сообщением (как в опросах).
   • Reply — огромные кнопки, которые появляются в самом низу экрана телефона, заменяя клавиатуру с буквами.
   • Ссылка — если нажать, откроется браузер или другой Telegram-канал.
3. Цвет кнопки (Только для In-line кнопок!): Вы можете выбрать цвет из выпадающего меню с кружочками:
   • 🔘 Обычная (серая/прозрачная)
   • 🔵 Синяя
   • 🟢 Зеленая
   • 🔴 Красная

Магия отправки (Переключатели в самом низу)

• Удалять сообщение при переходе: Если включить этот тумблер, то как только клиент нажмет на In-line кнопку под сообщением, бот удалит это старое сообщение из истории чата! Это нужно, чтобы чат оставался чистым и не засорялся десятками старых менюшек.
• Изменить предыдущее сообщение: Работает еще круче. Бот не присылает новое сообщение, а берет старое и редактирует его (меняет картинку, текст и сами кнопки). Таким образом, меню стоит на одном месте и никуда не уползает вверх!

Встроенные переменные (Системные)

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

• {{name}} — Имя человека (как он записан в профиле Телеграма).
• {{username}} — Его никнейм (например: @ivan).
• {{id}} — Уникальный системный номер человека.

Пример использования: Напишите в тексте Привет, {{name}}! Твой номер: {{id}}.

Свои переменные (Например: Деньги)

Вы можете зайти в левом меню платформы в раздел "Переменные" и нажать синий плюс. Создайте переменную с именем coin (монеты). Значение по умолчанию поставьте 0. Тип переменной выберите Local (чтобы монеты были у каждого пользователя свои, а не одни на всех).

Блок «Настройки» (Математика)

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

1. Добавьте блок на холст. Выберите математический блок.
2. Переменная А (что меняем): Выбираем из списка нашу переменную {{coin}}.
3. Знак: Выбираем математическое действие. Например, + (Плюс). Доступны также -, *, /.
4. Тип второго значения: Тут есть выбор из выпадающего списка:
   • Число (ввести вручную): Вы просто печатаете на клавиатуре цифру, например 100.
   • Переменная (значение): Бот возьмет число из другой переменной. (Например, клиент написал сумму в переменную {{popolnenie}}, и вы выбираете её).
5. Сохранить результат в: Выбираем ту же самую переменную {{coin}}.

Что произошло? Бот взял старое количество монет клиента, прибавил к ним 100, и положил обратно в кошелек клиента. Магия!

В настройках блока есть огромное выпадающее меню «Что проверяем?». Разберем все пункты:

Категория: Сообщение пользователя

Эти проверки работают, когда бот ждет, чтобы клиент написал ему текст в чат:

• Сообщение — число?: Жесткий фильтр. Бот проверит, написал ли человек только цифры (например, "15" или "500"). Если человек напишет "Привет" или "Пять", бот пустит его по красной стрелке отказа. Идеально для запроса возраста или суммы перевода.
• Сообщение совпадает: Проверка на точное слово. Например, слово "Пароль". Причем боту не важен регистр букв: если клиент напишет "ПАРОЛЬ" или "пароль", бот всё равно засчитает правильный ответ.
• Сообщение содержит: Поиск ключевых слов в огромном тексте. В нижнем поле «Какие слова искать?» напишите нужные слова через запятую (например: жалоба, проблема, не работает). Если клиент напишет "У меня проблема с оплатой", бот увидит слово "проблема" и сработает по зеленой стрелке!

Категория: Прочее

• Наличие тега: Проверяет, висит ли на клиенте определенный ярлык (например, тег VIP).
• Подписка на канал: Самая мощная функция! Выберите из списка ваш Telegram-канал (бота нужно предварительно сделать администратором в вашем канале). Бот зайдет в канал и проверит, подписан ли этот конкретный человек. Если подписан — дает доступ, если нет — отправляет сообщение "Сначала подпишись!".

В меню «Действие» вы можете выбрать:

• Ввод переменной (Тихий): Самая важная функция для создания анкет. Как только логика доходит до этого блока, бот замирает. Он ничего не пишет в ответ. Он просто сидит и ждет, пока клиент что-то не напишет на клавиатуре. Как только клиент отправляет текст, бот хватает его и сохраняет в ту переменную, которую вы укажете.
  (Совет: всегда ставьте перед "Тихим вводом" блок "Сообщение" с текстом "Введите ваше имя:", иначе клиент не поймет, что от него ждут ответа).
• Alert: Вызывает всплывающее системное окошко прямо посередине экрана телефона клиента (с кнопкой ОК). Работает, только если перед этим клиент нажал на In-line кнопку.
• Выдать тег / Забрать тег: Вешает на клиента невидимую метку. Например, тег "Оплатил". В будущем вы сможете делать массовую рассылку сообщений только тем людям, у которых есть этот тег!
• Установить переменную: Жестко перезаписывает данные. Например, переменная = 0 (чтобы обнулить баланс).

Выберите блок «Рандомайзер». У вас появится меню создания веток.

• Нажимайте синюю кнопку «+ Добавить», чтобы создать новый вариант исхода (можно создать до 10 веток).
• В черных окошках напротив веток вам нужно вписать проценты. Например, Ветка #1 — выпадет с шансом 10%, Ветка #2 — выпадет с шансом 90%.
• Главное правило: Сумма всех цифр должна быть строго равна 100%. Система подскажет вам об этом зеленой надписью "Сумма: 100%" в правом верхнем углу.
• Кнопка «⚖️ Выровнять»: Желтая кнопка с весами. Если вам лень высчитывать проценты (например, у вас 3 ветки и нужно поделить 100 на 3), просто нажмите её. Система автоматически проставит всем веткам равные шансы (по 33.3%).

Реферальная система

Состоит из двух связанных блоков:

• Создание ссылки (ref_link): Блок генерирует уникальную реферальную ссылку пользователя и сохраняет ее в переменную (linkVar), а также создает счетчик приглашенных (countVar).
• Засчитать переход (ref_count): Обычно ставится на входе в бота (после команды /start). Блок имеет 3 выхода:
  • Владельцу: Ветка для того, чья ссылка была использована (сюда можно поставить начисление бонуса и уведомление).
  • Рефералу: Ветка для нового пользователя, перешедшего по ссылке (сюда можно поставить приветствие).
  • Продолжить: Для всех остальных пользователей, которые просто запустили бота.

Защита от накрутки: В блок ref_count встроена анти-чит система — владелец не сможет перейти по своей собственной ссылке и накрутить себе бонусы.

Таймер

Останавливает выполнение сценария на заданное время (секунды, минуты, часы, дни). В настройках есть галочка "Эффект печати" (Typing...), при включении которой бот имитирует набор текста всё то время, пока идет ожидание таймера.

Запрос почты

Автоматически запрашивает email пользователя, отправляет на него 4-х или 6-ти значный PIN-код и ждет его ввода для верификации. Сохраняет подтвержденный email в выбранную переменную.

Уведомление

Отправляет системное сообщение. Имеет два режима: конкретному пользователю (поиск по ID или @username) или автоматическая публикация поста в привязанный Telegram-канал.

Нейросети (AI Chat)

Блок «Нейросеть» позволяет подключить ИИ к диалогу с пользователем. Токен для работы настраивается во вкладке "Интеграции" вашей панели.

• Модели на выбор: Доступен выбор между сверхбыстрым ChatGPT 4o-mini и мощным DeepSeek V3.
• Стили общения (Роли): Уникальная фишка! Вы можете заставить ИИ общаться как "Милый помощник (со смайликами)", "Зек (тюремный сленг)" или "Токсик (оскорбления)", что идеально для развлекательных ботов.
• Плавный ответ (Smooth Stream): При включении этой опции бот будет печатать ответ от ИИ в реальном времени по частям, прямо как в оригинальном ChatGPT!

Telegram Stars

Внутренняя валюта Telegram, работающая прямо в боте без сторонних сайтов.

Платежные шлюзы (Prodamus / ЮMoney)

Блок "Оплата" генерирует уникальную ссылку на красивую платежную страницу с таймером 15 минут. В настройках блока вы можете отметить галочками, какие способы оплаты показывать клиенту.

• Prodamus: Поддерживает СБП, SberPay, T-Pay, а также зарубежные карты (в EUR и USD).
• ЮMoney: Оплата с кошелька или банковских карт РФ.

Внимание: Для зарубежных карт (Prodamus) минимальная сумма оплаты рассчитывается динамически (около 1$ или 1€). Для СБП/РФ карт минимум — 50 руб. Для ЮMoney — 2 рубля.

CryptoBot

Прием платежей в криптовалюте (USDT, TON, BTC, ETH и др.) напрямую в Telegram через инвойсы CryptoPay.

HTTP-запросы (API)

Позволяет боту общаться с любыми сторонними серверами и API (GET/POST/PUT/DELETE запросы). Вы можете передавать заголовки и тело JSON.

Парсинг JSON: Самое мощное в этом блоке — парсер ответов. Если сторонний сервер вернул ответ {"status": "ok", "user": {"balance": 500}}, вы можете указать путь user.balance и бот автоматически положит число 500 в выбранную вами переменную! Также можно сохранять код ответа сервера (например, 200 или 404) в отдельную переменную (status_code).

Вкладка «Пользователи»

Здесь хранится список всех людей, кто хоть раз нажимал /start в вашем боте. Вы можете видеть их системный ID (окрашен в желтый цвет), Имя со смайликами, Никнейм (@buxta1) и дату последней активности (например, 28.02).

Поиск и фильтры: Сверху есть два поля: "Все теги" (чтобы показать только VIP-клиентов) и "Поиск" (чтобы найти человека по имени или ID).

Блокировка: Нажмите на три точки напротив человека. Вы можете его забанить. Выберите срок (15 минут, 1 час, 1 день, 1 неделя или Навсегда) и напишите причину. Если этот человек напишет боту, он получит сообщение: "Вы заблокированы до такого-то числа. Причина: Спам".

Вкладка «Рассылки»

Инструмент для массового оповещения клиентов об акциях.

1. Нажмите синюю кнопку «+ Создать рассылку».
2. Заполните карточку:
   • Название: Пишете для себя (например, "Новогодняя скидка").
   • Время отправки: Впишите время, например 12:00. Обратите внимание: бот живет по Московскому времени (МСК)! Учитывайте это, если вы из другого региона.
   • Дни недели: Выберите серые квадратики (Пн, Вт...), чтобы рассылка повторялась.
   • Текст и Медиа: Напишите красивый текст и прикрепите фото.
   • Кнопки (Ссылки): Нажмите кнопку "+ Добавить кнопку", чтобы прикрепить ссылку на ваш сайт прямо под текст рассылки.
3. Нажмите синюю кнопку Сохранить в самом низу.