[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-scopes":3,"docs-tabs-scopes":6},{"content":4,"lastmod":5},"# Скоупы\n\nСкоуп — это разрешение на доступ к части данных Битрикс24 или к разделу платформы Вайбкод. При создании ключа выбирайте минимальный набор скоупов, достаточный для задачи: чем меньше прав у ключа, тем меньше последствий при его компрометации.\n\nСкоупы выбираются в форме создания ключа двумя группами — «Битрикс24» и «Вайбкод». Минимум один скоуп обязателен. Набор скоупов Битрикс24 закрепляется за ключом в момент выпуска. Если добавить скоуп Битрикс24 в настройках уже существующего ключа, `GET \u002Fv1\u002Fme` покажет его в списке, но к данным Битрикс24 ключ продолжит обращаться с исходным набором — запросы, которым нужен новый скоуп, вернут ошибку `BITRIX_ACCESS_DENIED`. Получить новый скоуп Битрикс24 можно, только заново выпустив API-ключ или заново создав приложение (для ключа авторизации) с этим скоупом — порядок описан на странице [Создание ключа](.\u002Fkeys-auth.md).\n\nПошаговый разбор всей формы создания ключа — [Создание ключа](.\u002Fkeys-auth.md).\n\n## Как выбрать скоупы под задачу\n\nБыстрый ориентир: какие скоупы нужны под типовой сценарий приложения.\n\n| Задача | Скоупы |\n|--------|--------|\n| Дашборд по сделкам, контактам, компаниям | `crm`, `user` |\n| Отправка сообщений и уведомлений в чат (`POST \u002Fv1\u002Fnotifications`, `POST \u002Fv1\u002Fchats\u002F:dialogId\u002Fmessages`) | `im` |\n| Публикации в Живую ленту (`POST \u002Fv1\u002Fposts`) | `log` |\n| Чат-бот в мессенджере портала | `imbot`, `im` |\n| Управление задачами | `task`, `tasks`, `user` |\n| Рабочие группы и проекты | `sonet_group` |\n| Работа с файлами на Диске | `disk` |\n| Интернет-магазин: заказы и каталог | `sale`, `catalog` |\n| Телефония и журнал звонков | `telephony`, `call` |\n| Календарь и события сотрудников | `calendar`, `user` |\n| Профили сотрудников и оргструктура | `user`, `department` |\n| Собственное хранилище данных приложения | `entity` |\n| Бизнес-процессы и автоматизация | `bizproc` |\n\nЕсли в сценарии участвует несколько модулей — укажите несколько скоупов.\n\n## Полная таблица скоупов Битрикс24\n\nПолный перечень скоупов Битрикс24.\n\n| Скоуп | Что открывает |\n|-------|---------------|\n| `crm` | Сделки, лиды, контакты, компании, счета и другие сущности CRM |\n| `task` | Задачи. Для работы с задачами выберите вместе с `tasks` |\n| `tasks` | Задачи, подзадачи, чек-листы, комментарии, учёт времени. Для работы с задачами выберите вместе с `task` |\n| `im` | Отправка и чтение сообщений в чатах |\n| `imbot` | Регистрация и управление чат-ботами |\n| `imopenlines` | Открытые линии: обращения клиентов |\n| `imconnector` | Коннекторы для внешних мессенджеров (открытые линии) |\n| `call` | Управление звонками и телефонией |\n| `telephony` | Интеграция с внешней телефонией и управление звонками |\n| `bizproc` | Запуск и управление бизнес-процессами |\n| `calendar` | Доступ к календарям и событиям сотрудников |\n| `timeman` | Учёт рабочего времени и контроль посещаемости |\n| `catalog` | Работа с торговым каталогом и товарами |\n| `sale` | Заказы, оплаты, доставки — модуль интернет-магазина |\n| `lists` | Универсальные списки и элементы списков |\n| `disk` | Загрузка, скачивание и управление файлами на Диске |\n| `entity` | Пользовательское хранилище данных приложения |\n| `user` | Профили пользователей — полный набор полей |\n| `user_basic` | Профили пользователей — сокращённый набор полей |\n| `user_brief` | Профили пользователей — минимальный набор полей |\n| `user.userfield` | Пользовательские поля пользователей |\n| `department` | Структура компании и подразделения |\n| `landing` | Управление сайтами и посадочными страницами |\n| `documentgenerator` | Генерация документов по шаблонам |\n| `sign.b2e` | Электронная подпись документов между сотрудником и компанией |\n| `sonet_group` | Рабочие группы и проекты соцсети |\n| `log` | Живая лента: публикации, комментарии, реакции |\n| `vote` | Работа с опросами и голосованиями |\n| `ai_admin` | Администрирование AI-сервисов Битрикс24 |\n| `biconnector` | Бизнес-аналитика и подключение внешних BI-систем |\n| `booking` | Управление бронированиями и расписанием |\n| `delivery` | Настройка и управление службами доставки |\n| `pay_system` | Настройка и управление платёжными системами |\n| `main` | Базовые сервисные методы портала: настройки, события |\n| `placement` | Встраивание интерфейсов в разные места Битрикс24 |\n| `userfieldtype` | Регистрация собственных типов пользовательских полей |\n| `humanresources` | Оргструктура: подразделения, команды, сотрудники |\n| `mail` | Почтовые ящики, письма, отправители |\n| `contact_center` | Контакт-центр: размещение плитки приложения (коннекторы открытых линий). Нужен для placement `CONTACT_CENTER` |\n\n## Скоупы платформы Вайбкод\n\nСкоупы платформы Вайбкод управляют доступом к разделам самой платформы, а не к данным Битрикс24.\n\n| Скоуп | Что открывает |\n|-------|---------------|\n| `vibe:infra` | Управление серверами, тоннелями и инфраструктурой |\n| `vibe:ai` | Доступ к AI-моделям платформы |\n| `vibe:feedback` | Отправка обратной связи через API |\n| `vibe:search` | Веб-поиск по внешним источникам через платформу |\n| `vibe:storage` | Файловое хранилище платформы: загрузка и хранение объектов |\n\n### Зарезервированные скоупы\n\nВо вкладке «Вайбкод» формы есть ещё три скоупа — `vibe:security`, `vibe:analytics`, `vibe:airouter`. В форме они отмечены и недоступны для изменения, отдельно выбирать их не нужно.\n\n| Скоуп | Назначение |\n|-------|------------|\n| `vibe:security` | Сканирование серверов и управление безопасностью |\n| `vibe:analytics` | Доступ к аналитике API-вызовов и статистике |\n| `vibe:airouter` | Управление AI-провайдерами, моделями и учётными данными |\n\n## Скоупы, которые выдаются автоматически\n\nЧетыре скоупа платформы добавляются к каждому личному ключу автоматически — выбирать их в форме не нужно:\n\n- `vibe:infra`\n- `vibe:ai`\n- `vibe:search`\n- `vibe:storage`\n\nСкоуп `vibe:feedback` автоматически не выдаётся — отметьте его в форме, если ключу нужна отправка обратной связи через API.\n\n## Скоупы менеджмент-ключа\n\nМенеджмент-ключ использует отдельный набор скоупов (`vibe:mgmt:keys`, `vibe:mgmt:portals`, `vibe:mgmt:feedback`) и не имеет доступа к данным Битрикс24. Полное описание — [Менеджмент-ключи](.\u002Fmanagement-keys.md).\n\n## Смотрите также\n\n- [Создание ключа](.\u002Fkeys-auth.md)\n- [Быстрый старт](.\u002Fquickstart.md)\n- [Менеджмент-ключи](.\u002Fmanagement-keys.md)\n- [Справочник сущностей](.\u002Fentity-api.md)\n","2026-07-07",{}]