Авторизация и токены
Как выдать программе доступ к GetMyBot: создать персональный токен, выбрать кабинет и разрешить только нужные операции.
На этой странице
Персональный токен даёт программе доступ к GetMyBot без передачи вашего пароля. В документации он называется PAT (Personal Access Token). Например, для чтения списка ботов достаточно разрешения bots:read, а для создания реакций нужно reactions:write.
При создании выберите один кабинет и нужные разрешения, области доступа (scopes). Токен работает только в этом кабинете и не даёт больше прав, чем есть у вашего аккаунта. Для первого запроса см. Быстрый старт API.
Создание токена
Персональный токен создаётся в личном кабинете, в разделе персональных токенов. Значение токена показывается один раз при создании: сохраните его в надёжном месте. На сервере токен хранится только в хешированном виде, восстановить его нельзя; если потеряли: выпустите новый и удалите старый.
Все персональные токены начинаются с префикса mbp_.
Передача токена
Токен передаётся в каждом запросе HTTP-заголовком Authorization по схеме Bearer:
Authorization: Bearer <ПЕРСОНАЛЬНЫЙ_ТОКЕН>
Вместо <ПЕРСОНАЛЬНЫЙ_ТОКЕН> (вместе с угловыми скобками) вставьте токен целиком, ровно в том виде, как он был показан, вместе с префиксом mbp_. Отдельно mbp_ добавлять не нужно: префикс уже входит в токен. MCP-сервер принимает только персональный токен; API-токен проекта (mb_live_…) к нему не подходит.
Тот же заголовок используется и для сессионного доступа из веб-кабинета (там это короткоживущий JWT), но для интеграций используйте именно персональный токен mbp_….
Кабинет токена
Токен работает ровно в одном кабинете. По умолчанию это ваш собственный; если вам выдали доступ к чужому кабинету, при создании токена можно выбрать его: в API это поле account_id в теле POST /api/tokens, в кабинете: выпадающий список над сроком действия. Список доступных кабинетов отдаёт GET /api/account/cabinets.
Что это значит на практике:
GET /api/botsпод таким токеном возвращает боты выбранного кабинета: ни ваших собственных, ни третьего кабинета в списке не будет.- Обращение к боту другого кабинета отвечает
404, как к чужому боту: по токену нельзя проверить, существует ли идентификатор за пределами его кабинета. - Права остаются вашими: токен не расширяет доступ, а ограничивает его одним кабинетом. Что именно можно делать с ботом, решают права участника (роль в кабинете плюс права на отдельного бота).
- Токен, выпущенный для чужого кабинета, действует с вашими правами в этом кабинете. Счета кабинета (
/api/billing/*) читаются только с правом кабинетаbilling.read, создание проектов: с правомbots.create. Полный доступ токена (область*) прав кабинета не даёт. - Если доступ к кабинету отозвали, токен перестаёт работать сразу, со следующего запроса: отзывать его отдельно не нужно.
Кабинет, доступный через бота
GET /api/account/cabinets показывает у каждого кабинета поле source:
self: ваш собственный кабинет;account: вам выдан доступ к кабинету, права определяет роль;bot: вам дали доступ только к отдельному боту в этом кабинете. Прав на кабинет целиком у вас нет.
С кабинетом source: "bot" работают операции с этим ботом в пределах прав на отдельного бота, а всё, что относится к кабинету целиком, отклоняется: подключение бота, биллинг и т.п. REST отвечает 403 с {"error":"missing cabinet right"}, а если участник есть, но нужного права нет: missing cabinet right: <право>. В MCP это ошибка инструмента permission denied: missing cabinet right (например, connect_bot требует bots.create, инструменты биллинга: billing.read или billing.write).
Чтобы это исправить, владелец кабинета приглашает вас в карточке «Доступ к кабинету» с нужным правом. Перевыпускать токен не нужно: он начнёт работать со следующего запроса после того, как вы примете приглашение.
Токены, выпущенные до появления этой возможности, привязаны к вашему собственному кабинету. Если такой токен работал с ботом, расшаренным из чужого кабинета, выпустите для этого кабинета отдельный токен.
Области доступа (scopes)
У токена есть набор областей доступа в формате ресурс:действие. Чтение требует суффикса :read, изменения: :write. Доступные области:
| Область доступа | Что разрешает |
|---|---|
bots:read, bots:write | боты, их настройки, синхронизация, токен бота. |
reactions:read, reactions:write | реакции, импорт, тест формул, связи, порядок. |
labels:read, labels:write | метки подписчиков. |
collections:read, collections:write | коллекции и записи. |
flows:read, flows:write | потоки. |
integrations:read, integrations:write | интеграции, подключения, учётные данные. |
media:write | загрузка в медиабиблиотеку. |
templates:read, templates:write | шаблоны ботов. |
settings:read, settings:write | настройки. |
subscribers:read | подписчики и история диалога (чтение). |
broadcasts:write | рассылки и управление ими. |
stats:read | статистика и аналитика. |
billing:read | баланс и тарифы (чтение). |
Особая область * даёт полный доступ ко всему публичному набору эндпоинтов.
Что доступно по токену, а что нет
Под персональным токеном доступны только конструкторские эндпоинты: те, что «помогают строить бота». Недоступны по PAT (только из веб-сессии): вход и регистрация, мобильные эндпоинты, оплата и пополнение баланса, уведомления, журнал аудита, операторская отправка сообщений в диалог, входящие вебхуки и платёжные коллбэки, WebSocket. Запрос с mbp_-токеном к такому маршруту вернёт 401 или 403.
Если токену не хватает нужной области для конкретного маршрута: вернётся 403. Подробнее про коды: в гайде об ошибках.
Области доступа для функций ИИ-агентов
managed_ai:invokeиmanaged_ai:usage:read: вызовы ИИ через общий интерфейс провайдеров и чтение расхода.copilot:use: работа с предложениями Copilot. Для диагностики достаточноjourney:read, для изменения схемы дополнительно нуженjourney:edit.journey:readиjourney:edit: анализ сценариев и просмотр объяснения их выполнения, функции Flow Intelligence и Explainable Replay.- Управление подключениями Meta использует области доступа интеграций и ботов. Дополнительно проверяются права на кабинет и конкретного бота.
MCP применяет те же проверки: если разрешение не подтверждено, операция отклоняется. Подключение MCP не добавляет токену прав на другие кабинеты или ботов.
Что дальше
- Быстрый старт API: первый запрос с токеном.
- Ошибки: что значат
401и403. - MCP: тот же токен для агентного интерфейса.