Для AI-агентов: markdown этой страницы — /docs-content/partner-connect/registration.md индекс документации — /llms.txt
Регистрация приложения и права
Как зарегистрировать приложение Connect в кабинете Вайбкод, какие платформенные права оно может получить и что снимает отметку «проверено».
Регистрация в кабинете
Клиент регистрируется самостоятельно в кабинете Вайбкод — раздел Connect-приложения, боковое меню, группа «Доступ». Войдите под учётной записью Вайбкод и нажмите «Зарегистрировать приложение» — client_id выдаётся сразу, без заявки и предварительной проверки.
В форме заполняются:
- Название и краткое описание приложения.
- Идентификатор — строчные латинские буквы, цифры и дефис.
- Один или несколько
redirect_uri— адресаhttps://либо локальные127.0.0.1,localhostи[::1]поhttpилиhttps. - Запрашиваемые права доступа.
Набор прав не может быть пустым: регистрация без единого права возвращает EMPTY_SCOPES. Приложение без прав не может запросить у пользователя ничего.
Тип клиента выбирается при создании и позже не меняется — разбор с примерами в разделе Типы клиента.
client_secret показывается один раз при создании. Прочитать его повторно нельзя, только перевыпустить действием «Обновить секрет».
В ⋮-меню карточки приложения есть два помощника: «Собрать ссылку» — конструктор ссылки авторизации (выбор redirect_uri и прав, готовый URL и curl для обмена кода, для клиента без секрета — одноразовая пара строк PKCE), и «Как увидит клиент» — предпросмотр страницы согласия ровно в том виде, в каком её увидит пользователь, включая отметку о проверке.
Число активных клиентов на одного пользователя ограничено. При достижении предела регистрация возвращает CLIENT_LIMIT_REACHED, текущее значение приходит в поле limit. Деактивация клиента освобождает место.
Новое приложение получает статус «непроверенное» — пользователь видит эту отметку на странице согласия. Повысить статус может платформенный администратор, запрос отправляется действием «Запросить верификацию» в карточке приложения. Заявку принимают, когда у приложения:
- адрес сайта на
https. - у конфиденциального клиента — хотя бы один публичный
redirect_uri, не на localhost. - хотя бы одно действующее подключение пользователя.
- описание не короче 20 символов.
Если условие не выполнено, заявка отклоняется кодом VERIFICATION_REQUIREMENTS_NOT_MET, а недостающие пункты приходят в поле missingRequirements. Заявку могут отклонить с причиной — она приходит владельцу приложения, и после правок заявку подают заново.
Управление приложениями портала
Администратор выбранного портала видит приложения всех сотрудников в профиле на вкладке «Все приложения портала»: подключения, запросы к AI и долю лимита. В разделе «AI-модели» доступна разбивка «По приложениям».
«Разрешить ИИ» одобряет ожидающий запрос или выдаёт разрешение без запроса. Само разрешение не создаёт ключ: сотрудник повторяет подключение. «Запретить ИИ» закрывает вызовы моделей, сохраняя остальные права ключа. «Отключить для всех» отзывает все ключи приложения на этом портале и производные токены. Расход за текущий период остаётся в статистике.
Управление доступно, когда на платформе включено разрешение AI администратором портала. Ключи других порталов не затрагиваются.
Платформенные права
Права Вайбкод открывают разделы самой платформы, а не данные Битрикс24. Для приложения Connect они делятся на три группы.
vibe:ai приложение запрашивает само. Отметьте его в правах при регистрации — там же, где права Битрикс24, — и дальше оно идёт обычным путём: передаётся в параметре scope у /v1/connect/authorize, показывается пользователю на странице согласия строкой «AI-модели» и приходит на выданный ключ. Заявки и проверки для этого не нужно. Расход покрывает месячный AI-лимит аккаунта, к которому подключается приложение.
Автоматически право не добавляется: приложение, которое его не отметило, работает без доступа к AI-роутеру, а уже выданные ключи набор прав не меняют. Чтобы открыть AI существующему подключению, отметьте право в карточке приложения и проведите пользователя через согласие заново — он получит новый ключ.
vibe:search (веб-поиск /v1/search), vibe:infra, vibe:feedback, vibe:onec и vibe:connectors выдаёт платформенный администратор. При саморегистрации запрос с ними отклоняется кодом SCOPE_NOT_ALLOWED. Порядок — три шага, и первые два делает владелец приложения:
- Отправьте заявку действием «Запросить верификацию» в карточке приложения.
- Напишите в ленте «Обсуждение с платформой» той же карточки, какое право нужно и для какого сценария. Отдельного поля «запрашиваю право» в заявке нет, поэтому без сообщения проверяющий видит только заявку на значок.
- Администратор выдаёт право проверенному приложению. Верификация сама по себе прав не открывает — это два разных решения, и первое является условием второго.
После выдачи право ведёт себя как vibe:ai: передаётся в scope, показывается на странице согласия, приходит на ключ.
vibe:storage и vibe:artifacts приложению Connect не выдаются. Ключ, выданный через Connect, попадает в ту же область хранилища, что и личные ключи подключившего пользователя в этом аккаунте Битрикс24. С этим правом приложение видело бы все файлы, загруженные его личными ключами. vibe:artifacts закрыт по той же причине: опубликованный артефакт попадает в ту же общую область. Запрос с этими правами при саморегистрации отклоняется кодом SCOPE_NOT_ALLOWED, а в режиме PERSONAL их не выдаёт и платформенный администратор. Приложению в режиме COMPANY платформенный администратор может выдать vibe:storage — см. Подключение Компании; vibe:artifacts не выдаётся приложению Connect ни в одном режиме.
Что снимает отметку «проверено»
Отметка держится на том, каким приложение прошло проверку, поэтому правка пяти полей возвращает статус «непроверенное»:
- название,
- описание,
- логотип,
- адреса возврата
redirect_uri, - набор запрашиваемых прав.
Адрес сайта на отметку не влияет. Повторное сохранение того же описания отметку не снимает. Отсутствие описания и пустая строка равнозначны.
Кабинет предупреждает до сохранения: форма показывает подтверждение с перечнем полей, из-за которых отметка будет снята. Без подтверждения правка не сохраняется, ответ — VERIFICATION_RESET_NOT_CONFIRMED с тем же перечнем в теле.
Заполнение пустого набора прав отметку не снимает, если администратор приложению права не выдавал или выбранные права укладываются в выданный им набор.
Сброс касается только отметки. Выданные ключи, подключённые пользователи, платформенные права и разрешённый вход по коду устройства сохраняются. Заявку на проверку подают заново.