#Начало работы с Битрикс24 Вайбкод

Битрикс24 Вайбкод — платформа, где искусственный интеллект (AI) создаёт приложения для Битрикс24. Вы описываете задачу обычными словами — и получаете рабочее приложение за часы, без программиста и без навыков разработки.

#Почему это для вас

  • Без навыков программирования. AI пишет код — вам не нужно разбираться в API, серверах и базах данных.
  • Часы, а не месяцы. Не нужно искать разработчика, ставить техзадание и ждать неделями. От идеи до работающего приложения — один разговор с AI-моделью.
  • Под вашим контролем. Доступ к данным открывает ключ, который вы создаёте и в любой момент отзываете сами. Приложение работает на отдельном сервере, закрытом от интернета.
  • Дешевле работы программиста. Разработку делает AI, оплата — за работу сервера и отдельные функции.

#Что понадобится

Перед началом убедитесь, что у вас есть:

  • Портал Битрикс24 с активной подпиской BitrixGPT + Маркетплейс. С ней доступна вся платформа Вайбкод — создание ключей, обращение к данным портала, серверы, деплой и публикация приложений. Без активной подписки эти возможности закрыты.
  • AI-инструмент, который сам работает с файлами и выполняет команды — например, Claude Code, Cursor или OpenAI Codex. Такой инструмент не просто отвечает в чате, а действует автономно: сам читает документацию, создаёт файлы приложения, пишет код и отправляет запросы к платформе Вайбкод. Обычный чат с нейросетью, где можно только переписываться, для этого не подойдёт — иначе все шаги пришлось бы выполнять вручную.

#Шаг 1. Создайте ключ

Ключ — это доступ к данным вашего Битрикс24, который вы передаёте AI-модели. Есть два вида ключей:

  • Для себя (vibe_api_…) — приложение работает от вашего имени. Подходит для личных сводок, отчётов и автоматизаций. Создаётся в разделе Ключи API.
  • Для команды и для встраивания в портал (vibe_app_…) — каждый сотрудник входит через свой Битрикс24 и видит свои данные. Этот же ключ нужен, чтобы приложение открывалось внутри Битрикс24 — в левом меню, вкладке CRM или виджете. Создаётся в разделе Ключи авторизации.

Не уверены — начните с ключа «для себя»: переключиться на командный можно позже. Если приложение должно открываться внутри Битрикс24, сразу создавайте ключ авторизации (vibe_app_…).

  1. Войдите в личный кабинет.
  2. Откройте Ключи API (для себя) или Ключи авторизации (для команды и встраивания в портал).
  3. Нажмите Создать, укажите название и отметьте разрешения — с какими данными приложение сможет работать.
  4. Скопируйте ключ — он показывается один раз.

Подробный разбор формы создания — Создание и использование ключа.

#Шаг 2. Дайте ключ AI-модели

Откройте Claude Code, Cursor или другой AI-инструмент и вставьте промпт:

Мой API ключ для платформы Вайбкод: vibe_api_xxx...
Документация: https://vibecode.bitrix24.tech/v1/me

Сделай мне приложение [описание приложения] и задеплой на вайбкод

Для ключа авторизации (приложение для команды или со встраиванием в портал):

Мой API ключ для платформы Вайбкод: vibe_app_xxx...
Документация: https://vibecode.bitrix24.tech/v1/me

Сделай мне приложение [описание приложения] с авторизацией, встрой его в Битрикс24 и задеплой на вайбкод

Модель вызовет GET /v1/me с вашим ключом и получит доступные данные, разрешения и инструкции по размещению приложения.

#Шаг 3. Что произойдёт дальше

AI-модель делает всё сама:

  1. Узнаёт по вашему ключу, к каким данным и возможностям есть доступ (GET /v1/me).
  2. Пишет код приложения, используя данные вашего Битрикс24 (сделки, задачи, контакты и другие).
  3. Создаёт сервер и размещает приложение через POST /v1/infra/servers/:id/deploy.
  4. Приложение доступно по адресу вида https://app-xxx.vibecode.bitrix24.tech.

Сервер можно создать и заранее, вручную в разделе Black Hole. Подробнее — Инфраструктура.

#Что дальше

Готовые примеры: аналитика воронки продаж, Telegram-бот для CRM, массовая рассылка по контактам, автоматизация задач, синхронизация с 1С/ERP.

Для разработчика и AI-модели: работа с данными, фильтрация, Batch API, оптимизация, инфраструктура, коды ошибок.