Documentación

Crea tus llaves y webhooks en Integraciones. Todo responde en JSON y en español.

API Pública

Cada llave pertenece a tu organización: solo ve y cambia tus propios datos. Envíala en el encabezado Authorization. Si la revocas, deja de funcionar al instante.

curl https://TU-DOMINIO/api/public/v1/agentes -H "Authorization: Bearer mia_..."

Método	Ruta	Qué Hace
GET	/agentes	Lista tus agentes con estado, conversaciones y gasto.
PATCH	/agentes/:id	Cuerpo `{"estado":"activo"\|"pausado"}`. Si el presupuesto se agotó, sigue pausado.
GET	/excepciones?estado=pendiente	Solicitudes que esperan aprobación humana.
PATCH	/excepciones/:id	Cuerpo `{"estado":"aprobada"\|"rechazada"}`.
GET	/auditoria	Últimos 100 eventos del registro de actividad.

Respuestas: {"datos": ...} o {"error": "..."} con código 400, 401, 404 o 500. Cada cambio queda en el registro de actividad.

curl -X PATCH https://TU-DOMINIO/api/public/v1/excepciones/ID -H "Authorization: Bearer mia_..." \
  -H "Content-Type: application/json" -d '{"estado":"aprobada"}'

Webhooks

Registra una URL https:// y elige los eventos. Enviamos un POST con JSON:

{ "evento": "compra_realizada", "fecha": "2026-10-04T12:00:00Z", "datos": { ... } }

agente_publicado: se aprobó una plantilla tuya en el catálogo.
compra_realizada: tu organización activó (contrató) un agente.
resena_nueva: tu organización dejó una reseña.
prueba: el botón “Enviar evento de prueba”.

Firma

El encabezado X-Mercado-Firma: t=TIMESTAMP,v1=FIRMA es un HMAC-SHA256 en hex de TIMESTAMP.CUERPO con tu secreto whsec_.... Rechaza el aviso si no coincide o si tiene más de 5 minutos.

import crypto from "crypto";
function verificar(cuerpo, encabezado, secreto) {
  const { t, v1 } = Object.fromEntries(encabezado.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const esperado = crypto.createHmac("sha256", secreto).update(`${t}.${cuerpo}`).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(esperado));
}

Reintentos y Registro

Responde con un código 2xx en menos de 8 segundos. Si falla, reintentamos hasta 3 veces en total. Cada entrega (exitosa o fallida) aparece en “Últimas entregas” con el número de intentos y el código HTTP.

Servidor MCP (Asistentes de IA)

Controla tu equipo digital desde Claude, ChatGPT, Cursor u otro cliente compatible con MCP. Te pedirá entrar con tu cuenta y autorizar la conexión; el asistente solo ve los datos de tu organización.

https://TU-DOMINIO/mcp

En tu asistente, agrega un conector o servidor MCP personalizado.
Pega la dirección de arriba (usa el dominio donde abres la app).
Entra con tu cuenta y pulsa Permitir.
Pide en lenguaje natural: “¿Qué excepciones tengo pendientes?” o “Pausa a Sofía”.

Herramientas

listar_agentes (lectura): tu equipo con estado y gasto.
cambiar_estado_agente (escritura): pausar o activar.
listar_excepciones (lectura): bandeja de aprobaciones.
resolver_excepcion (escritura): aprobar o rechazar.
ver_catalogo (lectura): plantillas disponibles.