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.
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.
- 1En el Hub, ve a Configuración › Asistentes de IA y copia la dirección.
- 2Pégalo en tu asistente como servidor MCP (conector personalizado).
- 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.
https://mcp-hub.simplafy.com.br/completo
Configuración › Conectores › Agregar conector personalizado, y pega la dirección.
https://mcp-hub.simplafy.com.br/completo
Usa la app oficial «Simplafy Hub» en la tienda de ChatGPT o, en conectores personalizados, pega la dirección.
https://mcp-hub.simplafy.com.br/completo
En la terminal:
claude mcp add --transport http simplafy-hub https://mcp-hub.simplafy.com.br/completo
En ~/.cursor/mcp.json:
{
"mcpServers": {
"simplafy-hub": {
"url": "https://mcp-hub.simplafy.com.br/completo"
}
}
}En .vscode/mcp.json:
{
"servers": {
"simplafy-hub": {
"type": "http",
"url": "https://mcp-hub.simplafy.com.br/completo"
}
}
}- 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.
hub.<área>.read / hub.<área>.write):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.
- 1En el Hub, en Integraciones › Canales, crea un canal Agent API y vincúlale el agente.
- 2Elige los comportamientos que quieres usar: Ejecutar, Tiempo real, Estructurado y Archivo. Cada uno activado recibe su dirección, para copiar.
- 3Genera el token del canal. Aparece una sola vez; se puede rotar y revocar.
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… } }.
| Ruta | Qué devuelve |
|---|---|
POST /run | La respuesta final: { "version": "1", "requestId", "status": "completed", "text", "parts" } |
POST /stream | La respuesta en tiempo real (SSE, eventos AG-UI), con reanudación por Last-Event-ID |
POST /structured | Un JSON validado en el formato definido en el canal: { …, "data": {…} } |
POST /file | Los archivos que generó el agente: { …, "text", "files": [...] } |
POST /openai/v1/chat/completions | Compatible con la API de OpenAI (ej.: para conectar ElevenLabs al agente) |
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"}}'Siempre en el mismo formato:
{ "version": "1", "requestId": "…", "error": { "code": "INVALID_TOKEN", "message": "…", "retryable": false } }| HTTP | code | Cuando |
|---|---|---|
| 400 | INVALID_REQUEST | Cuerpo inválido, sin Idempotency-Key, campo distinto de input/data o mayor de 256 KiB |
| 401 | INVALID_TOKEN | Token ausente o incorrecto |
| 403 | BEHAVIOR_DISABLED | Este comportamiento está desactivado en el canal |
| 404 | CHANNEL_NOT_FOUND | El canal no existe |
| 409 | AGENT_NOT_LINKED | El canal no está ligado a ningún agente |
| 422 | NO_FILE_GENERATED | En la ruta /file, el agente no generó archivo |
| 503 | AGENT_UNAVAILABLE | El 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.
- 1En el Hub, en Integraciones › Webhook, crea el webhook y copia la dirección y el token.
- 2En la Jornada, usa el disparador «Webhook» y elige qué hacer con los datos.
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.
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>
- 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.