Le due modalità, la conferma, e il degrado onesto

10.1 «Ti guido» e «lo facciamo insieme»

Se l’azione richiesta dalla persona esiste nel tuo manifesto ed è attivata, l’assistente chiede se vuole che gliela mostri («ti guido»: naviga ed evidenzia soltanto) o che la facciano insieme («lo facciamo insieme»: compila anche e offre di premere il pulsante, sempre con conferma). Se non esiste o è disattivata, l’assistente può solo guidare con ciò che sa dalla sua base di conoscenza — non promette mai di compilare qualcosa che non è armato.

10.2 Conferma al salvataggio

Navigare, evidenziare e compilare avvengono in bella vista senza chiedere. Qualsiasi azione che salva, invia o elimina chiede sempre conferma — è il livello minimo del prodotto, e il tuo sito può alzarlo (confirmOnFill: true, per chiedere conferma anche al riempimento) ma non abbassarlo mai.

10.3 Degrado onesto

Situazione	Cosa vede la persona
SDK assente o versione insufficiente	reason: "sdk_too_old" all’avvio; il widget continua a funzionare come chat normale, senza copilota.
Manifesto obsoleto	manifestStatus: "outdated"; copilota spento finché non si approva di nuovo.
Manifesto revocato	manifestStatus: "revoked"; si spegne all’istante in tutte le sessioni aperte.
Nessun manifesto ancora registrato	needManifest: true; il server chiede il JSON completo al prossimo avvio.
Copilota non attivato per il canale	Il widget si comporta esattamente come prima di installare l’SDK.
Canale «fuori piano» (dopo un cambio di piano del tenant)	reason: "out_of_plan" all’avvio; il widget mostra un pannello di chiusura onesta («Assistente non disponibile», senza codice interno né dati del piano) al posto della chat, finché il tenant non lo mantiene di nuovo o passa a un piano superiore.

Nota — Non è un problema della tua integrazione

Se il canale diventa «fuori piano», il tuo SDK non deve fare nulla di diverso — il widget gestisce da solo la chiusura onesta. Il dettaglio di cosa significa «fuori piano» e come il tenant lo risolve è nel Manuale 62 · Capacità e limiti del piano, sezione 6.