База знаний GetMyBot

Авторизация и токены

Как выдать программе доступ к 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 не добавляет токену прав на другие кабинеты или ботов.

Что дальше