Manual de instalação — Integração Abstra + Bling

A integração entre Abstra e Bling permite que fluxos automatizados na Abstra consultem e movimentem dados da sua conta Bling (produtos, notas fiscais, pedidos, contas a pagar/receber, estoque, etc.) via API v3 do Bling.

Onde a instalação começa

A instalação da integração começa pela Abstra, não pela Central de Extensões do Bling. A autorização do Bling acontece dentro do fluxo de conexão da Abstra, como uma etapa intermediária.

Isso ocorre porque o callback OAuth exige um state assinado emitido pela Abstra com o contexto da sua organização e projeto. Um fluxo iniciado pela Central de Extensões do Bling chega ao callback sem esse state e a conexão não é criada.

Passos no Bling

Não é necessário instalar o app pela Central de Extensões do Bling. A autorização do Bling acontece automaticamente durante o fluxo de conexão da Abstra (veja Passos no Integrador abaixo). Ao clicar em Conectar dentro da Abstra, você será redirecionado ao Bling para fazer login e autorizar o acesso — esse é o único momento em que você interage com o Bling durante a instalação.

Passos no Integrador

Requisitos

Antes de iniciar a integração, garanta que você tem:

• Conta Abstra ativa. Se ainda não tiver, acesse cloud.abstra.io e cadastre-se. Após o cadastro, crie uma Organização e um Projeto (a estrutura Abstra segue Organização → Pasta → Projeto). O passo a passo completo de onboarding está em Welcome to Abstra.

• Conta Bling ativa. O usuário que for autorizar a integração precisa ter acesso, dentro da conta Bling, aos módulos correspondentes às permissões solicitadas pelo app Abstra (Produtos, Notas Fiscais, Contas a Pagar/Receber, Estoque, Pedidos, etc.). Um administrador da conta Bling libera esse acesso em Preferências → Usuários. Se faltar acesso a algum módulo solicitado, a autorização no Bling não conclui.

Fluxo de instalação

1. Acesse o console da Abstra em cloud.abstra.io e abra o projeto no qual deseja usar o Bling.

2. No menu lateral, clique em Connectors e, no topo da tela, em Add connection.

3. Selecione Bling na lista de conectores disponíveis. A Abstra abrirá o diálogo abaixo:

   

   Clique em Authorize.

4. Você será redirecionado ao Bling para fazer login com o usuário que autorizará a integração:

   

   Informe usuário e senha e clique em Entrar.

5. Em seguida, o Bling exibirá a tela "Você autoriza Abstra a acessar sua conta?" com a lista de acessos solicitados. Revise e clique em Autorizar.

6. Após autorizar, você volta automaticamente para o console da Abstra e a conexão Bling aparece listada em Connectors, pronta para uso.

Após a autorização

Com a conexão criada, ela pode ser referenciada em qualquer script do projeto pelo nome escolhido no momento da criação. Exemplo em Python:

from abstra.connectors import run_connection_action

# "bling" é o nome da conexão criada no console
produtos = run_connection_action(
    connection_name="bling",
    action_name="get_produtos",
    params={"pagina": 1, "limite": 100},
)

A lista completa de ações disponíveis (produtos, notas fiscais, pedidos, contas a pagar/receber, estoque, etc.) está no catálogo do conector Bling. Para uma visão geral de como conectores funcionam na Abstra, consulte a documentação de Connectors.

Permissões insuficientes

Se, ao clicar em Autorizar, o Bling exibir erro de falta de acesso a algum módulo, peça ao administrador da conta Bling para conceder acesso a esse módulo em Preferências → Usuários e refaça o fluxo desde o passo 2.

Desinstalar / revogar acesso

Para revogar o acesso da Abstra à sua conta Bling:

• Pelo Bling: acesse Preferências → Integrações → Aplicativos autorizados e revogue o acesso do app Abstra.
• Pela Abstra: no console, abra o projeto, vá em Connectors, localize a conexão Bling e remova-a.

Revogar em qualquer um dos lados interrompe o acesso.

Contato

Em caso de dúvidas sobre a integração ou problemas na instalação, entre em contato com o suporte da Abstra:

• E-mail: help@abstra.app
• Site: abstra.io