Centro assistenza · Guida agli accessi

Dai a ogni cliente le risposte giuste

Mostra le indicazioni alle persone a cui si applicano. Usa i pubblici di base per visitatori e clienti che hanno effettuato l'accesso, oppure crea gruppi a partire da attributi verificati come piano e ruolo.

1. Collega l'accesso dei clienti verificati

Un proprietario o amministratore configura l'accesso in Canali → il tuo canale → Centro assistenza. Lo sviluppatore della tua applicazione collega una sola volta l'identità dei clienti. Per i contenuti riservati ai visitatori, puoi scegliere Visitatori senza creare un flusso di accesso.

Apri la scheda Chat dal vivo del canale. Collega un sito web se il canale non ne ha uno, poi trova Identità sicura del visitatore.
Scegli Verifica facoltativa o Richiedi una prova per l'identificazione, seleziona Genera segreto di firma e conservalo solo sul tuo backend. Se un segreto è già configurato, in Modalità di verifica scegli Facoltativa: verifica quando è presente un JWT oppure Obbligatoria per identificazione e attributi. Richiedi una prova per l'identificazione consente comunque la chat anonima; è il pubblico del centro assistenza a controllare l'accesso ai contenuti.
Dopo che la tua app ha autenticato un cliente, il tuo server firma un token di identità (JWT) a breve durata che contiene user_id, email, iat, exp e attributi affidabili. Leggi piano e ruolo dal tuo database. Gli attributi del browser non firmati e i campi del contatto non possono concedere l'accesso.
Passa il JWT al widget e collega un'azione di accesso al centro assistenza per chi apre le pagine ospitate o il tuo dominio personalizzato. Usa la guida per sviluppatori collegata qui sotto per il codice esatto.

Genera e invia un'identità verificata

Per l'esempio qui sotto, gli attributi firmati sono:

JSON · attributi all'interno del JWT firmato

{"plan":"pro","role":"admin"}

2. Crea un pubblico Clienti Pro

Torna a Centro assistenza. In Pubblici, seleziona Nuovo pubblico (il pulsante più), oppure Crea un pubblico se è il tuo primo gruppo.
Inserisci Clienti Pro come Nome. Lascia Corrispondenza impostata su Tutte le regole.
In Attributo, inserisci plan. Imposta Condizione su è uno tra e Tipo di valore su Testo.
Inserisci pro e business su righe separate in Valori · uno per riga. Seleziona Salva pubblico.
Per creare un gruppo Amministratori, ripeti con Attributo role, Condizione è, Tipo di valore Testo e Valore admin.

Come funzionano le regole: Tutte le regole richiede che ogni condizione del pubblico sia soddisfatta; Almeno una regola ne richiede almeno una. Puoi aggiungere fino a 10 regole. Tutti i pubblici ereditati devono comunque corrispondere, anche se un determinato pubblico usa Almeno una regola.

Il testo distingue tra maiuscole e minuscole. Il numero 5 è diverso dal testo “5”; scegli Numero per confronti come è almeno. Gli attributi mancanti non soddisfano mai i confronti, compreso non è. Ha un valore esclude null; Non ha valore corrisponde ad attributi mancanti o null. Le chiavi degli attributi iniziano con una lettera e usano lettere, numeri o trattini bassi, fino a 64 caratteri; le chiavi di identità riservate come email non sono attributi.

3. Applica il pubblico dove ti serve

Un articolo

Apri l'articolo, imposta Chi può leggerlo? su Clienti verificati, poi scegli Clienti Pro in Pubblico di clienti. Seleziona Pubblica per un nuovo articolo o Salva modifiche per uno già pubblicato. Se l'accesso di base è ereditato, è in sola lettura; puoi comunque scegliere un pubblico di clienti aggiuntivo.

Un'intera categoria

Seleziona la matita accanto alla categoria in Categorie. Scegli Clienti verificati e un Pubblico di clienti, poi Salva. Ogni articolo di quella categoria deve rispettare questa restrizione oltre alla propria.

Un centro assistenza privato

In Accesso al centro assistenza, scegli Clienti verificati. Lascia Pubblico di clienti su Tutti i clienti verificati, oppure scegli Clienti Pro per riservare l'intero centro a quel gruppo.
Inserisci la pagina di login della tua applicazione come URL di accesso dei clienti, ad esempio https://app.example.com/login. È la pagina di login della tua app, non quella di accesso dello staff di Sonny.
Dopo il login, la tua app deve inviare il cliente all'endpoint di autenticazione del centro assistenza con un JWT firmato appena generato. L'URL di login da solo non completa questo collegamento.
Seleziona Salva accesso. Mantieni il centro Pubblicato, così i clienti autorizzati possono aprirlo.

Collega l'accesso per le pagine ospitate e il dominio personalizzato

Le restrizioni si sommano. Se il centro assistenza richiede Clienti Pro e una categoria richiede Amministratori, i suoi articoli richiedono entrambi. Tutti su un articolo non prevale sulla categoria. Visitatori e clienti verificati sono pubblici di base che si escludono a vicenda.

