Pular para o conteúdo principal

Guia de Integração: Bling

Conecte o ERP Bling ao Conversaas e deixe seu agente de IA responder no WhatsApp com preço e estoque sempre atualizados, direto do seu sistema de gestão — sem precisar cadastrar produtos em dois lugares.

1. Pré-Requisitos​

  • Ter uma conta ativa no Bling com produtos cadastrados.
  • Ter o Conversaas num plano ativo que possua o recurso de Catálogo habilitado.

2. Como Funciona​

O Bling é um ERP, não uma loja virtual — ele não tem carrinho nem checkout. Por isso a integração funciona em uma via só, de leitura: o Conversaas importa periodicamente os produtos, preços e estoque cadastrados no seu Bling e monta um catálogo que o agente consulta para responder clientes no WhatsApp.

O Conversaas nunca escreve no seu Bling. Nenhum produto, pedido, nota fiscal ou movimentação de estoque é criado, alterado ou apagado na sua conta a partir da integração. É leitura, sempre.

3. Instalação​

  1. Acesse o painel do Conversaas e navegue em Integrações > Catálogo > ERP > Bling.
  2. Clique no botão Conectar com o Bling.
  3. Essa ação leva você à tela de autorização no servidor seguro do Bling.
  4. Faça login na sua conta Bling (se ainda não estiver) e autorize o Conversaas a ler produtos e estoque.
  5. Você será trazido de volta ao painel do Conversaas com o indicador Status: Conectado.
  6. Clique em Importar catálogo para disparar a primeira sincronização. Ela roda em segundo plano e pode levar alguns minutos, dependendo da quantidade de produtos.

4. Funcionalidades Disponíveis​

  • Consulta de Catálogo pelo Agente: [DISPONÍVEL] A IA do Conversaas lê os produtos ativos do seu Bling (nome, código, preço, promoção quando houver) e responde clientes no WhatsApp com essa informação.
  • Estoque em Tempo Real: [DISPONÍVEL] O agente sabe se um produto está disponível antes de oferecê-lo. Se o Bling não confirmar o saldo no momento da sincronização, o item fica marcado como indisponível para consulta — o agente nunca afirma que um produto está em estoque sem ter certeza.
  • Produtos com Variação: [DISPONÍVEL] Produtos com grade (tamanho, cor etc.) são importados por variação — o agente enxerga cada SKU vendável separadamente, não o produto "pai".
  • Sincronização Automática: [DISPONÍVEL] O catálogo se atualiza sozinho a cada 6 horas. Também é possível forçar uma atualização manual a qualquer momento pelo botão Sincronizar catálogo.
  • Consulta de Pedidos / Notas Fiscais: [EM BREVE] Ainda não disponível nesta fase.

5. Testando a Integração​

  1. Após ver o indicador Status: Conectado, clique em Importar catálogo e aguarde a mensagem de sincronização concluída.
  2. Vá em Catálogo no painel do Conversaas e confira se os produtos do seu Bling aparecem na listagem, com preço e imagem (quando disponível).
  3. Abra uma conversa de teste no WhatsApp do seu agente e pergunte por um produto que você sabe que existe no seu Bling.
  4. Confirme que o agente responde com as informações corretas e, se aplicável, com a foto do produto.
  5. No Bling, altere o preço ou a situação (ativo/inativo) de um produto de teste. Espere a próxima sincronização (ou force uma manual) e confirme que a mudança chegou ao Conversaas.

6. Perguntas Frequentes da Integração​

O Conversaas pode criar ou alterar produtos no meu Bling? Não, nunca. A integração é de leitura apenas. Cadastro, preço e estoque continuam sendo gerenciados inteiramente por você dentro do Bling.

Com que frequência o catálogo é atualizado? Automaticamente a cada 6 horas. Se você precisar de uma atualização imediata — por exemplo, depois de uma alteração grande de preços — use o botão Sincronizar catálogo agora no painel.

Minha conta Bling ficou desconectada sozinha, o que aconteço? As autorizações do Bling têm validade limitada e são renovadas automaticamente pelo Conversaas. Se a renovação falhar (por exemplo, se você revogou o acesso do lado do Bling), o painel mostra Status: Desconectado e basta clicar em Conectar com o Bling novamente para reautorizar — nenhum dado é perdido.

Produtos com variação (tamanho, cor) aparecem certinho? Sim. Cada variação vendável é importada como um item separado do catálogo, com seu próprio preço e estoque. O produto "pai" (sem preço próprio) não aparece nas respostas do agente.

Vocês vão adicionar consulta de status de pedido ou nota fiscal? Está no roadmap. Por enquanto a integração cobre apenas catálogo (produtos, preço e estoque).