Base de conocimiento de GetMyBot

Inicio rápido de la API

Cómo obtener la lista de tus bots y crear una reacción desde un programa. Token de acceso, primera solicitud y ejemplos con curl.

En esta página

La API permite que un programa realice operaciones en GetMyBot: consultar tus bots, crear reacciones u obtener datos. Esta guía está dirigida a quien desarrolla una integración. Para configurar un bot sin programar, usa el editor visual.

Primero crearás un token personal, la clave que da acceso a la API. Después enviarás una solicitud HTTP a la dirección de una operación, también llamada endpoint. Los ejemplos usan curl, un comando que se ejecuta en la terminal. Sustituye https://tu-dominio por la dirección de tu instalación de GetMyBot.

Paso 1. Crear un token personal

Abre la sección de tokens personales en tu cuenta y crea un token nuevo (PAT). Cópialo en ese momento: se muestra una sola vez y empieza por mbp_. Al crearlo, selecciona solo los permisos (scopes) necesarios para tus operaciones. La guía de autorización explica estos permisos.

Paso 2. Dirección base y formato

Todos los endpoints REST están bajo /api; la ruta no incluye un número de versión. Los cuerpos de solicitudes y respuestas usan JSON. En las solicitudes que incluyen cuerpo, envía el encabezado Content-Type: application/json.

El token se envía en el encabezado Authorization: Bearer <TOKEN_PERSONAL>. Sustituye <TOKEN_PERSONAL>, incluidos los signos < y >, por el token completo con su prefijo mbp_. No añadas el prefijo una segunda vez.

Paso 3. Primera solicitud: lista de bots

Comprueba el token solicitando la lista de tus bots. Necesitas el permiso bots:read (o *):

curl -H "Authorization: Bearer <TOKEN_PERSONAL>" https://tu-dominio/api/bots

La respuesta será un array JSON de bots. Si el token no es válido o ha caducado, recibirás 401 con un cuerpo como {"error":"..."}. Consulta Errores de la API.

Paso 4. Primera modificación: crear una reacción

Una modificación es una solicitud que cambia datos. Este ejemplo crea una reacción en el bot que elijas. Ejecútalo en un proyecto donde quieras crear esa reacción.

Necesitas el permiso reactions:write. Sustituye BOT_ID por el identificador de un bot del paso 3:

curl -X POST https://tu-dominio/api/bots/BOT_ID/reactions \
  -H "Authorization: Bearer <TOKEN_PERSONAL>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Hola","trigger":{"type":"command","value":"/start"}}'

Si la solicitud tiene éxito, la respuesta incluirá la reacción creada y su id. Encontrarás los campos exactos del cuerpo en la referencia interactiva, que genera ejemplos de curl, JavaScript y Python para cada endpoint.

Paso 5. Continuar con la referencia

Cuando el token funcione, consulta las demás operaciones en la referencia interactiva. Allí se indican las direcciones, los permisos, los campos de cada solicitud y el botón Try it para hacer una prueba.

Primera solicitud a Managed AI

Crea un PAT con el permiso managed_ai:invoke. El valor de Idempotency-Key distingue una operación de otra: si repites la misma solicitud, conserva la clave y el cuerpo; para una operación nueva, utiliza una clave nueva.

curl -X POST https://tu-dominio/api/v1/ai/responses \
  -H "Authorization: Bearer <TOKEN_PERSONAL>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ai-demo-0001" \
  -d '{"profile":"balanced","provider":"auto","input":[{"role":"user","content":[{"type":"input_text","text":"Resume brevemente la conversación"}]}],"max_output_tokens":300}'

Si tu integración muestra funciones de Managed AI o Meta, consulta primero /api/public/capabilities. La respuesta indica si la función está activada en esta instalación. Una función desactivada no es un fallo de red: ocúltala o muestra que no está disponible.

Qué sigue