Como funcionam as integrações
O caminho de conectar, o que cada tipo de dado sincroniza, quando a importação realmente acontece, e o que cada status significa.
Uma integração conecta a plataforma da sua loja ou o seu ERP à Bevean, para clientes, pedidos e produtos chegarem sozinhos — sem planilha, sem digitar nada duas vezes.
Onde fica: Integrações
Conectar, em geral
O caminho é o mesmo para qualquer plataforma: clique em Explorar integrações, escolha a sua e clique em Instalar. Isso abre uma tela com três blocos — instruções específicas daquela plataforma, o que sincronizar, e as credenciais.
A partir daí, o fluxo se divide em dois tipos, dependendo da plataforma:
| Tipo | Como funciona |
|---|---|
| Direto | Você cola a credencial (token, chave de API) e clica em Conectar. Numa única ação, a Bevean valida e já deixa a integração pronta para sincronizar |
| Autorização (OAuth) | Você clica em Conectar e é levado para a própria plataforma (Shopify, Bling, Tiny) para autorizar. Ao voltar, ainda falta um passo: clicar em Salvar e continuar |
No fluxo de autorização, esquecer o "Salvar e continuar" deixa a integração pela metade
Depois de autorizar na plataforma, a tela volta para a Bevean já com as permissões concedidas — mas a integração só passa a sincronizar depois desse clique final.
O que sincroniza, e o que você pode desligar
Cada plataforma sincroniza um conjunto próprio de dados — nem toda integração lida com carrinho abandonado, por exemplo. Os tipos mais comuns:
| Tipo de dado | O que é |
|---|---|
| Clientes | As pessoas cadastradas na loja |
| Pedidos | As vendas, com status de pagamento e entrega |
| Produtos | O catálogo, com variações e estoque quando a plataforma informa |
| Carrinho abandonado | Quem começou a comprar e não terminou |
| Newsletter | Quem se inscreveu para receber novidades, sem necessariamente ter comprado |
| Cupons | Os descontos criados na própria plataforma |
Todos vêm ligados por padrão quando você conecta. Desligar um tipo não apaga o que já foi importado — só para de trazer coisa nova daquele tipo a partir dali. Religar retoma de onde parou.
Pedidos esperam Clientes e Produtos sincronizarem primeiro
Se as três estiverem ligadas, a Bevean só começa a importar pedidos depois que clientes e produtos já tiverem rodado ao menos uma vez — é assim que ela evita um pedido chegar antes de existir cliente ou produto para vincular. Isso pode fazer a lista de Pedidos parecer atrasada nos primeiros minutos, e é esperado.
Quando a sincronização acontece
Conectar não importa os dados na mesma hora. O que acontece de imediato é diferente do que acontece depois:
- Em algumas plataformas, a Bevean registra um aviso automático (webhook) assim que você conecta — isso faz pedidos e clientes novos chegarem quase em tempo real dali em diante.
- Em outras, não existe esse aviso automático, e a atualização depende só do ciclo periódico da Bevean.
- Em qualquer uma das duas, a primeira importação de histórico começa no próximo ciclo — não no instante em que você clica em Conectar.
A primeira sincronização traz o histórico inteiro, não só as vendas novas
Ao conectar, a Bevean busca todo o histórico disponível na plataforma, não só o que vier a partir de hoje. Uma loja com anos de pedidos pode levar mais tempo na primeira rodada do que nas seguintes.
Os status de uma integração
| Status | O que significa |
|---|---|
| Pendente | Você clicou em Instalar, mas ainda não preencheu as credenciais |
| Conectado | As credenciais foram validadas. No fluxo de autorização, falta clicar em Salvar e continuar |
| Ativo | Sincronizando de verdade — é o único status em que os dados realmente chegam |
| Inativo | Parou de funcionar. Aparece um aviso no topo da tela com a opção de tentar de novo |
O botão Testar conexão, na tela de detalhe, confirma se as credenciais ainda são válidas — mas um teste que falha não muda o status sozinho, só avisa na hora.
Depois de falhar 3 vezes seguidas, a Bevean para de tentar sozinha
Um tipo de dado que falha algumas vezes seguidas é retomado automaticamente nos próximos ciclos. Depois de 3 falhas seguidas, ela para de insistir sozinha — nesse ponto, o botão Sincronizar agora é o que retoma manualmente.