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

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

1. Откройте Вайбкод и войдите через Битрикс24.

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

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

3. Откройте AI-инструмент для разработки: Codex, Claude Code, Cursor или другой.

4. Создайте новый проект и вставьте промпт с ключом, ссылкой на документацию https://vibecode.bitrix24.tech/v1/me и описанием задачи.

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

6. Откройте приложение в Битрикс24 и проверьте основной сценарий.

Какие ключи использоватьКакие ключи использовать

В Битрикс24 Вайбкод есть три типа ключей.

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

• vibe_app_... — ключ авторизации для приложения с OAuth. Пользователи входят в приложение через Битрикс24 и работают со своими правами. Этот ключ нужен, чтобы приложение встраивалось в интерфейс Битрикс24 — пунктом в левом меню, вкладкой в карточке CRM или виджетом. Личный ключ vibe_api_... встраивание в интерфейс не поддерживает: с ним приложение обращается к данным, но не размещается в окне Битрикс24.

• vibe_live_... — менеджмент-ключ для администрирования. Он не привязан к одному Битрикс24 и не обращается к данным — сделкам, задачам и другим объектам. Таким ключом управляют API-ключами, смотрят список подключенных Битрикс24 и работают с обращениями в поддержку платформы.

Для первого теста можно использовать личный ключ. Для приложения, которым будет пользоваться команда и которое открывается внутри Битрикс24, выбирайте ключ авторизации с OAuth — в мастере создания это режим «Приложение с авторизацией». Как опубликовать такое приложение — в разделе Публикация приложения в каталоге Битрикс24.

Режим доступа ключаРежим доступа ключа

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

• READWRITE — чтение и запись, значение по умолчанию для новых ключей.

• READONLY — только чтение. Запись отвечает ошибкой 403 WRITE_BLOCKED_READONLY_KEY.

Действующий режим приходит в ответе GET /v1/me в поле accessMode, а переключают его в карточке ключа. Режим для новых ключей задает администратор в настройках Вайбкод: на уже выпущенные ключи эта настройка не влияет.

Безопасность ключейБезопасность ключей

Вайбкод работает с доступами Битрикс24 через ключи. Ключ определяет, какие данные и действия доступны AI-агенту или приложению. Если приложению нужна только CRM, не добавляйте права доступа к задачам, чатам или другим разделам.

Ключ нужно передавать только в тот AI-инструмент и проект, где создается приложение. Не публикуйте ключ в репозитории, примерах кода, скриншотах и открытых чатах. Если ключ попал в чужой доступ, создайте новый ключ и отключите старый.

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

Серверы Black Hole помогают ограничить внешний доступ к серверной части приложения. Такой сервер не нужно открывать как обычный публичный VPS: доступ к серверу и приложению управляется через Вайбкод, а подключение проходит через туннель.

Права на создание ключей и приложенийПрава на создание ключей и приложений

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

Какую настройку менять, видно по коду ошибки: KEY_CREATION_RESTRICTED и APP_CREATION_RESTRICTED приходят от Вайбкод, CONNECTOR_KEY_ISSUE_FORBIDDEN и CONNECTOR_APP_INSTALL_FORBIDDEN — от Битрикс24. Если вы не администратор, отправьте заявку на доступ из кабинета Вайбкод.

Примеры промптов для AI-агентаПримеры промптов для AI-агента

Скопируйте промпт в Codex, Claude Code, Cursor или другой AI-инструмент. Замените vibe_api_xxx или vibe_app_xxx на ключ Вайбкод.

Для первого теста используйте личный ключ vibe_api_....

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

В дайджесте: все сделки в работе, просроченные сделки, сделки без активности 3+ дня. Сводка: общая сумма в воронке, топ-5 крупных сделок, список «забытых» сделок, конверсия за вчера.

API-ключ: vibe_api_xxx
Документация: https://vibecode.bitrix24.tech/v1/me

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

Создай приложение для Битрикс24 с авторизацией.

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

Ключ авторизации приложения: vibe_app_xxx
Документация: https://vibecode.bitrix24.tech/v1/me

AI-агент обратится к GET /v1/me, получит доступные возможности ключа и выберет подходящие методы API. Если прав ключа недостаточно, агент сообщит, какие права нужно добавить.

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

Что AI-агент сделает автоматическиЧто AI-агент сделает автоматически

После получения ключа и задачи AI-агент выполнит основной цикл разработки без ручной настройки интеграции.

1. Вызовет GET /v1/me, чтобы получить доступные объекты, права ключа и инструкции.

2. Выберет подходящие методы API Битрикс24 Вайбкод.

3. Напишет код приложения, бота, обработчика события или фоновой задачи.

4. Создаст сервер Black Hole через инфраструктурные инструкции Вайбкод, если приложению нужна серверная часть.

5. Задеплоит приложение и вернет ссылку для проверки.

AI-агент может исправить ошибки, которые возникают при выполнении задачи: определить причину и повторить действие с исправленными параметрами. При нехватке прав ключа, данных для задачи или доступа к инструменту агент сообщит, что нужно добавить или уточнить. Ошибку в работе Битрикс24 Вайбкод агент может отправить разработчикам платформы как фидбэк с контекстом проблемы.

Где запускается приложениеГде запускается приложение

AI-агент может запустить приложение в Битрикс24 или на сервере в зависимости от задачи.

• Приложению не нужен серверный код и обработка событий — разместится как HTML/JS-приложение в Битрикс24.

• Приложение с фоновой логикой или чат-бот — запустится на сервере Black Hole.

Обзор всех инструментов платформы — в статье Инструменты Вайбкод.

Что проверить после создания приложенияЧто проверить после создания приложения

AI-агент готовит код приложения, но результат нужно проверить перед использованием на вашем Битрикс24. Проверьте:

• какие права запрашивает ключ или приложение,

• какие данные читает и изменяет приложение,

• как приложение обрабатывает ошибки API,

• где хранится ключ Вайбкод и другие секретные данные приложения,

• кто получает доступ к приложению или серверу,

• какой сервер Black Hole создал агент и кто может открыть приложение,

• как приложение ведет себя на тестовых данных.

Если агент внес изменения в код, попросите его кратко описать архитектуру, точки входа, используемые методы API и способ деплоя. Так разработчик сможет проверить результат и продолжить работу с приложением.

Что дальшеЧто дальше

• Инструменты Вайбкод — серверы Black Hole, боты, AI-модели, AI-поиск, хранилище и другие инструменты

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