O OneBooks é um fornecedor OAuth 2.0. Dois tipos distintos de aplicação podem pedir acesso à sua empresa: as aplicações de parceiros — sistemas de ponto de venda, ferramentas de parceiros e outros produtos criados na plataforma para programadores — e os clientes de IA como o Claude, o ChatGPT e o OpenClaw, que liga a partir do próprio OneBooks. Ambos passam pelo mesmo ecrã de consentimento, recebem apenas os âmbitos que aprovar e podem ser cortados com um clique.
Autorizar uma aplicação
Seção intitulada “Autorizar uma aplicação”Quando uma aplicação pede para se ligar, o OneBooks abre uma página de consentimento com o nome da aplicação e o acesso que pede (por exemplo Ver faturas, Criar e modificar faturas, Ver relatórios financeiros). Inicie sessão se for preciso, escolha a empresa e selecione Aprovar ou Recusar. O acesso fica ligado a essa empresa; se mudar de empresa ativa mais tarde, é preciso um novo consentimento.
Aprovar um dispositivo
Seção intitulada “Aprovar um dispositivo”Algumas aplicações nativas — um programa de computador ou de ponto de venda sem navegador próprio — mostram um código curto em vez de abrirem a página de consentimento. Vá a app.getonebooks.com/device, introduza o código exatamente como aparece e selecione Continuar; depois verifique o nome da aplicação e a empresa e selecione Aprovar. A aplicação dá por isso em poucos segundos; a página avisa quando a ligação estiver feita e pode fechá-la.
Gerir as aplicações ligadas
Seção intitulada “Gerir as aplicações ligadas”Aplicações → Integrações, com o filtro Aplicações ligadas, lista todas as aplicações que autorizou nesta empresa — clientes de IA e aplicações de parceiros — com a data em que o acesso foi concedido e a da última utilização.
- Revogar retira o acesso à aplicação de imediato; os seus tokens deixam de funcionar.
- Revogar não elimina nada do que a aplicação já criou — são documentos normais na sua contabilidade.
- Numa aplicação instalada a partir do Marketplace de aplicações, revogar retira apenas a sua própria autorização. Se mais ninguém na empresa a tiver autorizada, a aplicação é desinstalada, exatamente como se tivesse selecionado Desinstalar — consulte Gerir aplicações instaladas.
Uma aplicação mostra Suspensa pela OneBooks quando a OneBooks suspendeu a aplicação ou a conta do programador, e Já não está disponível quando o programador a eliminou ou desativou, em vez do ponto verde Ligada. Nenhuma delas pode usar o seu acesso, mas pode, mesmo assim, revogá-lo.
Selecione um cartão para ver exatamente o que a aplicação pode fazer e quando foi utilizada pela última vez.
As permissões continuam a aplicar-se
Seção intitulada “As permissões continuam a aplicar-se”Uma aplicação ligada nunca pode fazer mais do que o utilizador que a autorizou: os âmbitos são verificados em cada pedido, e a função e as permissões do utilizador também. Os clientes de IA passam ainda pelo circuito das propostas — consulte Ligar o Claude, o ChatGPT e outros agentes de IA.
Criar uma aplicação
Seção intitulada “Criar uma aplicação”Registe-se no portal para programadores em developer.getonebooks.com para obter credenciais OAuth, empresas de teste, âmbitos e a referência da API — e para publicar a sua aplicação no Marketplace de aplicações.