Diagnosticar o sintoma
| Sintoma | Verifique | Próxima ação |
|---|---|---|
| inicialização retorna nulo | Emitido clientId, ambiente aprovado, resposta de autenticação. | Mantenha disponível a jornada padrão do produto; inspecionar erros de console/rede sem compartilhar tokens. |
| Sem botão Web SDK | O contêiner existe; a roupa pertence ao seu parceiro; vestuário e variante fixada estão disponíveis. | Verifique o mapeamento da roupa e a mensagem de validação. |
| Roupa abre uma peça de roupa | Uma roupa correspondente disponível deve conter todas as peças solicitadas e variantes fixadas. | Verifique a roupa; o substituto da primeira peça não é esperado em nenhuma partida. |
| Os tamanhos aparecem, mas não há recomendação | showSizes e enableSizingRecommendation são opções separadas. | Confirme se o tamanho é solicitado e compatível com o produto/conta. |
| Bloco Shopify ausente | Produto pronto e habilitado, recurso ativo, bloco salvo correto e modelo publicado. | Verifique todos os três controles, assinatura e avisos de cobrança. |
| Visualização Shopify ou atalho ausente | Chave de recurso e configuração de bloco correspondente; Dependência de teste virtual, quando aplicável. | Recarregue depois de alterar as configurações de recursos. |
| O carrinho falha | Resposta do endpoint do carrinho, mapeamento e validação de ID/variante. | Relate o erro, limpe o estado de carregamento e deixe um caminho para nova tentativa. |
| Novo layout de caixa de diálogo quebra página | Substituições antigas de .try-on-dialog e comportamento de tela estreita. | Verifique novamente o layout v3. |
Envie um relatório de suporte útil
- Caminho de integração, versão do pacote SDK e ambiente.
- ID do produto/vestuário afetado e variante selecionada.
- Navegador, sistema operacional e dispositivo, além de carimbo de data/hora e fuso horário.
- Etapas exatas de reprodução, resultado esperado e resultado observado.
- Um erro de console/rede limpo ou ID de correlação, quando disponível.
Use seu canal de suporte de integração ou support@spreeai.com. Nunca inclua segredos de clientes, tokens de acesso ou imagens de clientes em um relatório de suporte geral.