Build an integration for Advancez
Advancez is closed on the inside, but anyone can build a real integration without seeing a single line of our code — you just describe your integration with the format below. We review every proposal before it reaches a real user.
What Advancez already gives you — don't add it
Your contribution doesn't need to bring this: the platform provides it and your app inherits it. Focus only on your feature/UX.
AI / models
You use Walke, the platform's AI — free and built in.
Payment gateway
You charge through Advancez billing, no Stripe to set up.
Sign-up / login / auth
The user is already logged in; you inherit their session.
Notifications
You trigger the platform's.
Storage / database
You save with Advancez storage.
Translation / i18n
The platform translates your UI on its own.
Widgets, shortcuts and Control Center
You don't code them: the USER creates them by prompt over your app (create/edit/hide/delete), no limit.
Floating use in chat
Your app can be used floating in the AI conversation instantly, no extra work.
The 10 surfaces
Your integration declares ONCE which of these parts of the app it wants to use — the rest is generated automatically, you don't program each one by hand.
etiqueta
Shows up as a real search tag, with its own results.
widget
A background widget, visible without opening anything.
chat
A bot the user can talk to in Chats.
configuracion
A section in Settings/Control Center.
app-menu
Its own app in the main menu.
atajo-barra
A direct shortcut inside the bar.
conversacional
The AI opens it on its own from text/voice, without touching the menu.
destacado-perfil
A highlight on the user's profile.
modalidad-publicacion
One more field in the Advz composer.
Manifest format
{
id: "mi-integracion",
nombre: "Mi Integración",
autor: "Tu nombre o tu equipo",
categoria: "Comercio directo", // o Pagos, Comunicación, Seguridad, etc.
descripcion: "Qué hace, en una oración.",
abierta: true, // código abierto o cerrado — afecta el reparto de ingresos
superficies: [
{ tipo: "etiqueta", label: "...", descripcion: "...", resultados: [...] },
{ tipo: "chat", nombreBot: "...", inicial: "..", color: "...", saludo: "...", respuestasDemo: [...] },
],
}API v1 — usar y contribuir desde afuera
Base: https://advancez.app · JSON · CORS abierto (podés llamarla desde una extensión, un IDE, un CLI o un gateway de borde). Las lecturas públicas no piden nada. Lo que escribe o consume IA pide Authorization: Bearer <token>.
Sandbox con datos falsos: reemplazá /api/129 por /api/83/2 (y /api/127 por /api/83/1). Mismas rutas, métodos y formas de respuesta; cualquier Bearer advz_sandbox vale; nada se guarda de verdad (memoria efímera por token) y todo viene con "sandbox": true. Probá tu integración sin cuenta, sin IA y sin tocar producción.
Cómo conseguir el token, honesto: hoy el puente valida un token de plataforma (lo configura Advancez); los tokens por usuario llegan con "Continue with Advancez". Pedilo con el formulario de abajo (decí para qué) o mirá /api/129/1, que declara el modo actual (y en local expone un token de demo).
GET/api/129/1público
Health del puente: hora, endpoints, cómo autenticar, versión mínima de la app.
Respuesta: { "ok": true, "api": "v1", "auth": "…", "endpoints": { … }, "docs": "…" }
curl -s -X GET "https://advancez.app/api/129/1"
GET/api/129/2público
Lista de publicaciones públicas (ids + fecha), las mismas que indexan los buscadores.
Query: limite — opcional, por defecto 100, máximo 500
Respuesta: { "ok": true, "total": 12, "posts": [{ "id": "…", "creado_en": "…" }] }
curl -s -X GET "https://advancez.app/api/129/2"
GET/api/129/2?id=<id>público
Una publicación pública con sus comentarios.
Respuesta: { "ok": true, "post": { … }, "comentarios": [ … ] } · 404 si no existe
curl -s -X GET "https://advancez.app/api/129/2?id=<id>"
GET/api/129/3público
Integraciones de la comunidad vivas (aprobadas en Advancez Center).
Respuesta: { "ok": true, "integraciones": [{ "id", "nombre", "autor", "categoria", "superficies" }] }
curl -s -X GET "https://advancez.app/api/129/3"
POST/api/129/7token
Usar la IA de Advancez (Walke) desde tu IDE, extensión o CLI.
Reenvía a la misma inteligencia de la barra (rotación de modelos). Consume cuota del servidor: por eso pide token. 503 si la IA no está configurada o sin cupo.
prompt: string (o mensajes: [{ role, content }])tarea: opcional: chat | codigo | creativo | resumennivel: opcional 1-100
Respuesta: { "ok": true, "respuesta": "…", "modelo": "…" }
curl -s -X POST "https://advancez.app/api/129/7" \
-H "Authorization: Bearer $ADVANCEZ_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt":"<prompt>"}'POST/api/129/8token
Enviar una propuesta de integración (entra a la misma cola que este formulario).
Advancez Center la revisa y publica; queda viva para todos sin redeploy. Rate limit 10/min.
nombre: stringdescripcion: stringautor: opcional stringcategoria: opcional: Pagos | Voz e IA | Comunicación | Mundos 3D | Automatización | Comercio directo | Seguridadsuperficies: opcional [] (ver las 10 superficies)abierta: opcional boolean (código abierto)contacto: opcional string
Respuesta: { "ok": true, "recibido": true, "ticketId": "…", "estado": "…", "mensaje": "…" } (201)
curl -s -X POST "https://advancez.app/api/129/8" \
-H "Authorization: Bearer $ADVANCEZ_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"nombre":"<nombre>","descripcion":"<descripcion>"}'GET/api/129/4token
Advancez Connected: listar dispositivos registrados.
Respuesta: { "ok": true, "dispositivos": [ … ] }
curl -s -X GET "https://advancez.app/api/129/4" \ -H "Authorization: Bearer $ADVANCEZ_API_TOKEN"
POST/api/129/4token
Registrar un dispositivo (sensor, POS, máquina, gateway).
Sobre esto se monta un gateway de borde que traduce MQTT / Modbus / OPC-UA / BACnet a estas rutas REST.
nombre: stringtipo: opcional stringprotocolo: opcional: mqtt | modbus | opcua | bacnet | httpmetadata: opcional {}
Respuesta: { "ok": true, "dispositivo": { "id": "…" }, "siguiente": { "telemetria": "POST /api/129/5", "acciones": "GET /api/v1/6?deviceId=…" } } (201)
curl -s -X POST "https://advancez.app/api/129/4" \
-H "Authorization: Bearer $ADVANCEZ_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"nombre":"<nombre>"}'GET/api/129/5token
Últimas lecturas (de un dispositivo o de todos).
Query: deviceId — opcional · limit — opcional, por defecto 100, máximo 500
Respuesta: { "ok": true, "telemetria": [{ "deviceId", "clave", "valor", "hora" }] }
curl -s -X GET "https://advancez.app/api/129/5" \ -H "Authorization: Bearer $ADVANCEZ_API_TOKEN"
POST/api/129/5token
Empujar una lectura (temperatura, estado, ventas…).
deviceId: stringclave: stringvalor: number | string
Respuesta: { "ok": true, "lectura": { … } } (201)
curl -s -X POST "https://advancez.app/api/129/5" \
-H "Authorization: Bearer $ADVANCEZ_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"deviceId":"<deviceId>","clave":"<clave>","valor":1}'GET/api/129/6token
Acciones pendientes para un dispositivo (el fierro pregunta “¿qué hago?”).
Query: deviceId — obligatorio · todas — opcional 1 = incluir entregadas/hechas
Respuesta: { "ok": true, "acciones": [{ "id", "accion", "params", "estado" }] }
curl -s -X GET "https://advancez.app/api/129/6?deviceId=<id>" \ -H "Authorization: Bearer $ADVANCEZ_API_TOKEN"
POST/api/129/6token
Encolar una acción para un dispositivo.
deviceId: stringaccion: stringparams: opcional {}
Respuesta: { "ok": true, "accion": { "id": "…", "estado": "pendiente" } } (201)
curl -s -X POST "https://advancez.app/api/129/6" \
-H "Authorization: Bearer $ADVANCEZ_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"deviceId":"<deviceId>","accion":"<accion>"}'PATCH/api/129/6token
Marcar una acción como entregada / hecha (o volverla a pendiente).
id: stringestado: entregada | hecha | pendiente
Respuesta: { "ok": true }
curl -s -X PATCH "https://advancez.app/api/129/6" \
-H "Authorization: Bearer $ADVANCEZ_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id":"<id>","estado":"<estado>"}'GET/api/129/9público
Walke para desarrolladores: cómo preguntarle (token), el servidor MCP y el catálogo de herramientas (esquemas tool-use de la barra).
Respuesta: { "ok": true, "walke": { "preguntar": {…}, "mcp": {…}, "buscarWeb": {…} }, "herramientas": [{ "name", "description", "input_schema" }] }
curl -s -X GET "https://advancez.app/api/129/9"
POST/api/127público
Servidor MCP de Advancez (JSON-RPC 2.0, transporte Streamable HTTP sin estado). Tools: buscar, publicar, comprar-redirect.
Agregalo en Claude / Cursor / VS Code / n8n con { "url": `${URL_PLATAFORMA}/api/mcp` }. `buscar` y `comprar-redirect` son públicos; `publicar` usa el Bearer de sesión del usuario (RLS manda). GET responde 405 (sin stream SSE).
jsonrpc: "2.0"id: numbermethod: initialize | ping | tools/list | tools/callparams: opcional { name, arguments }
Respuesta: { "jsonrpc": "2.0", "id": 1, "result": { "tools": [ … ] } }
curl -s -X POST `${URL_PLATAFORMA}/api/mcp` \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"buscar","arguments":{"consulta":"cacao","limite":5}}}'Espejos del código: la fuente vive en GitHub (repo privado hoy; el espejo b replica main y las ramas) y, en cada push a main, un workflow lo publica en Radicle (git P2P sin dueño, resistente a caídas y censura). El RID se publica acá apenas la identidad de la flota quede configurada (honesto: todavía no está).
Todo esto es real y está en producción: /api/129/7 usa la misma IA que la barra, /api/129/8 entra a la cola que Advancez Center publica sin redeploy, y devices / telemetry / actions son el modelo de Advancez Connected. Los canales (Telegram/WhatsApp/Twilio) y las apps por conversación se manejan desde la app con tu sesión, no por este puente.
Reportar un bug (con recompensa)
Sin cuenta. Si se verifica, se paga según esta escalera (por Wallet, Stripe o cripto, lo que elijas). La lista de bugs es pública en Advancez Center; tu contacto no.
una función no hace lo que dice. La severidad final la fija la verificación.
Revenue share — 60% for you
Whoever integrates into the ecosystem earns 60% of the revenue their integration generates within the platform. Open-source integrations get additional benefits on top of that.
- You can contribute apps, widgets, shortcuts, search tags, settings and practically any part of the ecosystem (see “The 10 surfaces” above).
- Advancez provides the infrastructure, the AIs and the users. You don't need your own cloud, API keys, or to bring your own audience — you just plug in your piece.
- You get paid for the real usage your integration generates, without handling billing or payment infrastructure.
Usage and the split are computed on real activity within the platform. In this demo the payment is simulated (it moves no real money); the 60/… split mechanics are the final ones.
Build your manifest with Walke
Hi! I'm Walke. What's your integration called?