[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-quickstart":3,"docs-tabs-quickstart":6},{"content":4,"lastmod":5},"# Начало работы с Битрикс24 Вайбкод\n\nБитрикс24 Вайбкод — платформа, где искусственный интеллект (AI) создаёт приложения для Битрикс24. Вы описываете задачу обычными словами — и получаете рабочее приложение за часы, без программиста и без навыков разработки.\n\n## Почему это для вас\n\n- **Без навыков программирования.** AI пишет код — вам не нужно разбираться в API, серверах и базах данных.\n- **Часы, а не месяцы.** Не нужно искать разработчика, ставить техзадание и ждать неделями. От идеи до работающего приложения — один разговор с AI-моделью.\n- **Под вашим контролем.** Доступ к данным открывает ключ, который вы создаёте и в любой момент отзываете сами. Приложение работает на отдельном сервере, закрытом от интернета.\n- **Дешевле работы программиста.** Разработку делает AI, оплата — за работу сервера и отдельные функции.\n\n## Что понадобится\n\nПеред началом убедитесь, что у вас есть:\n\n- **Портал Битрикс24 с активной подпиской BitrixGPT + Маркетплейс.** С ней доступна вся платформа Вайбкод — создание ключей, обращение к данным портала, серверы, деплой и публикация приложений. Без активной подписки эти возможности закрыты.\n- **AI-инструмент, который сам работает с файлами и выполняет команды** — например, Claude Code, Cursor или OpenAI Codex. Такой инструмент не просто отвечает в чате, а действует автономно: сам читает документацию, создаёт файлы приложения, пишет код и отправляет запросы к платформе Вайбкод. Обычный чат с нейросетью, где можно только переписываться, для этого не подойдёт — иначе все шаги пришлось бы выполнять вручную.\n\n## Шаг 1. Создайте ключ\n\nКлюч — это доступ к данным вашего Битрикс24, который вы передаёте AI-модели. Есть два вида ключей:\n\n- **Для себя** (`vibe_api_…`) — приложение работает от вашего имени. Подходит для личных сводок, отчётов, серверных автоматизаций и фоновых задач по расписанию (cron) — запросы идут по заголовку `X-Api-Key`, токен сессии не нужен. Создаётся в разделе [Ключи API](\u002Fkeys).\n- **Для команды и для встраивания в портал** (`vibe_app_…`) — каждый сотрудник входит через свой Битрикс24 и видит свои данные. Этот же ключ нужен, чтобы приложение открывалось внутри Битрикс24 — в левом меню, вкладке CRM или виджете (см. [Места встраивания](\u002Fdocs\u002Fapps\u002Fplacements)). Создаётся в разделе [Ключи авторизации](\u002Fapps).\n\nНе уверены — начните с ключа «для себя»: переключиться на командный можно позже. Если приложение должно открываться внутри Битрикс24, сразу создавайте ключ авторизации (`vibe_app_…`).\n\nДля фоновой автоматизации без пользователя у экрана — cron, планировщик, серверные скрипты — выбирайте ключ API (`vibe_api_…`). Ключ авторизации (`vibe_app_…`) на каждый запрос к данным требует заголовок `Authorization: Bearer` с токеном сессии, а сессия живёт 24 часа без автопродления — автоматическому скрипту нечем заново пройти авторизацию каждые сутки. Подробнее — [Создание и использование ключа](.\u002Fkeys-auth.md).\n\n1. Войдите в [личный кабинет](\u002Fdashboard).\n2. Откройте [Ключи API](\u002Fkeys) (для себя) или [Ключи авторизации](\u002Fapps) (для команды и встраивания в портал).\n3. Нажмите **Создать**, укажите название и отметьте [разрешения](.\u002Fscopes.md) — с какими данными приложение сможет работать.\n4. Скопируйте ключ — он показывается один раз.\n\nПодробный разбор формы создания — [Создание и использование ключа](.\u002Fkeys-auth.md).\n\n## Шаг 2. Дайте ключ AI-модели\n\nОткройте Claude Code, Cursor или другой AI-инструмент и вставьте промпт:\n\n```\nМой API ключ для платформы Вайбкод: vibe_api_xxx...\nДокументация: https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fme\n\nСделай мне приложение [описание приложения] и задеплой на вайбкод\n```\n\nДля ключа авторизации (приложение для команды или со встраиванием в портал):\n\n```\nМой API ключ для платформы Вайбкод: vibe_app_xxx...\nДокументация: https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fme\n\nСделай мне приложение [описание приложения] с авторизацией, встрой его в Битрикс24 и задеплой на вайбкод\n```\n\nМодель вызовет `GET \u002Fv1\u002Fme` с вашим ключом и получит доступные данные, разрешения и инструкции по размещению приложения.\n\n## Шаг 3. Что произойдёт дальше\n\nAI-модель делает всё сама:\n\n1. Узнаёт по вашему ключу, к каким данным и возможностям есть доступ (`GET \u002Fv1\u002Fme`).\n2. Пишет код приложения, используя данные вашего Битрикс24 (сделки, задачи, контакты и другие).\n3. Создаёт сервер и размещает приложение через `POST \u002Fv1\u002Finfra\u002Fservers\u002F:id\u002Fdeploy`.\n4. Приложение доступно по адресу вида `https:\u002F\u002Fapp-xxx.vibecode.bitrix24.tech`.\n\nСервер можно создать и заранее, вручную в разделе [Black Hole](\u002Fblack-hole). Подробнее — [Инфраструктура](.\u002Finfra.md).\n\n## Что дальше\n\n- [Создание и использование ключа](.\u002Fkeys-auth.md) — как создать ключ, ограничить срок действия и отозвать в любой момент.\n- [Разрешения (скоупы)](.\u002Fscopes.md) — что означают разрешения и какие данные вы открываете приложению.\n- [Бот-платформа](.\u002Fbots.md) — как сделать чат-бота для клиентов или сотрудников.\n\nГотовые примеры: [аналитика воронки продаж](.\u002Frecipes\u002Fcrm-analytics.md), [Telegram-бот для CRM](.\u002Frecipes\u002Ftelegram-bot.md), [массовая рассылка по контактам](.\u002Frecipes\u002Fmass-messaging.md), [автоматизация задач](.\u002Frecipes\u002Ftask-automation.md), [синхронизация с 1С\u002FERP](.\u002Frecipes\u002Ferp-sync.md).\n\nДля разработчика и AI-модели: [работа с данными](.\u002Fentity-api.md), [фильтрация](.\u002Ffiltering.md), [Batch API](.\u002Fbatch.md), [оптимизация](.\u002Foptimization.md), [инфраструктура](.\u002Finfra.md), [коды ошибок](.\u002Ferrors.md).\n","2026-07-22",{}]