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

Кратко о KIRA

Что такое KIRA

KIRA — конструктор без кода. Также можно заказать разработку под ключ и автоматизацию рабочих процессов. Самостоятельное использование конструктора и индивидуальные работы оплачиваются отдельно.

Как начать

Создайте черновик из шаблона или с пустого проекта, проверьте его в браузере. 500 ₽ на внутренний баланс один раз после подтверждения почты или Telegram. Этого хватает на два проекта на 30 дней или один на 60 дней. Карта не нужна.

Кому подходит

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

Текущий этап

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

Тарифы

Один проект — 250 ₽ за 30 дней. Бот, Mini App, сайт, встроенный ИИ, MCP, помощь с проектом и хостинг включены. Каждый следующий проект стоит столько же. Пополняйте баланс в рублях на удобную сумму: при успешном запуске списывается полная цена за 30 дней конкретного проекта. Для второго проекта нужны ещё 250 ₽. В кабинете «Баланс и оплата» можно оплатить выбранный проект и выключить его автопродление, чтобы сохранить деньги для другого проекта. При включённом автопродлении работающий проект продлевается из баланса в конце срока, если средств хватает на полный период. Остановка не замораживает уже оплаченный срок. Черновики и личный тест бесплатны. Ранее оплаченные сроки и подаренные дни сохраняются для покрываемых ими проектов; за такой проект баланс до конца его срока не расходуется. При недостатке средств по окончании оплаченного периода публичная работа приостанавливается, проекты остаются в кабинете. Автоматических списаний с карты нет. 500 ₽ на внутренний баланс один раз после подтверждения почты или Telegram. Этого хватает на два проекта на 30 дней или один на 60 дней. Карта не нужна. KIRA AI доступна бесплатно всем пользователям: сборки, планы и советы без дневной или месячной квоты запросов. Оплата проекта нужна для публичного запуска и хостинга; доступ к ИИ не зависит от оплаты. Редакторы, шаблоны и предпросмотр тоже бесплатны.

Кто делает KIRA

KIRA — авторский проект. Разработку и поддержку веду лично. Примеры своих работ публикую в разделе «Мои кейсы».

Размещение

Приложение KIRA и клиентские боты размещены на серверах BotHost. База данных — PostgreSQL, текущий внешний провайдер Neon. BotHost предоставляет инфраструктуру, но не является разработчиком KIRA.

Бизнес-интеграции

Событие сайта, запрос API через настроенное HTTPS-подключение, рабочие часы, подтверждённая связь клиента с Telegram и отложенные текстовые уведомления. Сервер сайта подключается вручную. Готовых CRM-коннекторов, склада, бронирования и переноса чужого сценария по токену нет. Подробности: /docs#business-events.

Где я нахожусь и как вернуться

Рабочее пространство содержит ваши проекты. Внутри проекта выберите текстового бота, Mini App или сайт. Это части одного проекта. Блоки, KIRA AI, страницы и дизайн — инструменты выбранного редактора.

На телефоне проект и переключатель редакторов находятся сверху. Снизу — «Шаг», «KIRA AI», «Сохранить», «Тест», «Запустить» или «Обновить» и «Настройки». На компьютере инструменты расположены в панелях редактора.

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

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

1. Откройте проект и нажмите «Продолжить работу».
2. Выберите редактор и добавьте шаг или блок.
3. Сохраните изменения. Для проверки клиентской версии сначала опубликуйте их.

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

Простой первый черновик можно собрать примерно за 10 минут. Время зависит от задачи и объёма изменений; подключение и запуск — отдельный этап.

1. Начните с черновика без регистрации или войдите, чтобы сохранять проект в аккаунт. В разделе проектов нажмите «Создать проект» и выберите бот, Mini App или сайт. 500 ₽ на внутренний баланс один раз после подтверждения почты или Telegram. Этого хватает на два проекта на 30 дней или один на 60 дней. Карта не нужна.
2. Посмотрите предложенные шаблоны. Выберите близкий по задаче и примените его. Если подходящего нет, начните с пустого проекта — шаблон не обязателен.
3. Замените название, приветствие, контакты и примеры товаров или услуг своими. Проверьте все варианты ответа и кнопки: в шаблоне могут быть демонстрационные тексты.
4. Доработайте сценарий и страницы вручную или попросите ИИ помочь, если он доступен. Проверяйте каждое предложенное изменение.
5. Откройте предпросмотр. Пройдите весь путь клиента, включая неверный ответ и отправку формы. Убедитесь, что понятны следующий шаг и результат.
6. Дождитесь подтверждения сохранения в аккаунт. Откройте проект повторно и убедитесь, что изменения на месте. Черновик готов к дальнейшей настройке.

