Первое приложение на Битрикс24 Вайбкод за час

Что такое «приложение за час» и чего от него ожидать

Прежде чем запускать первый проект, полезно зафиксировать правильные ожидания. За час в Вайбкоде реально получить рабочий прототип уровня приложения Битрикс24: виджет или плейсмент, встроенный в интерфейс портала, автоматизацию через REST API, чат-бота в мессенджере. Это полноценный рабочий инструмент - просто не мегасистема с нуля.

Два примера, что реально успеть за один сеанс:

• Виджет быстрого отчёта в CRM - карточка в сделке, которая показывает агрегированные данные по контакту из нескольких сущностей.
• Телеграм-бот для уведомлений - приложение, которое слушает события портала (новая сделка, смена статуса) и отправляет сообщение в нужный чат.

Приложение крутится на стороне: бизнес-логика живёт на серверах Галактики/Black Hole или вашем сервере, обращается к порталу через REST API и встраивается через плейсменты. О том, что такое Битрикс24 Вайбкод и как устроена платформа в целом, - в отдельном материале.

---

Шаг 0. Что нужно до старта

Доступ и подписка

Вайбкод работает на сайте vibecode.bitrix24.tech. Для входа используются данные учётной записи Битрикс24.

Ключевые условия:

• Тариф. Подписка «BitrixGPT + Маркетплейс» оформляется только на платных тарифах Битрикс24. Для тестирования доступен 14-дневный триал на демо-портале; при первой оплате триал снимается, наработки и серверы остаются.
• Баланс вайбов. Внутренняя валюта платформы, курс 1:1 к рублю. На портал при старте начисляется 1 000 вайбов. Пакеты для пополнения: Стартовый (1 000 вайбов), Командный (5 000), Профи (25 000). При нулевом балансе новые запросы ограничиваются.
• API-ключ. Для первого знакомства достаточно ключа «для себя» (проще). Для командного приложения под правами пользователей нужен ключ авторизации (OAuth-приложение) - его создаёт администратор портала.

Бесплатные ИИ-модели

В облаке доступны бесплатные ИИ-модели с хостингом в РФ: BitrixGPT 5 / 5.5 / 5.5 Agent, GPT-OSS 120B, Gemma 4 26B (в том числе с thinking), Vision, Whisper. С июля 2026 они бесплатны в пределах ИИ-квоты по вашему тарифу (Pricing v2); сверх квоты вызовы идут с баланса вайбов. Подробнее о моделях - в статье Vibe API и бесплатные ИИ-модели BitrixGPT в Вайбкоде.

---

Шаг 1. Создаём API-ключ

1. Войдите на vibecode.bitrix24.tech через учётную запись Битрикс24.
2. Перейдите в раздел API-ключи → создайте новый ключ типа «Для себя».
3. Задайте права доступа - явно укажите, к каким данным и операциям они открывают доступ (CRM, задачи, чаты, диск). Ключ «только чтение для аналитики» не создаст сделку и не изменит данные - это намеренно.
4. Скопируйте ключ: он понадобится при постановке задачи ИИ-агенту.

Если собираете в приложении Коворк/Код. Во вкладке «Код» этот шаг с октября 2026 не нужен: приложение само получает ключ и само выкатывается на сервер, ссылка появляется в блоке деплоя. Ручной ключ остаётся для работы с платформой напрямую и для сторонних агентных клиентов. Подробно о десктопе - в статье Битрикс24 Коворк/Код: установка, режимы работы и первые сценарии.

Совет по безопасности. Для первого эксперимента используйте ключ с минимальными правами - только то, что нужно приложению. Если ключ окажется у посторонних, его можно отозвать в один клик. Подробнее - в статье Безопасность вайбкодинга в Битрикс24.

---

Шаг 2. Ставим задачу ИИ-агенту

Вайбкод использует ИИ-агентов (Claude Code, Codex) для написания кода. Агент понимает задачи на естественном языке - программировать не нужно.

Как сформулировать задачу

Хорошая постановка содержит:

1. Что должно делать приложение - конкретное действие, а не абстрактное «автоматизировать продажи».
2. Где отображается - в карточке сделки, в боковой панели CRM, в мессенджере Битрикс24.
3. Какие данные использует - из каких сущностей читает/пишет.

Пример слабой задачи: «Сделай приложение для CRM».

Пример рабочей задачи: «Создай виджет в карточке сделки Битрикс24, который показывает список последних трёх задач по этой сделке с их статусами. Используй API-ключ [вставить ключ]. Встрой в плейсмент карточки сделки».

Если агент неправильно понял задачу - не начинайте заново. Уточните в том же чате: «измени вывод так, чтобы задачи сортировались по дате», «добавь кнопку обновить». Агент помнит ход работы от сессии к сессии.

Скилл superpowers

