Base de conocimiento de GetMyBot

Autorización y tokens

Da acceso a GetMyBot a un programa: crea un token personal, elige una cuenta y permite solo las operaciones necesarias.

En esta página

Un token personal permite que un programa acceda a GetMyBot sin conocer tu contraseña. En esta documentación se llama PAT (Personal Access Token). Por ejemplo, para consultar la lista de bots basta el permiso bots:read, mientras que crear reacciones requiere reactions:write.

Al crearlo, elige una cuenta y los permisos necesarios, llamados ámbitos de acceso (scopes). El token solo funciona en esa cuenta y nunca concede más derechos que los de tu usuario. Para hacer la primera solicitud, consulta el inicio rápido de la API.

Crear un token

Crea el token en Cuenta → Tokens personales. Su valor se muestra una sola vez: guárdalo en un lugar seguro. El servidor solo conserva un hash del token y no puede recuperarlo. Si lo pierdes, crea uno nuevo y elimina el anterior.

Todos los tokens personales empiezan por mbp_.

Enviar el token

Envía el token en cada solicitud mediante el encabezado HTTP Authorization con el esquema Bearer:

Authorization: Bearer <TOKEN_PERSONAL>

Sustituye <TOKEN_PERSONAL>, incluidos los signos < y >, por el token completo tal como se mostró, con su prefijo mbp_. No añadas ese prefijo por separado: ya forma parte del token. El servidor MCP solo acepta tokens personales; un token API de proyecto (mb_live_…) no sirve para MCP.

La sesión del panel web también usa un encabezado Authorization, pero con un JWT de corta duración. Para integraciones, usa un token personal mbp_….

Cuenta del token

Cada token funciona en una sola cuenta. Por defecto es la tuya. Si alguien te dio acceso a otra, puedes elegirla al crear el token: mediante account_id en el cuerpo de POST /api/tokens o mediante la lista desplegable situada encima de la caducidad en el panel. GET /api/account/cabinets devuelve las cuentas disponibles.

Esto implica lo siguiente:

  • GET /api/bots devuelve solo los bots de la cuenta elegida. No incluirá tus propios bots de otra cuenta ni los de una tercera.
  • Una solicitud a un bot de otra cuenta responde 404, igual que una solicitud a un bot ajeno. El token no permite averiguar si existe un ID fuera de su cuenta.
  • Tus derechos siguen siendo los mismos: el token limita el acceso a una cuenta, pero no lo amplía. Lo que puedes hacer con un bot depende de tus derechos como miembro, es decir, del rol en la cuenta y de los permisos específicos para ese bot.
  • Un token emitido para la cuenta de otra persona actúa con tus derechos en esa cuenta. Consultar la facturación (/api/billing/*) exige el derecho de cuenta billing.read, y crear proyectos exige bots.create. El ámbito * no concede derechos de cuenta.
  • Si se revoca tu acceso a esa cuenta, el token deja de funcionar de inmediato, desde la siguiente solicitud. No hace falta revocarlo por separado.

Cuenta a la que accedes mediante un bot

GET /api/account/cabinets incluye un campo source para cada cuenta:

  • self: tu propia cuenta;
  • account: tienes acceso a toda la cuenta y el rol determina tus derechos;
  • bot: solo tienes acceso a un bot compartido de esa cuenta. No tienes derechos sobre la cuenta completa.

Con una cuenta source: "bot" puedes operar sobre ese bot dentro de sus permisos específicos. Las operaciones que afectan a toda la cuenta, como conectar otro bot o consultar la facturación, se rechazan. REST responde 403 con {"error":"missing cabinet right"} o, si eres miembro pero te falta un derecho concreto, missing cabinet right: <right>. En MCP aparece el error de herramienta permission denied: missing cabinet right. Por ejemplo, connect_bot exige bots.create, mientras que las herramientas de facturación requieren billing.read o billing.write.

Para obtener el derecho necesario, el propietario debe invitarte desde Cabinet access en la configuración de acceso. No necesitas crear otro token: una vez aceptada la invitación, el permiso se aplica desde la siguiente solicitud.

Los tokens emitidos antes de que existiera esta opción están vinculados a tu propia cuenta. Si uno de ellos funcionaba con un bot compartido desde otra cuenta, crea un token separado para esa cuenta.

Ámbitos de acceso (scopes)

Los ámbitos usan el formato recurso:acción. Para leer se necesita el sufijo :read; para modificar, :write. Estos son los ámbitos disponibles:

ÁmbitoQué permite
bots:read, bots:writeBots, configuración, sincronización y token del bot
reactions:read, reactions:writeReacciones, importación, prueba de fórmulas, conexiones y orden
labels:read, labels:writeEtiquetas de suscriptores
collections:read, collections:writeColecciones y registros
flows:read, flows:writeFlujos
integrations:read, integrations:writeIntegraciones, conexiones y credenciales
media:writeSubir archivos a la biblioteca multimedia
templates:read, templates:writePlantillas de bots
settings:read, settings:writeConfiguración
subscribers:readLectura de suscriptores e historial de conversaciones
broadcasts:writeDifusiones y su gestión
stats:readEstadísticas y analítica
billing:readLectura del saldo y los planes

El ámbito especial * da acceso a todo el conjunto público de endpoints. Sigue sin ampliar los derechos de tu usuario en la cuenta o en un bot.

Qué permite el token y qué no

Un token personal solo sirve para los endpoints del constructor, los que ayudan a configurar un bot. Se necesita una sesión web para iniciar sesión o registrarse, usar endpoints móviles, pagar o recargar saldo, consultar notificaciones o el registro de auditoría, enviar mensajes como operador en una conversación, recibir webhooks o callbacks de pago y usar WebSocket. Una solicitud con un token mbp_ a esas rutas devuelve 401 o 403.

Si al token le falta el ámbito requerido para una ruta, la respuesta es 403. Consulta los códigos en la guía de errores.

Ámbitos para funciones de agentes de IA

  • managed_ai:invoke y managed_ai:usage:read: llamadas a IA mediante la interfaz común de proveedores y consulta del consumo.
  • copilot:use: trabajo con sugerencias de Copilot. Para diagnóstico basta journey:read; para modificar el esquema del escenario se necesita además journey:edit.
  • journey:read y journey:edit: análisis de escenarios y explicaciones de su ejecución, incluidas Flow Intelligence y Explainable Replay.
  • La gestión de conexiones Meta utiliza los ámbitos de integraciones y bots, además de comprobar los derechos sobre la cuenta y el bot concreto.

MCP aplica las mismas comprobaciones: si no se puede confirmar un permiso, la operación se rechaza. Conectar MCP no da acceso a otras cuentas ni a otros bots.

Qué sigue