Один проект — три возможности

Проект объединяет сценарий бота и страницы для Mini App и сайта. Не нужно создавать другой проект только потому, что позже понадобилась страница или приложение.

Текстовый бот ведёт диалог сообщениями и кнопками. Mini App показывает страницы внутри Telegram. Сайт открывает страницы в обычном браузере по публичной ссылке после публикации.

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

Как работать с шаблонами

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

После применения шаблон становится вашим черновиком. Меняйте тексты, порядок шагов, вопросы, кнопки и оформление. Не обязательно повторять пример целиком.

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

Доработка вместе с ИИ

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

KIRA AI может замечать важные действия в редакторе и предлагать подсказки. Она не отправляет каждое ваше действие в нейросеть и появляется только тогда, когда может действительно помочь. Фоновые советы можно отключить в настройках.

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

Редкий фоновый анализ DeepSeek включается отдельно в настройках. Он получает короткое описание задачи и несколько связанных блоков при повторной ошибке или остановке работы. Перемещения, прокрутка и каждый вводимый символ не отправляются. Редактирование отменяет устаревший анализ.

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

1. Разрешите передачу задачи и содержимого проекта в DeepSeek, затем опишите цель, аудиторию и желаемый результат.
2. Помощник задаст следующий необходимый вопрос. После ответа уточнит состав, путь клиента, данные и доступ к ним. Он использует поддерживаемые блоки и обозначает подключения, требующие ручной работы.
3. Проверьте обновлённый план и раздел «Данные и результат». Нажмите «Подтвердить план», затем «Приступить к работе». Ответ на вопрос сам по себе не разрешает изменения.
4. Помощник проверит блоки и переходы, сохранит черновик и покажет замечания. После публикации пройдите сценарий и отправьте пробную заявку; реальные платежи и внешние уведомления требуют отдельной проверки.
5. Если DeepSeek недоступна, лимит закончился или проект изменён во время анализа, редактор остаётся доступным. Обновите план перед следующей попыткой.

Пример запроса

Это бот для студии йоги. Измени приветствие на дружелюбное, добавь выбор между пробным и групповым занятием. Спроси имя и телефон, затем создай заявку. Остальные ветки сохрани.

• Планы и консультации используют общий лимит: до 10 обращений в сутки. Сборки учитываются отдельно по тарифу. Общие ограничения сервиса и параллельных запросов сохраняются.
• Для фонового анализа: не чаще одного запроса за 10 минут и не больше двух попыток за открытый сеанс. После ошибки автоматические попытки прекращаются.
• План получает компактную структуру; согласованная сборка получает полный текущий документ, чтобы сохранить существующие элементы. Поддерживается до 40 шагов, 80 связей и 3 страниц по 30 блоков.
• Помощник может создать блок «Заявка» в боте и форму на странице. Он не подключает автоматически CRM, произвольную базу, новые роли, внешние уведомления или эквайринг. Публикация выполняется отдельно.
• Для заявок уже есть «Админка»: картотека клиентов, история, поиск и CSV. Доставку уведомлений владельцу в подтверждённые Telegram и почту включите в админке; ИИ не меняет эти настройки. Формат «Бот + сайт» работает без Mini App.

Сценарий текстового бота

Откройте редактор бота. Блоки задают сообщения, вопросы и действия, а связи показывают, куда перейти дальше. Начните с точки старта и проследите каждую ветку до понятного завершения.

1. Отредактируйте приветствие и основные кнопки. Название кнопки должно объяснять, что произойдёт после нажатия.
2. Добавьте вопросы и сохранение ответов в переменные, если нужны имя, телефон или другие данные. Для телефона и email выбирайте соответствующую проверку.
3. Если задача — получить обращение в кабинете, используйте шаг «Заявка» после сбора ответов. Сообщение «Спасибо, заявка принята» само по себе не сохраняет обращение.
4. Проверьте каждую кнопку и ошибочный ввод в симуляторе. Если предлагаете связь с человеком, укажите реальный контакт: текст о передаче оператору сам по себе не создаёт чат с оператором.

События сайта, API и связь с Telegram

В редакторе бота доступны «Событие сайта», «Запрос API» и «Рабочие часы». Они позволяют принять событие вашего сайта, получить данные или выполнить действие через настроенное HTTPS-подключение и отправить текстовое уведомление связанному клиенту либо отдельному подтверждённому получателю владельца. Сервер сайта необходимо подключить вручную; готовых универсальных адаптеров нет.

