Solução de problemas
A Cabina nunca quebra a sua vitrine: quando não consegue funcionar, ela sai do caminho. Isso é proposital, e é também o motivo pelo qual algumas destas falhas são completamente silenciosas.
As linhas entre aspas abaixo são o que o navegador realmente imprime: procure-as no console exatamente como estão escritas, sem traduzir.
Nenhum botão em lugar nenhum da página de produto
No console: um erro de CORS do seu navegador, mencionando www.cabina.io
O domínio da sua loja não está na lista autorizada, então a API responde sem cabeçalhos CORS e o navegador descarta a resposta.
Adicione a origem exata em Widget .
https://loja.com.br e https://www.loja.com.br são duas origens diferentes:
adicione as duas se as duas servem a loja.
A mesma lista vale para as provas: uma prova pedida de um site fora da lista é
recusada (403) antes de consumir créditos. Se as provas pararam depois de uma
troca de domínio, o remédio é o mesmo: adicione o domínio novo.
Nenhum botão, e nenhum erro de CORS também
No console: [widget] error=WIDGET_CONFIG_MISSING
A chave de API está faltando, ou não foi lida da tag script.
Confira se data-api-key está na própria tag <script> e começa com
cab_live_.
Nenhum botão, e absolutamente nada no console
No console: nada — este caso é silencioso
O seu plano ficou sem sessões, ou os seus créditos se esgotaram. O widget se esconde de propósito, para que a sua loja continue funcionando.
Confira Faturamento .
O botão fica bem no fim da página
No console: nada — este também é silencioso
Nenhum dos pontos de ancoragem conhecidos correspondeu ao seu tema, então o botão
foi anexado ao <body>.
Adicione <div data-cabina-target></div> onde você quiser: o botão vai
dentro desse elemento. Veja
Mover o botão.
Dois botões, e as sessões contadas duas vezes
No console: [widget] warn=GIA_CARICATO
O snippet está duas vezes na página — muitas vezes uma cópia antiga mais um plugin.
Remova uma das duas tags <script>.
O botão abre, mas a prova falha no meio do caminho
No console: nada
A Cabina não conseguiu encontrar a imagem da peça na página.
Adicione uma meta tag og:image ao seu template de produto — veja
A imagem da peça.
Algumas provas falham quando muitos clientes provam ao mesmo tempo
No console: nada; na aba Rede do navegador, uma resposta 429
A Cabina aceita no máximo 30 provas por minuto por loja, para que ninguém consiga esvaziar os seus créditos em poucos minutos com a chave pública. Acima desse limite a prova falha: basta tentar de novo pouco depois.
A prova começa, mas falha com «Não foi possível fazer a prova»
No console: nada
O widget encontrou a peça e a foto do cliente, mas a geração não chegou ao fim. Uma prova que falha não consome créditos. Os motivos, do mais comum ao mais raro:
- A foto da peça não serve. Uma colagem, um detalhe, uma peça vista de costas ou com texto por cima não bastam para o motor. A foto certa está em As fotos.
- A foto do cliente. Corpo inteiro, em pé, bem iluminado: é um conselho, não uma obrigação, mas uma pessoa cortada ao meio ou várias pessoas na mesma foto fazem a geração falhar.
- O motor está parado por um momento. Acontece raramente; o status em tempo real está em cabina.io/status . Basta tentar de novo alguns minutos depois.
Se o que acabou foram as provas do mês, o botão some das páginas de produto até o plano renovar ou você comprar provas extras em Plano .
Lingerie, moda praia e peças transparentes
No console: nada
Os modelos de IA que a Cabina usa para reconhecer a peça e gerar a prova são de provedores externos, e aplicam regras de conteúdo que não dependem de nós. Lingerie, moda praia e tecidos transparentes podem ser recusados por essas regras: o reconhecimento da peça pode falhar, e a prova pode não começar ou parar no meio.
A lingerie nós testamos (outubro de 2026: conjuntos de renda e de tela, bodies transparentes, cintas-ligas, pijamas e camisolas, em quatro tipos de corpo): a prova saiu para todas as peças. O reconhecimento da peça recusou só uma foto, com a peça vestida por uma modelo; quando isso acontece, a prova começa mesmo assim. Para lingerie, uma foto da peça sozinha conta ainda mais.
Moda praia e peças transparentes que não são lingerie (blusas, vestidos) ainda não testamos: se você vende, escreva para nós com o link de um produto antes de ativar a Cabina e testamos juntos.
O botão funciona, mas não sugere nenhum tamanho
No console: nada
O cliente não informou as medidas de que aquela peça precisa — por exemplo só a altura em uma blusa, que precisa de busto e cintura. O widget prefere não mostrar nenhum tamanho a adivinhar um.
As medidas de que cada tipo de peça precisa estão em O painel.
Verificar a partir de um terminal
# 1. a tag é realmente servida
curl -s https://sua-loja.com.br/produtos/um-produto | grep -o 'widget.iife.js'
# 2. a página expõe uma imagem da peça
curl -s https://sua-loja.com.br/produtos/um-produto | grep -o 'og:image[^>]*'São esses dois que falham. Se os dois respondem, o problema é quase sempre o domínio não autorizado.
Nenhum destes casos?
Escreva para info@cabina.io com o link de uma página de produto e, se puder, o que você vê no console.