Что вы получаете
Один раз настроили OAuth — работаете с порталом любого клиента Битрикс24.
Один поток для всех клиентов
Один поток для всех клиентов
Реализуете OAuth-flow один раз — работаете с порталом любого клиента Битрикс24. Не нужно настраивать вебхуки отдельно под каждого: клиент сам подтверждает доступ через одну кнопку.
Стандартный OAuth, ничего не изобретаете
Стандартный OAuth, ничего не изобретаете
Authorization Code — тот же поток, что у Google и GitHub. Любой OAuth-фреймворк подходит. State против CSRF, секрет (если он есть) только на сервере, ключ можно отозвать.
Точечный доступ, а не «всё сразу»
Точечный доступ, а не «всё сразу»
Запрашивайте только то, что нужно фиче: CRM, задачи, телефония, диск, AI. Корпоративный безопасник видит конкретные права, а не «полный доступ к порталу».
Вайбкод API под капотом
Вайбкод API под капотом
Один ключ открывает 300+ методов Вайбкод API: 50 сущностей с CRUD, batch до 50 вызовов, MongoDB-стиль фильтры, авто-пагинация. Не сырой REST Битрикс24.
Как это работает
Стандартный OAuth Authorization Code — тот же поток, что у Google и GitHub.
Редирект на согласие
Перенаправляете пользователя на /v1/connect/authorize с client_id, redirect_uri и нужными скоупами. У приложения без секрета туда же идёт code_challenge.
Пользователь подтверждает
Клиент видит страницу согласия, выбирает портал Битрикс24 и подтверждает запрошенный список прав целиком.
Код возвращается
Битрикс24 Вайбкод перенаправляет клиента обратно на ваш redirect_uri с параметрами code и state.
Обмен на ключ
Сервер делает POST /v1/connect/token с кодом и получает постоянный API-ключ Вайбкод. С секретом — client_secret, без секрета — та самая одноразовая пара строк.
Для любых приложений
Серверный сервис, мобильное приложение без секрета или устройство без браузера — поток подстраивается под тип клиента.
Серверный сервис
Классический поток: секрет живёт на вашем сервере и никогда не попадает к пользователю.
Мобильное или десктопное приложение
Без секрета: на каждый вход генерируется одноразовая пара строк (механизм PKCE). Возврат — на localhost с любым портом.
Устройство без браузера
Вход по короткому коду. Подключает платформа проверенным приложениям — запросите верификацию в кабинете, вход с устройства включается вместе с ней по запросу.
- Ключ бессрочный — работает, пока его не отзовут
- По умолчанию до 10 приложений на аккаунт
- Клиент управляет доступом сам — отзыв в один клик в его профиле
Что строят партнёры
Три типичных применения OAuth-канала.
Внешний AI-помощник
AI-агент работает в чатах или интерфейсах вашего сервиса с контекстом портала клиента. Видит сделки, задачи, контакты — помогает менеджеру, не выходя из вашего инструмента.
BI и аналитика
Внешний дашборд читает данные портала клиента и строит кастомные отчёты — выручка, конверсия, активность менеджеров. Без копирования данных и ручных выгрузок.
Кросс-системные интеграции
Связка Битрикс24 с внешним CRM, ERP, мессенджерами, маркетинг-системами или Telegram-ботами клиента. Один OAuth-канал — на любое количество клиентских порталов.