Для работы с Vibe API у агента должен быть установлен скилл superpowers - это обязательное условие. Скилл ставится через интерфейс платформы или командой в чате.

---

Шаг 3. Генерация, предпросмотр, правки

После получения задачи агент:

1. Пишет код приложения.
2. Создаёт сервер Black Hole (закрытый облачный сервер, невидимый из интернета) - деплой занимает 1-2 минуты.
3. Разворачивает приложение на сервере.

Путь от запроса к работающему приложению: ИИ-агент получает промпт, пишет код, деплоит на сервер Black Hole, а сервер через REST API обменивается с порталом Битрикс24 и встраивается в интерфейс через плейсмент.

flowchart TD
    USER[Ваш запрос на языке] --> AGENT[ИИ-агент Вайбкода]
    AGENT --> CODE[Пишет код]
    CODE --> BH[Сервер Black Hole]
    BH <-->|REST API| B24[Портал Битрикс24]
    B24 --> UI[Плейсмент / виджет в интерфейсе]

После деплоя приложение открывается в разделе Серверы Black Hole (если это UI-виджет) или в Мессенджере (если бот). Проверьте работу, внесите правки в чате с агентом - и снова деплойте. Цикл «правка → деплой» занимает минуты.

---

Шаг 4. Публикация приложения в портал

Когда прототип готов:

• Для себя / команды - приложение уже доступно через плейсмент в портале после деплоя. Дополнительной публикации не требуется.
• Для всего портала - администратор устанавливает приложение через раздел «Разработчикам» в настройках Битрикс24.
• В Маркетплейс - публикация приложений из Вайбкода в Маркетплейс пока недоступна; функция готовится в следующих версиях платформы.

Стоимость серверов. Выключенный (спящий) сервер обходится от 65 Ꝟ в месяц, работающий - от 300 Ꝟ (тариф Agent) и 600 Ꝟ (Micro). Серверы можно усыплять и удалять, когда приложение не нужно.

---

Что можно и чего нельзя в облачной версии

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

Что работает через вайбкодинг в облаке

• Приложения и виджеты, встроенные в интерфейс через плейсменты.
• Автоматизации через REST API (создание/чтение/обновление сделок, задач, контактов, событий).
• Чат-боты в мессенджере Битрикс24.
• Использование ИИ-моделей (BitrixGPT, Gemma, GPT-OSS) внутри логики приложения.
• Интеграции с внешними сервисами через вебхуки и REST.
• Доступ к 300+ методам Vibe API, 41 сущности с полным CRUD.

Чего нельзя в облаке через вайбкодинг

• ❌ Менять исходный код ядра и стандартных компонентов Битрикс24.
• ❌ Писать серверный PHP внутри портала.
• ❌ Добавлять кастомные типы полей или сущностей на уровне базы данных портала.
• ❌ Напрямую обращаться к базе данных портала.
• ❌ Обходить лимиты REST API - частоту запросов и доступность методов на конкретном тарифе.
• ❌ Править системные шаблоны и дизайн ядра.

Ключевой вывод: «приложение за час» - это инструмент поверх Битрикс24, а не переделка облака изнутри. Глубокие изменения на уровне кода и базы данных портала через вайбкодинг невозможны - для них нужна коробочная (self-hosted) версия.

Облако vs коробка: сравнение возможностей вайбкодинга

Возможность	Облако (Вайбкод)	Коробка (self-hosted)
Приложения через REST API и плейсменты	✅	✅
Чат-боты, виджеты в интерфейсе	✅	✅
ИИ-модели BitrixGPT / Gemma	✅	🔄 (модуль Vibe Connect в разработке)
Деплой на серверы Black Hole	✅	✅ (свой сервер)
Изменение исходного кода ядра	❌	✅
Серверный PHP внутри портала	❌	✅
Прямой доступ к БД портала	❌	✅
Кастомные типы полей на уровне БД	❌	✅
Обход лимитов REST API тарифа	❌	Гибче (зависит от настройки)

Если вашей задаче достаточно возможностей REST API - облако подойдёт. Если нужны глубокие изменения ядра, прямая работа с БД или коробочные модули - это тема для отдельного разговора. Читайте подробнее в статье Переход с облачного Битрикс24 на коробку: когда нужен и как сделать.

---

Типичные ошибки при первом запуске

• Слишком общая задача. «Автоматизируй работу отдела» - агент не поймёт. Начинайте с одного конкретного действия.
• Лишние права в ключе. Выдавать полный доступ для тестового проекта - плохая практика. Ограничьте ключ нужными сущностями.
• Ожидание изменений в ядре. Если задача звучит «измени стандартную форму сделки» - это за пределами облачного вайбкодинга.
• Игнорирование лимитов REST API. Часть методов недоступна на младших тарифах; при высокой частоте запросов возможны ограничения. Если приложение «тормозит» - проверьте логи в разделе «Разработчикам».
• Забыли усыпить сервер. Неиспользуемый активный сервер продолжает тарифицироваться. После тестирования переводите в режим сна.

