Risoluzione dei problemi

Cabina non rompe mai la tua vetrina: quando non può funzionare, si toglie di mezzo. È voluto, ed è anche il motivo per cui alcuni di questi guasti sono completamente muti.

Nessun pulsante da nessuna parte

In console: un errore CORS del tuo browser, che nomina www.cabina.io

Il dominio del tuo negozio non è nell’elenco autorizzato, quindi l’API risponde senza intestazioni CORS e il browser butta via la risposta.

Aggiungi l’origine esatta in Widget . https://negozio.it e https://www.negozio.it sono due origini diverse: se il negozio risponde su entrambe, aggiungile entrambe.

Lo stesso elenco vale per le prove: una prova chiesta da un sito fuori elenco viene rifiutata (403) prima di consumare crediti. Se le prove si sono fermate dopo un cambio di dominio, il rimedio è lo stesso: aggiungi il dominio nuovo.

Nessun pulsante, e nemmeno un errore CORS

In console: [widget] error=WIDGET_CONFIG_MISSING

La chiave API manca, oppure non è stata letta dal tag.

Controlla che data-api-key stia sul tag <script> stesso e cominci per cab_live_.

Nessun pulsante, e in console non c’è proprio niente

In console: niente — questo è muto

Il tuo piano ha esaurito le sessioni, oppure i crediti sono finiti. Il widget si nasconde apposta, così il tuo negozio continua a funzionare.

Controlla Fatturazione .

Il pulsante sta in fondo alla pagina

In console: niente — anche questo è muto

Nessuno dei punti d’aggancio noti ha combaciato col tuo tema, quindi il pulsante è stato appeso a <body>.

Aggiungi <div data-cabina-target></div> dove lo vuoi: il pulsante va dentro quell’elemento. Vedi Spostare il pulsante.

Due pulsanti, e le sessioni contate due volte

In console: [widget] warn=GIA_CARICATO

Lo snippet è sulla pagina due volte — spesso una copia vecchia più un plugin.

Togli uno dei due tag <script>.

Il pulsante si apre, ma la prova fallisce a metà

In console: niente

Cabina non è riuscita a trovare l’immagine del capo sulla pagina.

Aggiungi un tag og:image al template del prodotto — vedi L’immagine del capo.

Alcune prove falliscono quando tanti clienti provano insieme

In console: niente; nella scheda Rete del browser, una risposta 429

Cabina accetta al massimo 30 prove al minuto per negozio, così nessuno può svuotare i tuoi crediti in pochi minuti con la chiave pubblica. Oltre quella soglia la prova fallisce: basta riprovare poco dopo.

La prova parte, ma fallisce con «Prova non riuscita»

In console: niente

Il widget ha trovato il capo e la foto del cliente, ma la generazione non è arrivata in fondo. Una prova fallita non consuma crediti. I motivi, dal più comune al più raro:

• La foto del capo non è utilizzabile. Un collage, un dettaglio, un capo di spalle o con del testo sopra non bastano al motore. La foto giusta è in Le foto.
• La foto del cliente. Figura intera, in piedi, ben illuminata: è un consiglio, non un obbligo, ma una persona tagliata a metà o più persone nella stessa foto fanno fallire la generazione.
• Il motore è momentaneamente fermo. Succede di rado; lo stato in tempo reale è su cabina.io/status . Basta riprovare dopo qualche minuto.

Se invece le prove del mese sono finite, il pulsante sparisce dalle pagine prodotto finché il piano non si rinnova o non compri prove extra dal Piano .

Intimo, costumi da bagno e capi trasparenti

In console: niente

I modelli di AI che Cabina usa per riconoscere il capo e per generare la prova sono di fornitori esterni, e applicano regole sui contenuti che non dipendono da noi. Intimo, costumi da bagno e tessuti trasparenti possono essere rifiutati da quelle regole: il riconoscimento del tipo di capo può fallire, e la prova può non partire o fermarsi a metà.

L’intimo l’abbiamo collaudato (ottobre 2026: completi in pizzo e in rete, body trasparenti, reggicalze, pigiami e camicie da notte, su quattro corporature): la prova è uscita per tutti i capi. Il riconoscimento del tipo di capo ha rifiutato una sola foto, con il capo indossato da una modella; quando succede, la prova parte lo stesso. Per l’intimo la foto del capo da solo conta ancora di più.

I costumi da bagno e i capi trasparenti che non sono intimo (camicette, abiti) non li abbiamo ancora collaudati: se li vendi, scrivici con il link di un prodotto prima di attivare Cabina e lo proviamo insieme.

Il pulsante funziona, ma non suggerisce nessuna taglia

In console: niente

Il cliente non ha dato le misure che servono per quel capo — per esempio solo l’altezza su una maglia, che vuole busto e vita. Il widget preferisce non mostrare nessuna taglia piuttosto che indovinarla.

Le misure che servono a ogni tipo di capo sono in Il pannello.

Verificare da terminale

# 1. il tag è davvero servito
curl -s https://il-tuo-negozio.com/prodotti/un-prodotto | grep -o 'widget.iife.js'
 
# 2. la pagina espone un'immagine del capo
curl -s https://il-tuo-negozio.com/prodotti/un-prodotto | grep -o 'og:image[^>]*'

Sono i due che falliscono. Se entrambi rispondono, il problema è quasi sempre il dominio non autorizzato.

Nessuno di questi casi?

Scrivi a info@cabina.io con il link di una pagina prodotto e, se puoi, quello che vedi nella console.