Simplafy
Desarrolladores

Construye con el Simplafy Hub.

Cuatro puertas para conectar el Hub a tu sistema, a tu asistente de IA y a tu código: conversar con los agentes, enviar datos, operar el Hub entero y publicar agentes como código.

Abrir en ChatGPTAbrir en Claude

Qué puerta usar

1 · MCP — el Hub entero dentro de tu asistente de IA

Para qué sirve.Conecta ChatGPT, Claude o cualquier cliente MCP al Hub y opera todo conversando: contactos, negocios, embudos, agentes, jornadas, campañas, catálogo, facturas, paneles y más. Todo lo que hace la pantalla, lo hace el MCP.

Cómo empezar
  1. 1En el Hub, ve a Configuración › Asistentes de IA y copia la dirección.
  2. 2Pégalo en tu asistente como servidor MCP (conector personalizado).
  3. 3Entra con tu cuenta del Hub y elige las áreas que puede ver y tocar, solo lectura o lectura y escritura.

¿Prefieres la app oficial? Busca «Simplafy Hub» en la tienda de ChatGPT o en el directorio de Claude.

Dirección del MCP
https://mcp-hub.simplafy.com.br/completo
Pegar en tu asistente
Claude

Configuración › Conectores › Agregar conector personalizado, y pega la dirección.

Claude
https://mcp-hub.simplafy.com.br/completo
ChatGPT

Usa la app oficial «Simplafy Hub» en la tienda de ChatGPT o, en conectores personalizados, pega la dirección.

ChatGPT
https://mcp-hub.simplafy.com.br/completo
Claude Code

En la terminal:

Claude Code
claude mcp add --transport http simplafy-hub https://mcp-hub.simplafy.com.br/completo
Cursor

En ~/.cursor/mcp.json:

Cursor
{
  "mcpServers": {
    "simplafy-hub": {
      "url": "https://mcp-hub.simplafy.com.br/completo"
    }
  }
}
VS Code

En .vscode/mcp.json:

VS Code
{
  "servers": {
    "simplafy-hub": {
      "type": "http",
      "url": "https://mcp-hub.simplafy.com.br/completo"
    }
  }
}
Técnico
  • Transporte: MCP Streamable HTTP (JSON-RPC 2.0).
  • Autenticación: OAuth 2.1 con registro automático del cliente y PKCE. No necesita clave.
  • El asistente nunca tiene más poder que el rol de la persona en la organización.
  • Más de 140 herramientas en el acceso completo.
  • Sesión: el acceso se renueva solo por hasta 30 días; revócalo cuando quieras en Configuración › Mis asistentes.
Permisos por área (hub.<área>.read / hub.<área>.write):
Paneles y BIBandeja de entradaCRMCampañasEjecucionesAgentesJornadasCanalesHerramientasProveedores de IAPlugins y aplicacionesArchivosTabla de DatosCatálogoAdministración

Ver el Hub en ChatGPT y Claude, para quien no es desarrollador →

2 · Agent API — tu sistema conversa con un agente

Para qué sirve.Tu sitio, app o sistema envía una pregunta o una tarea y el agente del Hub responde, con las mismas herramientas, base de conocimiento y reglas que usa en WhatsApp. La respuesta puede venir en texto, en tiempo real, en formato estructurado (JSON) o en archivo, como un PDF generado.

Cómo empezar
  1. 1En el Hub, en Integraciones › Canales, crea un canal Agent API y vincúlale el agente.
  2. 2Elige los comportamientos que quieres usar: Ejecutar, Tiempo real, Estructurado y Archivo. Cada uno activado recibe su dirección, para copiar.
  3. 3Genera el token del canal. Aparece una sola vez; se puede rotar y revocar.
Técnico
Base
https://api-hub-v2.simplafy.com.br/api/v1/agent-api/{nome-do-canal}
  • Autenticación: Authorization: Bearer <token del canal>.
  • Encabezado obligatorio: Idempotency-Key: <id único del pedido>. Repetir el mismo id no ejecuta dos veces.
  • Cuerpo en JSON, hasta 256 KiB: { "input": "texto para el agente, hasta 32 mil caracteres", "data": { …datos opcionales… } }.
