Conectar una app hecha con IA
¿Creó su propia herramienta con Base44, Lovable o Bolt? Puede leer sus clientes y trabajos y preparar presupuestos en Groundflag. Un borrador no llega a nadie hasta que usted lo abre y lo envía.
Cree un token.
En Groundflag, el dueño o un administrador abre Configuración, Configuración de API, y hace clic en Crear Token. Elija solo lo que la herramienta necesita: clients.read y projects.read para consultar, quotes.write para preparar presupuestos. Copie el token, porque se muestra una sola vez.
Guárdelo en los secretos de la herramienta.
Agréguelo como un secreto llamado GROUNDFLAG_API_TOKEN. En Base44 son los Secrets de la app. Nunca lo pegue en el chat ni en el código de la página.
Diga qué debe hacer.
Pegue esto en el chat, en inglés: Using a backend function and the GROUNDFLAG_API_TOKEN secret, connect to the API described at https://api.groundflag.com/docs/openapi.json with a Bearer token. Base URL https://api.groundflag.com/api/v1/public. Start by calling GET /me and showing the company name.
Pruebe la conexión.
Cuando GET /me muestre su empresa, el token funciona. Después pida lo que quiera, por ejemplo un formulario que envíe POST /quotes con un trabajo y sus líneas.
Revise el borrador en Groundflag.
Cada borrador vuelve con app_url, la página donde usted revisa las líneas, agrega impuestos y condiciones, y lo envía al cliente.
Qué hace la API
Lee clientes, trabajos, presupuestos, facturas, pagos, tareas y marcaciones. Crea y actualiza clientes, trabajos y tareas, recibe prospectos y prepara presupuestos en borrador. Los webhooks avisan a su herramienta cuando algo pasa.
No envía presupuestos ni facturas, no registra pagos y no cobra a nadie. Eso queda en la app, con una persona.
Si usa Base44
Base44 llama a servicios externos desde backend functions, que requieren su plan Builder o superior. Su página Custom integrations también puede importar https://api.groundflag.com/docs/openapi.json, para que todas las apps del workspace usen la misma conexión. Allí se eligen hasta 30 endpoints.
Preguntas
Mi herramienta dice CORS error o Failed to fetch.
Está llamando a Groundflag desde la página del navegador. Pida que pase la llamada a una backend function. La API solo responde a servidores, lo que también protege su token.
Recibo un 403 con insufficient_scope.
El token no tiene el permiso indicado en required_scope. Cree un token nuevo con ese permiso, póngalo en el secreto y revoque el anterior. Los tokens anteriores a los borradores no tienen quotes.write.
Recibo un 401.
El token está mal, revocado o falta. El encabezado debe decir Authorization: Bearer, un espacio y el token.
¿La API cuesta aparte?
Las claves de API por empresa son parte del plan Business en la página de precios, y puede probarlas durante la prueba gratis.
Siga leyendo
¿Dudas? Escriba a hello@groundflag.com