Conectar um app feito com IA
Criou sua própria ferramenta com Base44, Lovable ou Bolt? Ela pode ler seus clientes e obras e preparar orçamentos no Groundflag. Um rascunho não chega a ninguém até você abrir e enviar.
Crie um token.
No Groundflag, o dono ou um administrador abre Configurações, Configurações de API, e clica em Criar Token. Escolha só o que a ferramenta precisa: clients.read e projects.read para consultar, quotes.write para preparar orçamentos. Copie o token, porque ele aparece uma vez só.
Guarde nos segredos da ferramenta.
Adicione como um segredo chamado GROUNDFLAG_API_TOKEN. No Base44 são os Secrets do app. Nunca cole o token no chat nem no código da página.
Diga o que ela deve fazer.
Cole isto no chat, em 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.
Teste a conexão.
Quando GET /me mostrar sua empresa, o token funciona. Depois peça o que quiser, por exemplo um formulário que envie POST /quotes com uma obra e as linhas.
Revise o rascunho no Groundflag.
Cada rascunho volta com app_url, a página onde você confere as linhas, soma imposto e condições, e envia ao cliente.
O que a API faz
Lê clientes, obras, orçamentos, faturas, pagamentos, tarefas e batidas de ponto. Cria e atualiza clientes, obras e tarefas, recebe leads e prepara orçamentos em rascunho. Os webhooks avisam sua ferramenta quando algo acontece.
Não envia orçamento nem fatura, não registra pagamento e não cobra ninguém. Isso fica no app, com uma pessoa.
Se você usa o Base44
O Base44 chama serviços externos por backend functions, que exigem o plano Builder ou superior. A página Custom integrations dele também importa https://api.groundflag.com/docs/openapi.json, para todos os apps do workspace usarem a mesma conexão. Lá se escolhem até 30 endpoints.
Perguntas
Minha ferramenta diz CORS error ou Failed to fetch.
Ela está chamando o Groundflag pela página do navegador. Peça para passar a chamada a uma backend function. A API só responde a servidores, o que também protege seu token.
Recebo um 403 com insufficient_scope.
O token não tem a permissão indicada em required_scope. Crie um token novo com ela, coloque no segredo e revogue o antigo. Tokens anteriores aos rascunhos não têm quotes.write.
Recebo um 401.
O token está errado, revogado ou faltando. O cabeçalho deve dizer Authorization: Bearer, um espaço e o token.
A API custa à parte?
As chaves de API por empresa fazem parte do plano Business na página de preços, e você pode testar durante o período grátis.
Continue lendo
Dúvidas? Escreva para hello@groundflag.com