---

Когда вайбкодинг - не тот инструмент

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

• Нужна сложная интеграция с 1С с двусторонней синхронизацией и обработкой нагруженных очередей - здесь лучше классическая разработка через REST API или коробочный модуль. Подробнее - в статье Интеграция Битрикс24 и 1С: 3 рабочих сценария.
• Требуется изменить логику стандартных роботов и триггеров на уровне ядра - только коробка.
• Высокие требования к производительности и нагрузочному тестированию - прототип из Вайбкода стоит перенести в полноценную разработку после проверки идеи.
• Публикация в Маркетплейс - функция пока недоступна, готовится в следующих версиях.

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

---

С чего начать прямо сейчас

Самый быстрый старт:

1. Откройте vibecode.bitrix24.tech, войдите через Битрикс24.
2. Создайте API-ключ с минимально необходимыми правами доступа (в Коворк/Коде ключ создаётся сам).
3. Опишите одну конкретную задачу в чате с агентом.
4. Дождитесь деплоя (1-2 минуты), проверьте результат в портале.
5. Уточняйте в том же чате - агент помнит контекст.

Если вы не уверены, подойдёт ли облако под вашу задачу или нужна коробка - АС Проект (платиновый партнёр Битрикс24) поможет разобраться и выбрать подходящий путь без лишних экспериментов.

---

Что нового к июлю 2026

• AI-квоты (Pricing v2). Бесплатные модели теперь бесплатны в пределах квоты по тарифу, сверх - с баланса вайбов.
• Галактики стали основным способом деплоя (десятки приложений на одном хосте по нулевой цене за место).
• Полные бэкапы серверов (код + данные + файлы) - по кнопке или расписанию.
• Новое в API: расшифровки звонков (/v1/activities/:id/transcript), База знаний 2.0 (/v1/note), эмбеддинги (/v1/embeddings).

Нужна помощь по вайбкод-приложению? АС Проект - платиновый партнёр Битрикс24: собираем приложения на Вайбкоде, проверяем чужие перед боевым запуском и берём на сопровождение. Состав работ и цены - на странице приложения на вайбкодинге.

Что изменилось к концу августа 2026

• Условия старта. Новой компании начисляется 1 000 приветственных вайбов и 14 дней пробного доступа, вайбы живут 365 дней с момента покупки, при оплате сверху добавляется НДС 22%.
• BitrixGPT 5.6 Agent 1M. Контекст вырос до 1 млн токенов (порядка тысячи страниц за один запрос), новые агенты создаются на этой модели по умолчанию, а долгие ответы почти исчезли.
• Тарифы Коворк/Кода. Подписка персональная, на сотрудника: Free (5% от объёма Pro), Pro - 2 000 Ꝟ в месяц, Max - 10 000 Ꝟ (впятеро больше Pro), Ultra - 20 000 Ꝟ (вдесятеро больше Pro). AI-квота портала при этом даётся на компанию и зависит от тарифа Битрикс24.
• Галактики уплотнились. У одного клиента 375 приложений переехали с двенадцати машин на одну: расходы упали с 24 000 до 8 000 ₽ в месяц, место для приложения подешевело с 64 до 21 ₽ в месяц. Машина занята на 29%, расчётный потолок - около 1 500 приложений.

Что изменилось к октябрю 2026

• Ключ и деплой автоматически. В приложении Коворк/Код ключ и выкладка на сервер больше не требуют захода на платформу Вайбкод: приложение получает ключ само, ссылка появляется в блоке деплоя. Кнопку «Деплой» нажимают вручную только после долгой доработки, когда система сама предлагает передеплоить, или если автоматический деплой не прошёл.
• Одна папка - одно приложение. Всё, что будет дорабатываться, делают в папке проекта: внутри неё сколько угодно сеансов под одним ключом, зависший сеанс просто заменяют новым. Сеанс без папки годится только для пробы, после обрыва связи его не продолжить.
• Проверка безопасности по умолчанию. Последний пункт плана разработки - скилл проверки безопасности. Полную проверку с исправлениями можно запустить отдельно: «/» и первые буквы «security» в поле ввода.
• Приложения в мессенджере. Опубликованные приложения сотрудники находят в папке «Вайбкод» мессенджера Битрикс24 (обновление выдают постепенно с 12.10.2026) или через иконку каталога. Поделиться можно через «три точки» с сотрудником или отделом, у каждого приложения есть свой чат для новостей и обратной связи.

Данные на 13 октября 2026 - платформа Вайбкод в активной бете, цифры (квоты, цены, версии) меняются. Сверяйтесь с документацией Вайбкода.

Частые вопросы