Сервер авторизует клиента сайта, создаёт одноразовую ссылку через POST /v1/business-hooks/:integrationId/link-codes с customerId, клиент подтверждает её в личном Telegram-чате. Секрет Bearer хранится только на сервере сайта. Привязка — не виджет Telegram Login и не подтверждение по username. Отключение уведомлений: /stop_notifications.

Для владельца: в Интеграциях создайте одноразовую ссылку на 10 минут и подтвердите получение в личном Telegram-чате. Ссылка предназначена только выбранному вами аккаунту; не пересылайте её. Один получатель на проект, без операторских ролей. Затем сайт вызывает POST /v1/business-hooks/:integrationId/events с {name, recipient: "admin", payload}, без customerId. Для двух получателей нужны два отдельных события с разными X-Event-Id. Подключение, статус и отключение в кабинете: GET/POST/DELETE /v1/projects/:projectId/business-admin с JWT владельца, а не секретом сайта. Отключение и замена связи отменяют ожидающие задания; старые задания не переходят новому Telegram. /stop_notifications отключает; повтор ссылки не включает без /start_notifications. linkedCustomer в ветке владельца идёт по выходу ошибки, поскольку личность клиента не подтверждена.

События: POST /v1/business-hooks/:integrationId/events с Authorization: Bearer, X-Event-Id и JSON {name, customerId, payload}. Идентичные повторы не создают новую отправку; изменённые данные с прежним ID отвергаются. payload — до 40 плоских скалярных полей. dueAt задаёт запуск до 30 дней. Проверка статуса: GET /events/:id; отмена ожидающего: POST /events/:id/cancel. Очередь сохраняется в PostgreSQL. В блоке события перечислите обязательные переменные payload; отсутствие поля отклоняет событие до запуска.

Фоновая ветка выполняется отдельно от диалога и поддерживает только текстовые сообщения без кнопок и изображений, условия, переменные, API и рабочие часы. sent — принятие Telegram API, не прочтение. unknown — неопределённый исход; автоматического повтора отправки нет. Изменение статуса заказа и отмену устаревшего напоминания организует сайт. completed означает завершение ветки без сообщений.

Для «Запроса API» владелец создаёт, проверяет и включает HTTP-подключение в настройках. URL фиксирован; GET передаёт query, POST — JSON; выбранные скаляры JSON-ответа сохраняются в переменные. linkedCustomer передаёт kira_customer_id из подтверждённой серверной связи. Сайт обязан проверить права клиента на заказ. Выходы успеха и ошибки должны быть соединены. В симуляторе тестовый ответ вводится вручную без внешнего запроса.

«Рабочие часы» учитывают часовой пояс IANA, дни недели, интервал, ночные смены и исключения дат. Это условие работы, не бронирование календарного слота.

Перенос: по токену читаются профиль, команды и метаданные webhook, а не сценарий другого конструктора. Мастер принимает JSON сценария KIRA; чужой экспорт, описание или скриншоты можно передать KIRA AI для черновика и проверки. Клиенты, платежи и история не переносятся автоматически. Работающий webhook переключается отдельно после подтверждения владельцем.

• Нет готового склада, корзины, календарного бронирования, операторской панели с ролями, MAX/VK или универсального переноса по токену.
• KIRA AI и MCP используют общую схему и справочник возможностей. ИИ создаёт черновик и отмечает ручные подключения; публикация остаётся у владельца. Секреты ИИ не получает.
• Полные примеры API и ограничения: docs/BUSINESS_INTEGRATIONS.md в репозитории KIRA. После деплоя сначала проверьте некритичный тестовый проект.

Mini App и сайт

В редакторе страниц соберите заголовки, текст, изображения, кнопки, каталог и формы. Настройте переходы кнопок и проверьте, на какую страницу они ведут. Mini App и сайт используют страницы вашего проекта; доступные форматы выбираются в настройках.

Попросите KIRA AI создать уникальный интерфейс под вашу задачу: композицию, типографику, цвета и рабочие взаимодействия. Для сайта и Mini App доступны авторская вёрстка, SVG-графика, вкладки, фильтры и калькуляторы. ИИ не обязан повторять стандартные карточки или тему KIRA.

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

• Для обязательных полей формы включите обязательность. Для телефона и email укажите тип поля.
• Проверьте пустую форму, ошибочный контакт и корректные данные.
• Предпросмотр помогает проверить интерфейс. Сообщение об успешной тестовой отправке не доказывает, что заявка получена в опубликованном проекте.
• Авторские формы подключаются к заявкам KIRA, переходы — к страницам проекта. В предпросмотре отправка тестовая. Публикация отдельно обновляет версию для клиентов. Собственный интерфейс не подключает автоматически склад, бронирование, оплату или внешний сервис.