4. Visualizza l'anteprima, poi verifica una sessione reale

In cima a Centro assistenza, cambia Visualizza come in Visitatore, Cliente verificato o Cliente con attributi….
Per Cliente con attributi…, inserisci il JSON di esempio qui sopra. Le righe attenuate sono nascoste a quel lettore; il conteggio tiene conto dello stato di pubblicazione e di tutte le restrizioni ereditate. Tutti gli articoli riporta all'elenco completo di redazione.
Usa la tabella qui sotto per verificare un centro assistenza riservato ai clienti Pro che contiene una categoria riservata agli amministratori. Cambia piano e ruolo di esempio per controllare ogni risultato.
Apri un browser reale senza accesso, poi accedi con ogni cliente di prova. Controlla navigazione, ricerca, URL diretto di un articolo e scheda Aiuto del widget. L'anteprima degli attributi non ti fa accedere e non cambia l'accesso di un cliente.

Accesso previsto per un centro riservato ai clienti Pro e una categoria riservata agli amministratori
Lettore	Centro assistenza	Articolo della categoria Amministratori
Visitatore senza accesso	Pagina di accesso	Nascosto
Cliente Pro, amministratore	Può leggere	Può leggere
Cliente Pro, membro	Può leggere	Nascosto
Cliente Free, amministratore	Messaggio di accesso	Nascosto

Gli articoli negati vengono omessi dai risultati e gli URL diretti restituiscono “non trovato”. Un centro assistenza privato mostra una pagina di accesso o un messaggio di accesso con il tuo brand al posto dei contenuti. La sua sitemap è vuota e l'indicizzazione non è consentita; anche gli articoli riservati ai visitatori sono esclusi dalle sitemap pubbliche. Le risposte AI e il recupero di Copilot usano le stesse regole per l'identità verificata del cliente nella conversazione.

Gli URL delle immagini caricate sono pubblici. Limitare un articolo non protegge le sue immagini se qualcuno ha già l'URL dell'immagine.

Modifica o rimuovi un pubblico

Modifica un pubblico con il suo pulsante a forma di matita e seleziona Salva pubblico. Le modifiche alle regole si applicano dalla richiesta successiva. Gli attributi aggiornati di un cliente richiedono un nuovo JWT o un nuovo accesso al centro assistenza; le sessioni di lettura firmate esistenti mantengono i loro attributi fino alla scadenza.

Per rimuovere una restrizione con nome da un punto, seleziona Tutti i clienti verificati (o Tutti nel pubblico ereditato) in Pubblico di clienti, poi salva. Per rendere pubblico quel contenuto, scegli anche Tutti in Chi può leggerlo? e verifica che gli elementi superiori consentano l'accesso pubblico.

Il pulsante di eliminazione del pubblico mostra quanti articoli, categorie e centri assistenza lo usano. L'eliminazione rimuove le regole sugli attributi di quel gruppo; i contenuti collegati restano riservati ai clienti verificati e mantengono le altre restrizioni ereditate. I clienti che prima non soddisfacevano la regola eliminata potrebbero ottenere l'accesso. Controlla queste assegnazioni prima di confermare.

Risoluzione dei problemi di accesso

Un cliente verificato vede la pagina di accesso: Controlla la modalità di verifica nella scheda Chat dal vivo di questo canale, la scadenza del JWT, il segreto di firma e l'URL di accesso del centro assistenza. L'accesso alla dashboard dello staff è separato da quello dei clienti.
Il cliente ha effettuato l'accesso ma non può leggere una risposta: Controlla ogni pubblico ereditato e i nomi, i tipi e i valori esatti degli attributi firmati. Un cliente Pro può comunque non soddisfare la regola Amministratori di una categoria.
Chi può leggerlo? è disattivato: È il centro assistenza o la categoria a impostare il pubblico di base. Modifica l'elemento superiore per cambiarlo; usa Pubblico di clienti per restringere ulteriormente l'accesso verificato.
Compare “Nessun lettore corrispondente”: Le restrizioni riservate ai visitatori e quelle riservate ai clienti verificati sono in conflitto. Usa l'accesso ereditato quando è proposto, oppure correggi prima le impostazioni del centro assistenza o della categoria.
Un cambio di piano non ha ancora cambiato l'accesso: Genera un nuovo JWT con gli attributi aggiornati ed esegui di nuovo l'identificazione nel widget. Per le pagine ospitate o sul dominio personalizzato, completa di nuovo l'accesso al centro assistenza. I cookie esistenti mantengono i loro attributi firmati fino alla scadenza.
Un articolo non compare nella ricerca o nel widget: Verifica che sia pubblicato, che il centro sia Pubblicato, che Ricerca sia attiva per i risultati di ricerca e che il lettore soddisfi tutte le restrizioni. Una scheda Aiuto vuota viene nascosta.