RutaQué devuelve
POST /runLa respuesta final: { "version": "1", "requestId", "status": "completed", "text", "parts" }
POST /streamLa respuesta en tiempo real (SSE, eventos AG-UI), con reanudación por Last-Event-ID
POST /structuredUn JSON validado en el formato definido en el canal: { …, "data": {…} }
POST /fileLos archivos que generó el agente: { …, "text", "files": [...] }
POST /openai/v1/chat/completionsCompatible con la API de OpenAI (ej.: para conectar ElevenLabs al agente)
Ejemplo · cURL
curl -X POST https://api-hub-v2.simplafy.com.br/api/v1/agent-api/meu-canal/run \
  -H "Authorization: Bearer $TOKEN_DO_CANAL" \
  -H "Idempotency-Key: pedido-123" \
  -H "Content-Type: application/json" \
  -d '{"input":"Qual o prazo de entrega para Brasília?","data":{"pedido":"123"}}'
Errores

Siempre en el mismo formato:

Formato del error
{ "version": "1", "requestId": "…", "error": { "code": "INVALID_TOKEN", "message": "…", "retryable": false } }
HTTPcodeCuando
400INVALID_REQUESTCuerpo inválido, sin Idempotency-Key, campo distinto de input/data o mayor de 256 KiB
401INVALID_TOKENToken ausente o incorrecto
403BEHAVIOR_DISABLEDEste comportamiento está desactivado en el canal
404CHANNEL_NOT_FOUNDEl canal no existe
409AGENT_NOT_LINKEDEl canal no está ligado a ningún agente
422NO_FILE_GENERATEDEn la ruta /file, el agente no generó archivo
503AGENT_UNAVAILABLEEl agente está apagado o no disponible (intenta de nuevo)

3 · Webhook de entrada — envía datos al Hub

Para qué sirve.Cualquier sistema, formulario del sitio, n8n, Make o Zapier envía datos al Hub, y el Hub los usa en una Jornada: crear contacto y negocio, mover de etapa, grabar en la Tabla de Datos, avisar al equipo o activar un agente.

Cómo empezar
  1. 1En el Hub, en Integraciones › Webhook, crea el webhook y copia la dirección y el token.
  2. 2En la Jornada, usa el disparador «Webhook» y elige qué hacer con los datos.
Técnico
Ejemplo · cURL
curl -X POST https://api-hub-v2.simplafy.com.br/api/v1/webhooks/in/{orgId}/{caminho} \
  -H "X-Webhook-Token: $TOKEN_DO_WEBHOOK" \
  -H "Content-Type: application/json" \
  -d '{"nome":"Maria","telefone":"+55 61 90000-0000"}'
  • Dirección: https://api-hub-v2.simplafy.com.br/api/v1/webhooks/in/{orgId}/{caminho}. La pantalla la entrega lista, con el ejemplo en cURL.
  • Método POST. Acepta JSON, formulario (form-urlencoded) y multipart con archivo. Funciona directo desde un formulario HTML (CORS).
  • Autenticación: encabezado X-Webhook-Token (o ?token= en la URL). Opcional: Bearer o firma HMAC (X-Webhook-Signature).
  • Se puede cambiar el token y deshacer la eliminación del webhook.

Aún no tiene: validación del formato del cuerpo, lista de IPs permitidas y webhook de salida. Para que el Hub llame a tu sistema, usa el paso «Llamar endpoint» de la Jornada.

4 · ADK — agentes, herramientas y jornadas como códigoBETA

Para qué sirve.Para equipos técnicos y socios: escribe agentes, herramientas (en Python), tablas, jornadas y aplicaciones en archivos, guárdalos en Git, valida en tu máquina y publica en el Hub con un comando. Lo que ya está en el Hub también se puede exportar a archivos.

Cómo empezar
Terminal
npx @simplafy-tec/adk doctor          # confere o ambiente
npx @simplafy-tec/adk login           # entra com a conta do Hub
npx @simplafy-tec/adk init tool minha-tool && cd minha-tool
npx @simplafy-tec/adk build           # valida e procura segredo vazado
npx @simplafy-tec/adk deploy --org <orgId>
Técnico
  • Paquete @simplafy-tec/adk en npm (Node 20 o superior). Comandos: doctor, login/logout, init tool/mcp/app, build, test, dev, validate, plan, deploy, status, export, mcp-server.
  • Login por OAuth del Hub (queda guardado en la máquina y se renueva solo). Para CI: ADK_TOKEN + --org.
  • Publica en el orden herramienta → agente → jornada; lo que falla no tumba el resto y sale en un informe.
  • plan muestra lo que va a cambiar antes de aplicar; export trae del Hub lo que ya existe; status lista lo que quedó pendiente.
  • El build rechaza secretos en el código: la credencial queda en el Hub y se cita por el nombre.

Versión 0.1.0. La documentación completa del ADK aún se está escribiendo.

Ayuda y estado