Solução de problemas e suporte#

Comece pela etapa com falha na sua integração com o Visualizer SDK: carregar o SDK, fazer a correspondência de um produto ou importar dados. Mantenha o contexto da solicitação disponível sem compartilhar credenciais.

O botão da loja virtual não aparece#

1. Verifique o Painel de Rede em busca de https://sdk.ideal.house/sdk.js e inspecione qualquer falha de carregamento.
2. Confirme que há um único carregador com o Shop ID e Publishable Key corretos.
3. Abra Painel de Controle → Configurações. Confirme que Allowed Origins (CORS) inclui exatamente a origem da loja virtual que você está testando, clique em Salvar após quaisquer alterações e recarregue a loja virtual. Verifique também o data-product-code exato do destino. Consulte configuração de origem.
4. Verifique se o produto está pronto e se a variante selecionada possui um mapeamento.
5. Para botões criados por você, verifique se seus estilos permitem que o estado ativo validado se torne visível.

Não force um botão não validado a ficar visível para contornar a elegibilidade. Siga o guia da plataforma e o guia de mapeamento.

O produto errado abre#

Inspecione o destino após alterar a variante, abrir uma visualização rápida ou navegar sem recarregar. Limpe os atributos obsoletos do SDK conforme páginas dinâmicas e confirme se o callback da sua plataforma realmente é executado.

Uma importação foi aceita, mas os produtos estão ausentes#

Uma resposta 202 Accepted inicia trabalho assíncrono. Leia status da tarefa, inspecione falhas dos itens e use erros e novas tentativas. O endpoint de status retorna a tarefa atual ou mais recente da loja; não se trata de uma consulta por ID de tarefa arbitrário.

O que enviar ao suporte#

Use o canal de suporte fornecido durante o onboarding ou a opção de contato na sua conta. Inclua o URL da storefront afetado, Shop ID quando relevante, código do produto ou ID do job de importação, horário aproximado, navegador, resultado esperado e resposta de erro sanitizada. Remova as chaves Client Secret, API, tokens e imagens privadas de clientes antes de compartilhar logs ou screenshots.