Principal Integrações Integração com a Bagy

Integração com a Bagy

Última atualização em Mar 19, 2026

1. Integrando com a Bagy

A Bagy é uma plataforma de e-commerce que permite criar e gerenciar sua loja virtual. Ao conectá-la à Secret Solutions, os dados de catálogo e pedidos passam a ser sincronizados automaticamente, centralizando a operação da sua loja em um único lugar.

A integração pode ser realizada de duas formas: via API Token — para quem já utiliza a Bagy e quer conectar rapidamente — ou via Parceria Oficial, para operações de maior escala que exigem acesso completo à API.

2. Opção 1 — Conexão via API Token (recomendado para a maioria dos casos)

Esta é a forma mais rápida de conectar a Bagy à Secret Solutions. Você precisará apenas do API Token gerado no painel da sua loja.

2.1 Obtendo o API Token na Bagy

  1. Acesse o painel da sua loja na Bagy.

  2. Navegue até Configurações > API e Webhooks.

  3. Caso não tenha uma API criada, faça a criação dela, clicando no botão "Adicionar API", localizado na parte direita da tela.

  4. Localize o campo de API Token e copie a chave de acesso exibida.

2.2 Conectando na Secret Solutions

  1. Acesse a Central de Integrações da Secret Solutions clicando no ícone de tomada no canto superior direito da tela de aplicativos.

  2. No menu de categorias, clique na aba E-Commerce.

  3. Localize e clique sobre o card da Bagy.

  4. Na tela de integração, preencha os campos:

    • API Token — cole a chave copiada no painel da Bagy.

    • Domínio — informe o endereço da sua loja (exemplo: sujaloja.bagy.com.br).

  5. Clique em Salvar API Token.

  6. Clique em Testar para validar se a conexão foi estabelecida com sucesso.

  7. Quando a integração estiver ativa, o status Conectado será exibido na tela.

3. Opção 2 — Parceria Oficial com a Bagy (para integrações avançadas)

Para operações que exigem acesso completo à API da Bagy — como sincronizações em alta frequência ou desenvolvimento de soluções personalizadas — é necessário formalizar uma parceria com a Bagy. Este processo é mais burocrático, mas garante acesso irrestrito aos recursos da plataforma.

Acesso da documentação: Base de Conhecimento Bagy - Introdução

3.1 Como funciona o processo

  1. Entre em contato com o time comercial da Bagy e solicite o início do processo de parceria.

  2. Após a assinatura do contrato de parceria, a Bagy disponibiliza uma loja de teste compartilhada para o desenvolvimento e homologação.

  3. Desenvolva a integração respeitando os limites de requisições definidos pela Bagy.

  4. Submeta a integração para o processo de homologação junto ao time técnico da Bagy, que validará o consumo correto da API.

  5. Após a aprovação, a integração estará liberada para uso em produção.

💡 Quando escolher esta opção? Opte pela parceria oficial quando precisar de acesso a endpoints avançados, volumes elevados de requisições ou quando a integração será distribuída para múltiplos clientes.

4. Integração Complementar — Sincronização Bagy + Bling

Se você também utiliza o Bling como ERP, é possível conectá-lo diretamente à Bagy por meio de um aplicativo nativo, sincronizando pedidos, estoque e notas fiscais entre as duas plataformas sem necessidade de desenvolvimento adicional.

4.1 Criando um Aplicativo no Bling

  1. Acesse o painel do Bling e navegue até Central de Extensões > Área do Integrador.

  2. Clique em Criar Aplicativo e preencha:

    • Nome do aplicativo.

    • Categoria da integração.

    • URL de Redirecionamento — necessária para o fluxo de autenticação OAuth 2.0.

    • Escopos de permissão — selecione os recursos que o aplicativo precisará acessar, como Produtos, Pedidos de Venda e Estoque.

  3. Salve o aplicativo. O Bling irá gerar o Client ID e o Client Secret necessários para a autenticação.

4.2 Autenticação OAuth 2.0

A API v3 do Bling utiliza exclusivamente o protocolo OAuth 2.0. O fluxo de autorização funciona da seguinte forma:

  1. O usuário é redirecionado para a página de autorização do Bling.

  2. Após aprovar o acesso, o Bling retorna um código de autorização.

  3. Esse código é trocado por um Access Token e um Refresh Token.

  4. O Access Token é utilizado no cabeçalho de todas as requisições no formato Bearer {access_token}.

4.3 Instalando o Aplicativo Bling Nativo na Bagy

  1. No painel da Bagy, acesse Aplicativos > Loja de Aplicativos.

  2. Pesquise por Bling Nativo e clique em instalar.

  3. Gere um API Token no Bling e insira no campo indicado durante a instalação.

  4. Configure os dados que deseja sincronizar entre as plataformas (pedidos, estoque, NF).

💡 Dica — Qual caminho seguir?

Quero conectar a Bagy rapidamente à Secret Solutions Use a Opção 1 — API Token. É o caminho mais direto, sem burocracia.

Preciso de acesso avançado à API da Bagy Use a Opção 2 — Parceria Oficial. Indicado para volumes elevados de requisições ou quando a integração será distribuída para múltiplos clientes.

Já uso o Bling como ERP Use a Integração Complementar Bagy + Bling. Sincronize pedidos, estoque e notas fiscais entre as duas plataformas sem desenvolvimento adicional.

⚠️ Atenção: O Bling exige que sua conta esteja no plano Cobalto ou superior para utilizar integrações via API. Verifique seu plano antes de iniciar o processo.