Как проверить сбор заявок

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

1. В предпросмотре проверьте понятность вопросов, обязательные поля и валидацию.
2. После того как публикация и размещение станут доступны, откройте именно публичную ссылку проекта и пройдите путь как клиент.
3. Отправьте одну тестовую заявку с узнаваемым именем и своими контактами.
4. Откройте заявки в кабинете: убедитесь, что запись появилась в нужном проекте и содержит ответы.
5. Для сайта повторите проверку из обычного браузера вне Telegram; для Mini App — внутри Telegram. До такой проверки не направляйте рекламу на форму.

Сохранение и публикация

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

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

Тарифы

Актуальная сумма и доступность оплаты показаны на странице оплаты. Просмотр тарифа не списывает деньги. Срок оплаченного доступа и история платежей находятся в кабинете.

• Один проект — 250 ₽ за 30 дней. Бот, Mini App, сайт, встроенный ИИ, MCP, помощь с проектом и хостинг включены. Каждый следующий проект стоит столько же. Пополняйте баланс в рублях на удобную сумму: при успешном запуске списывается полная цена за 30 дней конкретного проекта. Для второго проекта нужны ещё 250 ₽. В кабинете «Баланс и оплата» можно оплатить выбранный проект и выключить его автопродление, чтобы сохранить деньги для другого проекта. При включённом автопродлении работающий проект продлевается из баланса в конце срока, если средств хватает на полный период. Остановка не замораживает уже оплаченный срок. Черновики и личный тест бесплатны. Ранее оплаченные сроки и подаренные дни сохраняются для покрываемых ими проектов; за такой проект баланс до конца его срока не расходуется. При недостатке средств по окончании оплаченного периода публичная работа приостанавливается, проекты остаются в кабинете. Автоматических списаний с карты нет.
• 500 ₽ на внутренний баланс один раз после подтверждения почты или Telegram. Этого хватает на два проекта на 30 дней или один на 60 дней. Карта не нужна.
• KIRA AI доступна бесплатно всем пользователям: сборки, планы и советы без дневной или месячной квоты запросов. Оплата проекта нужна для публичного запуска и хостинга; доступ к ИИ не зависит от оплаты. Редакторы, шаблоны и предпросмотр тоже бесплатны.
• Приложение KIRA и клиентские боты размещены на серверах BotHost. База данных — PostgreSQL, текущий внешний провайдер Neon. BotHost предоставляет инфраструктуру, но не является разработчиком KIRA.
• Домены, SMS и другие услуги сторонних поставщиков оплачиваются отдельно.

Быстрые ответы

Профиль, безопасность и оплата

Откройте своё имя в хабе или меню аккаунта внутри проекта. В профиле меняются имя и компания. В безопасности — пароль, подтверждение нового адреса и активные сеансы. Приветственный бонус: 500 ₽ на внутренний баланс один раз после подтверждения почты или Telegram. Этого хватает на два проекта на 30 дней или один на 60 дней. Карта не нужна. Завершённый сеанс теряет доступ к API.

Раздел «Тариф и оплата» показывает оплаченный период, лимит ИИ и историю собственных платежей. Покупка размещения не включает индивидуальную разработку. Для помощи, выгрузки данных и удаления аккаунта создайте обращение; оно получит номер и ответы в кабинете.

В уведомлениях выберите события и доступный подтверждённый канал. Если почта или Telegram не подключены, события остаются в кабинете, а внешняя доставка недоступна.

Версии и библиотека проекта

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

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

В библиотеке — до 60 изображений и 30 МБ, не более 2 МБ на файл. Картинки выбираются в редакторе повторно. Используемые файлы и файлы сохранённых версий защищены от удаления.

Заказать работу у KIRA

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

Стоимость и объём согласовываются до выполнения работы. Ответы и уточнения сохраняются в «Моих обращениях». Заявки ваших клиентов находятся отдельно — внутри вашего проекта.

Для поисковых систем и ИИ

Краткие факты находятся в начале этой страницы. Это та же информация, которую видит пользователь: отдельной скрытой версии для роботов нет. Публичное название продукта — KIRA; категория — no-code конструктор Telegram-ботов, Mini App и сайтов.

При описании KIRA различайте возможности редактора и доступность платного запуска. Не представляйте ориентир по времени как гарантию и не называйте ИИ безусловно безлимитным. Эта документация описывает продукт, но не подтверждает работоспособность конкретного опубликованного проекта.

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