Uma integração não está sincronizando
Roteiros para quando a integração fica Inativa, um tipo de dado nunca chega, ela trava em Conectado sem virar Ativa, ou você precisa desconectar sem perder o histórico.
A maioria dos casos cai em quatro situações: a integração fica Inativa, um tipo de dado nunca chega, a integração fica Conectada mas nunca vira Ativa, ou você não sabe se pode desconectar sem perder o que já foi importado.
Antes de investigar, confirme o status na lista de integrações
Ativo é o único status em que os dados de fato chegam. Veja o significado de cada um em como funcionam as integrações.
A integração está Inativa
| # | Verifique | Se for isso |
|---|---|---|
| 1 | A credencial ainda é válida na plataforma de origem? | Uma senha trocada, um token revogado ou um usuário removido do lado de lá derruba a conexão. Use Testar conexão para confirmar |
| 2 | O app da Bevean foi desinstalado ou desautorizado na plataforma? | Na Nuvemshop e no Tiny, use Mais ações › Reconectar: o acesso é renovado e as configurações e os dados ficam. Nas outras integrações, é preciso conectar de novo, com credenciais novas |
| 3 | Já clicou em Tentar novamente, no aviso do topo da tela? | É o primeiro passo antes de investigar mais fundo |
Um tipo de dado nunca chega
| # | Verifique | Se for isso |
|---|---|---|
| 1 | Esse tipo está ligado na aba de Sincronização? | Vem tudo ligado por padrão, mas pode ter sido desligado em algum momento |
| 2 | É Pedidos, e Clientes ou Produtos ainda não sincronizaram nenhuma vez? | Pedidos esperam os dois sincronizarem primeiro — não é travamento, é a ordem esperada |
| 3 | Esse tipo falhou 3 vezes seguidas? | Depois da terceira falha a Bevean para de tentar sozinha. Use Sincronizar agora para retomar manualmente |
| 4 | A plataforma realmente tem esse dado (ex: carrinho abandonado, cupom)? | Nem toda plataforma oferece todos os tipos — confira o que a sua integração sincroniza no artigo específico dela |
Pedidos novos demoram a aparecer
A integração está com o status Ativo e os dados chegam, mas com atraso. O mais comum é a loja ter perdido os avisos automáticos (webhooks) que fazem os dados chegarem quase na hora. Na Nuvemshop, isso se confere na aba Webhooks da integração, pelo botão Verificar webhooks. O passo a passo está em conferir os avisos automáticos da Nuvemshop.
A integração ficou Conectada e nunca virou Ativa
Acontece só nas integrações que autorizam direto na plataforma (Shopify, Bling, Tiny): depois de autorizar, ainda falta voltar à Bevean e clicar em Salvar e continuar na tela de configuração de sincronização. Sem esse clique, a integração fica parada em Conectado.
Desconectar sem perder o histórico
Desconectar não apaga o que já foi importado
Remover a integração encerra só a conexão — clientes, pedidos e produtos que já chegaram continuam na Bevean. O que para é a chegada de dado novo.
Reconectar depois de desconectar traz os dados de novo, ou duplica?
O histórico que já está na Bevean não se duplica ao reconectar — a identificação de cada registro pela plataforma de origem evita isso.
Trocar de plataforma (por exemplo, sair da Bagy e migrar para a Shopify) mantém o histórico?
O histórico de cada plataforma fica vinculado a ela. Desconectar a antiga não apaga o que ela já trouxe; conectar a nova traz o dela — os dois convivem na mesma base de clientes e pedidos.