Lancia il tuo primo centro assistenza

Un sito di documentazione è un centro assistenza ospitato creato dagli articoli nel tuo spazio di lavoro, con ricerca, un assistente Assistente IA e feedback dei lettori. Questo articolo ti guida dai tuoi primi articoli a un sito pubblico sul tuo indirizzo. Ogni passaggio rimanda all'articolo con i dettagli.

Prima di iniziare#

• Il tuo ruolo: i proprietari e gli amministratori dell'area di lavoro creano e configurano i siti di documentazione. I Creatori di contenuti possono aggiungere pagine e gli Editor possono pubblicare. Vedi chi può fare cosa.
• Il tuo piano: i siti di documentazione sono disponibili in ogni piano, incluso quello Gratuito. Il piano Gratuito e Starter includono 1 sito; il piano Pro ne include 2–5, a seconda dei posti. Vedi Piani e limiti dei siti di documentazione.
• Piano Gratuito: la pubblicazione richiede un indirizzo email verificato.

Costruiscilo passo dopo passo#

1. Scrivi i tuoi primi articoli#

   Un sito mostra articoli, quindi inizia con alcuni di essi. Fai clic su Crea, apri la scheda Articolo e scegli un tipo: Articolo pratico, Risoluzione dei problemi, Procedura operativa standard, Post del blog o Aggiornamento prodotto. Aggiungi una registrazione dall'app desktop, dall'estensione Chrome, tramite caricamento, dalla tua libreria o con Registra con l'IA, quindi fai clic su Genera articolo. Un articolo costa solitamente 5–15 crediti. Consulta Trasforma una registrazione in un articolo.

   Hai già un centro assistenza altrove? Puoi importarlo quando crei il sito (passaggio successivo).

2. Crea il sito di documentazione#

   Clicca su Siti di documentazione nella barra laterale, quindi su Nuovo sito di documentazione. La procedura guidata prevede tre passaggi:

   1. Dai un nome al tuo sito: digita un Nome del sito e controlla l'Indirizzo gratuito, che termina con .clevera.help. Scegli la Lingua del sito.
   2. Cosa includere?: scegli Da una raccolta (ogni cartella diventa una sezione), Scegli contenuto, Inizia vuoto o Importa da un altro strumento.
   3. Rendilo tuo: aggiungi un Logo, un Colore del brand, un Carattere e l'Aspetto predefinito.

   Clicca su Crea sito. Quando inizi con dei contenuti, il sito viene pubblicato immediatamente al suo indirizzo gratuito e si apre sulla Panoramica, con una lista di controllo Inizia. Vedi Creare un sito di documentazione.

3. Aggiungi e organizza le pagine#

   Apri Pagine nella barra laterale del sito per aggiungere sezioni, aggiungere articoli dalla tua libreria, scrivere nuove pagine e impostarne l'ordine. La lista di controllo richiede almeno 5 pagine. Vedi Aggiungere e organizzare pagine.

4. Imposta l'aspetto#

   Apri Aspetto per cambiare logo, colore del brand, stile del sito, caratteri e l'intestazione della tua home page. Un'anteprima dal vivo mostra ogni modifica. Configura i menu dell'intestazione e del piè di pagina in Navigazione. Vedi Personalizzare l'aspetto di un sito di documentazione e Configurare l'intestazione e il piè di pagina di un sito di documentazione.

5. Attiva l'Assistente IA#

   L'assistente è disattivato su un nuovo sito. Vai su Impostazioni → Assistente IA, attiva Mostra l'assistente, scegli cosa succede Quando non può rispondere e clicca su Salva. Risponde solo dalle tue pagine pubblicate ed elenca le sue fonti. Le risposte non costano crediti; il tuo piano include un numero mensile di risposte (300 nel piano Gratuito). Vedi Configurare l'assistente del sito di documentazione.

6. Scegli chi può leggerlo#

   Ogni sito è pubblico per impostazione predefinita. Per renderlo privato, vai su Impostazioni → Accesso e scegli Password o Accesso all'area di lavoro. I siti privati richiedono il piano Pro o superiore. Vedi Controllare chi può leggere un sito di documentazione.

7. Pubblica#

   Clicca su Pubblica nell'intestazione del sito, controlla l'elenco delle modifiche e conferma (il pulsante indica, ad esempio, Pubblica 3 modifiche). I lettori vedono la nuova versione in pochi secondi e ogni versione viene conservata in Pubblicazione in modo da poter tornare indietro. Pubblica automaticamente è attivo per i nuovi siti: una volta che il sito è pubblico, le modifiche salvate vengono pubblicate dopo circa due minuti senza ulteriori interventi. Vedi Pubblicare un sito di documentazione.

8. Connetti il tuo dominio#

   I domini personalizzati richiedono il piano Starter o superiore. Apri Dominio, inserisci un sottodominio come help.example.com e clicca su Connetti. Aggiungi il record CNAME che Clevera mostra presso il tuo provider di dominio, quindi clicca su Controlla ora. Il certificato richiede solitamente 5–30 minuti; quando lo stato è Pubblico, l'indirizzo gratuito reindirizza al tuo dominio. I domini radice come example.com non possono essere connessi. Vedi Connettere un dominio personalizzato a un sito di documentazione.

Lascia che sia il Pilota automatico a costruirlo#

Con il piano Pro e superiori, il Pilota automatico può creare e gestire il centro assistenza per te. Fai clic su Pilota automatico nella barra laterale per iniziare; consulta Ottieni l'accesso al Pilota automatico. Solo il proprietario dell'area di lavoro o un amministratore può utilizzare la ricetta di creazione.

Costruisci un centro assistenza dalla tua app#

In Pilota automatico, clicca sulla ricetta Costruisci un centro assistenza dalla mia app o digita "Costruiscimi un centro assistenza" in Cosa dovrebbe fare il Pilota automatico?. L'agente Clevera mostra una scheda di configurazione. Clicca su Inserisci i dettagli, aggiungi il tuo Sito web e Indirizzo dell'app, scegli un accesso e seleziona le lingue del sito.

Sotto Centro assistenza esistente, scegli Inizia da zero o Importalo e seleziona Intercom, Zendesk, Help Scout, GitBook, ReadMe, Mintlify, Document360, Docusaurus o Un altro sito di documentazione. L'importazione legge solo le pagine pubbliche ed è gratuita. Notion e Confluence vengono importati dalle impostazioni del sito una volta che esiste.

L'attività viene eseguita in quattro passaggi: Brand, Sito e video, Articoli e Revisione e pubblicazione. La pianificazione è gratuita. Vedi il piano di ogni passaggio e i relativi crediti, e nulla viene eseguito finché non clicchi su Esegui. Una costruzione tipica costa 240–560 crediti e richiede 1–3 ore. Clevera non pubblica mai il sito per te: nell'ultimo passaggio scegli gli articoli e clicchi su Pubblica. Vedi Costruire un centro assistenza dalla tua app con il Pilota automatico.

Mantienilo aggiornato quando rilasci#

Una volta che il sito esiste, la ricetta Mantieni il mio centro assistenza aggiornato quando rilasciamo monitora i rilasci o le modifiche unite di un repository, una pagina di registro delle modifiche o una modifica che descrivi. Ogni volta che qualcosa cambia, Clevera controlla i video e gli articoli interessati e pianifica le correzioni. Ogni esecuzione attende la tua revisione; un'esecuzione tipica costa 10–150 crediti. Vedi Mantieni il tuo centro assistenza aggiornato quando rilasci.

Correlati#