Ajuda › Configurações e conta

Plataforma

A conexão com a loja virtual — wBuy, Nuvemshop, Shopify ou Yampi —, por onde entram pedidos, clientes e carrinhos abandonados, e o que fazer quando ela para.

No painel: Configurações → Plataforma

Para que serve

É a ligação entre o Skarb e a sua loja virtual. Por ela entram pedidos, clientes, carrinhos abandonados e os fatos que disparam as jornadas (pedido pago, enviado, entregue…). Sem ela, o Skarb fica sem dados.

Conectar

Em Qual plataforma a loja usa?, escolha a sua:

• Nuvemshop e Yampi: Conectar leva à plataforma, onde você autoriza o Skarb — sem copiar chave nenhuma. Na Yampi, se preferir, dá para colar as chaves de API.
• Shopify: crie o app Skarb na sua conta da Shopify (dev.shopify.com), com a lista de permissões que a tela mostra, instale na loja e cole aqui o endereço da loja, o Client ID e o Client secret. Não precisa de aprovação da Shopify. Passo a passo em Começar com a Shopify.
• wBuy: cole a chave de integração que o painel da wBuy mostra no campo Authorization — a linha inteira, com o Basic na frente — ou o usuário:senha de API. Não são os dados de login do painel da wBuy. A identificação da aplicação (nome e e-mail) é opcional.

A conexão valida a credencial e começa a importar os pedidos em segundo plano. Atualize a página em alguns instantes para ver o andamento: pedidos lidos, com código de rastreio e envios novos.

Depois de conectada

• Sincronizar agora: busca as novidades sem esperar a próxima rodada.
• Importar histórico: traz pedidos mais antigos.
• Desconectar plataforma: para a importação. O que já está no Skarb continua.

Aviso em tempo real

Sem ele, o Skarb descobre uma expedição em até 15 minutos. Com ele, a plataforma avisa no instante em que o pedido muda de status ou ganha código de rastreio. Ele é ligado sozinho na conexão e não precisa de manutenção. A tabela mostra cada tipo de aviso e a última notificação recebida — "cadastrado" sem notificação ainda é normal logo depois de ligar: o aviso chega quando o fato acontecer na loja.

Atualizar o pedido na wBuy

Quando a transportadora informa uma mudança, o Skarb pode escrever o status correspondente no pedido da loja — assim quem abre "meus pedidos" vê o mesmo que quem abre a página de rastreio. Para cada momento (saiu para entrega, disponível para retirada, entregue…) escolha o status da wBuy e se a wBuy deve avisar o comprador por e-mail. Marque só o que quiser que ele receba — o Skarb já pode estar avisando pelas jornadas.

Mapeamento dos campos

Onde, dentro do pedido da wBuy, o Skarb encontrou cada informação (código de rastreio, telefone, CPF…). Duas lojas guardam os mesmos dados em lugares diferentes conforme os módulos que têm ativos — por isso a conferência é por loja, e dá para corrigir aqui mesmo.

O app foi desinstalado

Se alguém remove o app do Skarb na plataforma, a tela avisa: a importação e os avisos em tempo real param, mas os pedidos, contatos e jornadas que já estão no Skarb continuam. Reconectar usa a mesma conexão, sem duplicar nada.

Problemas comuns

• "Credencial recusada". Na wBuy, copie de novo a linha inteira do Authorization, com o Basic.
• "Indisponível". A plataforma não respondeu; o Skarb tenta de novo sozinho.
• Os pedidos chegam sem código de rastreio. Confira o Mapeamento dos campos — o código pode estar num campo que a loja usa de um jeito próprio.
• O estado da conexão, junto com as outras, está em Saúde das conexões.

Atualizado em 01/11/2026.