Un manuale SEMJAT supportato da screenshot creato dal flusso della dashboard sem.chat reale. Ogni guida ti dice su cosa fare clic, cosa dovrebbe succedere dopo il clic, come testarlo, come risolverlo e cosa fare dopo.
Nessuna guida corrispondente trovata. Prova una parola chiave più breve come widget, API, voce, fatturazione, webhook, WordPress, SendPulse o pianificazione.
Nota sugli screenshot: ogni immagine di questo manuale è stata acquisita dall’app reale sem.chat usando un’area di lavoro demo. Dettagli sensibili dell’account, dati dei clienti, chiavi API, dettagli di pagamento e contenuti delle conversazioni private vengono mascherati prima della pubblicazione.
01
Come iniziare
Crea l'account, completa l'onboarding, comprendi la dashboard, crea il primo bot, testalo in privato, installalo e scegli il piano giusto.
/autRegistrazione, prova e primo bot
1Inizia con Registrati o Accedi dal sito o dall'app pubblica.
2Verifica l'indirizzo email prima di fare affidamento su notifiche o messaggi di fatturazione.
3Utilizza l'onboarding per creare il primo bot prima di aprire la dashboard.
/panoramicaPanoramica dopo il login
1Utilizza le azioni rapide per creare un bot, visualizzare bot, aprire analisi o gestire la fatturazione.
2Esamina i bot attivi, conversations, i minuti vocali e la soddisfazione prima di apportare modifiche.
3Controlla l'attività recente dopo ogni test di configurazione.
Primo lancio
Iscriviti, inizia la prova e comprendi la dashboard
A cosa serve: Utilizza questo flusso di lavoro per uno spazio di lavoro nuovo di zecca o quando inserisci un compagno di squadra che non ha mai utilizzato sem.chat.
Prima di iniziare
Utilizza un'e-mail aziendale in grado di ricevere e-mail di verifica e fatturazione.
Decidi chi dovrebbe essere il proprietario dello spazio di lavoro prima di invitare il resto del team.
Mantieni pronto un sito Web di prova o una pagina di staging sicura per l'installazione del widget.
1
Apri la pagina di registrazione dell'app
Vai ad app.sem.chat/auth dal pulsante Accedi/Registrati del sito web.
Risultato atteso: La pagina di autenticazione mostra le opzioni di accesso e creazione dell'account.
2
Crea l'account
Inserisci l'e-mail aziendale, crea la password e invia il modulo di registrazione.
Risultato atteso: L'app richiede la verifica o passa all'onboarding dopo che l'account è stato accettato.
3
Verificare l'e-mail
Apri l'e-mail di verifica e fai clic sul collegamento di conferma.
Risultato atteso: L'account può ricevere messaggi di fatturazione, invito, report e avviso.
4
Onboarding completo
Inserisci il nome dell'azienda, descrivi l'obiettivo dell'assistente, scegli un colore iniziale e crea il primo bot.
Risultato atteso: L'area di lavoro si apre con una bozza del bot e uno stato di prova attivo.
5
Apri Panoramica
Fai clic su Panoramica nella barra laterale sinistra.
Risultato atteso: La dashboard mostra le schede usage, le azioni rapide e l'attività recente.
6
Scegli l'azione successiva
Utilizza Crea nuovo bot per la configurazione, Visualizza tutti i bot per la gestione, Analisi per le prestazioni o Fatturazione per i limiti del piano.
Risultato atteso: Sai dove continuare in base allo stato dell'area di lavoro.
Come testarlo: Crea un bot di prova privato e invia un messaggio di prova prima di invitare i compagni di squadra. Confermare le modifiche all'attività Panoramica dopo il test.
Problema
Correggi
L'email di verifica non arriva
Controlla lo spam, conferma l'ortografia dell'e-mail, quindi richiedi un'altra e-mail di verifica.
La dashboard si apre su Fatturazione
L'area di lavoro potrebbe richiedere una prova o un piano attivo. Inizia la prova o scegli il piano corretto prima della configurazione.
Un compagno di squadra non può accedere all'area di lavoro
Invitali da Impostazioni, Team invece di condividere l'accesso del proprietario.
Cosa fare dopo: Crea il primo bot, testalo in privato, quindi installa il widget su una pagina di staging.
Test di lancio privato
Crea il primo test del bot privato prima di andare in diretta
A cosa serve: Usalo per verificare l'account, il bot, il widget e il monitoraggio della cronologia prima che i clienti vedano l'assistente.
Prima di iniziare
Tieni pronta una domanda di esempio del cliente.
Tieni pronta una pagina di gestione temporanea o una pagina di test HTML locale.
Non utilizzare dati reali dei clienti nel primo test.
1
Apri My Bots
Fai clic su My Bots nella barra laterale o utilizza Visualizza tutti i bot dalla panoramica.
Risultato atteso: Puoi vedere il bot creato durante l'onboarding o uno stato vuoto con il pulsante Nuovo Bot.
2
Apri il generatore di bot
Fai clic su Nuovo bot o Modifica sul bot esistente.
Risultato atteso: Bot Builder si apre con i controlli Nozioni di base, Widget, Conoscenza, Voce e integrazione.
3
Salva il bot una volta
Inserisci il nome del bot richiesto e il primo messaggio, quindi fai clic su Salva.
Risultato atteso: Il bot riceve un ID valido e può generare codice di incorporamento.
4
Anteprima in privato
Utilizza il pannello di anteprima e poni la tua domanda di esempio.
Risultato atteso: La risposta dovrebbe corrispondere alle tue istruzioni o rivelare quale conoscenza manca.
5
Installa sullo stage
Apri Incorpora, copia lo snippet HTML e incollalo prima del tag body di chiusura nella pagina di staging.
Risultato atteso: Il widget appare nell'angolo configurato su desktop e mobile.
6
Conferma il monitoraggio
Apri Inbox o Chat History dopo la conversazione di prova.
Risultato atteso: La conversazione di prova viene visualizzata con il bot, il canale e la cronologia dei messaggi corretti.
Come testarlo: Invia un messaggio di testo e un test vocale se la voce è abilitata. Conferma che entrambi siano visualizzati in Chat History.
Problema
Correggi
Il codice di incorporamento non è disponibile
Salva prima il bot. Se la sincronizzazione vocale è ancora in sospeso, attendi la sincronizzazione o salva nuovamente dopo aver completato i campi obbligatori.
Il widget mostra il bot sbagliato
Conferma che data-bot-id nello snippet corrisponda all'ID bot dalla modalità Incorpora.
Nessuna conversazione appare nella cronologia
Aggiorna Chat History, conferma che il bot è attivo e assicurati che il test sia avvenuto sul widget installato, non su una pagina obsoleta.
Cosa fare dopo: Passa alla configurazione di Bot Builder e alla formazione teorica.
02
Crea e configura un bot
Crea, modifica, visualizza in anteprima, attiva, trasferisci o rimuovi bot da My Bots e Bot Builder.
/cruscottoMy Bots centro di controllo
1Fare clic su Nuovo Bot per avviare un nuovo assistente.
2Utilizza Modifica, Incorpora, Trasferisci, Attiva o Elimina su ciascuna scheda bot.
3Controlla lo stato attivo e l'ora dell'ultimo aggiornamento prima del test.
/bots/:id/modificaScheda Bot Builder nozioni di base
1Inserisci il nome del bot, l'avatar, il primo messaggio e le istruzioni di sistema.
2Utilizza l'anteprima per testare prima della pubblicazione.
3Salva e sincronizza prima di copiare il codice di incorporamento.
Crea bot
Crea un nuovo bot da My Bots
A cosa serve: Utilizza questo flusso di lavoro quando un nuovo marchio, sito web, coda di supporto o campagna necessita del proprio assistente.
Prima di iniziare
Prepara il nome del bot, l'obiettivo, il primo messaggio e due o tre domande di esempio.
Raccogli il sito web pubblico URL se prevedi di importare contenuti.
Verifica che il piano consenta il numero di bot e funzionalità vocali/avatar di cui hai bisogno.
1
Apri My Bots
Fai clic su My Bots nella barra laterale.
Risultato atteso: I bot esistenti e il pulsante Nuovo bot sono visibili.
2
Fare clic su Nuovo bot
Avvia un nuovo bot dalla pagina My Bots.
Risultato atteso: Bot Builder si apre con un assistente alla bozza.
3
Imposta l'identità del bot
Inserisci il nome del bot, carica o scegli un avatar e scrivi il primo messaggio che i visitatori vedranno.
Risultato atteso: Il pannello di anteprima riflette il nome dell'assistente, l'avatar e il saluto.
4
Scrivere istruzioni di sistema
Descrivi cosa dovrebbe fare il bot, come dovrebbe parlare, cosa dovrebbe evitare e quando dovrebbe chiedere aiuto umano.
Risultato atteso: L'assistente ha regole di comportamento chiare prima che venga aggiunta la conoscenza.
5
Aggiungi conoscenze di base
Incolla le informazioni essenziali su azienda, prodotto, supporto, prezzi e contatto nell'area della conoscenza.
Risultato atteso: Il bot può rispondere a domande comuni senza ancora dover importare il sito web.
6
Salva il bot
Fai clic su Salva e attendi la conferma del salvataggio o della sincronizzazione.
Risultato atteso: Il bot ha un ID stabile, l'anteprima può essere testata e le opzioni di incorporamento diventano disponibili.
7
Anteprima del risultato
Poni le domande campione preparate in Anteprima.
Risultato atteso: Le risposte dovrebbero seguire le istruzioni e utilizzare le conoscenze inserite.
8
Attiva solo quando sei pronto
Attiva il bot una volta superato il test privato.
Risultato atteso: Il bot è pronto per il widget o il traffico del canale.
Come testarlo: Fai almeno cinque domande realistiche. Controlla se la risposta è corretta, se rimane fedele al brand e se richiede l'aiuto umano quando necessario.
Problema
Correggi
La risposta è troppo generica
Aggiungi conoscenze più specifiche e riscrivi le istruzioni con esempi di buone risposte.
Il bot rifiuta le domande a cui dovrebbe rispondere
Rimuovi istruzioni eccessivamente rigide e aggiungi conoscenze attendibili per quell'argomento.
Il salvataggio non genera codice di incorporamento
Controlla i campi obbligatori e salva di nuovo al termine della sincronizzazione del provider vocale.
Cosa fare dopo: Configura le impostazioni del widget, aggiungi la conoscenza del sito web, quindi installa il bot.
Gestisci i bot
Modifica, clona il flusso di lavoro, trasferisci, disattiva o elimina un bot
A cosa serve: Utilizza questo flusso di lavoro quando un bot necessita di aggiornamenti, modifiche della proprietà, pausa temporanea o rimozione permanente.
Prima di iniziare
Esporta qualsiasi conversazione o dato di contatto che devi conservare prima di eliminare un bot.
Verifica che il bot non sia incorporato in un sito Web attivo prima di eliminarlo o trasferirlo.
Dillo ai compagni di squadra prima di disattivare un bot di produzione.
1
Apri My Bots
Trova la scheda bot per nome o stato.
Risultato atteso: La scheda mostra lo stato attuale e le azioni disponibili.
2
Fare clic su Modifica
Apri il generatore di bot e apporta le modifiche richieste.
Risultato atteso: L'editor carica la configurazione corrente.
3
Salva e riprova
Fai clic su Salva dopo ogni modifica del materiale, quindi esegui le domande di anteprima.
Risultato atteso: La configurazione salvata viene utilizzata dall'anteprima e dal widget installato.
4
Disattiva temporaneamente
Utilizza l'interruttore attivo se il bot deve smettere di gestire i visitatori per ora.
Risultato atteso: Il bot smette di servire il traffico in tempo reale preservando la configurazione.
5
Trasferisci la proprietà
Utilizza Trasferimento, inserisci l'e-mail del destinatario e conferma.
Risultato atteso: L'account selezionato riceve la proprietà in base al flusso di trasferimento dell'app.
6
Eliminare solo dopo i controlli
Utilizza Elimina, leggi l'avviso e conferma solo quando il bot non è più necessario.
Risultato atteso: Il bot e la relativa configurazione verranno rimossi in base all'avviso.
Come testarlo: Dopo la modifica, apri il widget installato e poni la domanda esatta che ha motivato la modifica. Conferma la risposta live modificata.
Problema
Correggi
La vecchia risposta appare ancora
Aggiorna la pagina del sito Web, conferma di aver salvato il bot corretto e controlla se la conoscenza importata necessita di una sincronizzazione.
Il trasferimento fallisce
Conferma che l'e-mail del destinatario sia valida e che l'account di destinazione possa accettare il bot.
È stato fatto clic su Elimina per errore
Sosta prima della conferma definitiva. Sono presenti avvisi di eliminazione perché l'azione potrebbe rimuovere i dati del bot in modo permanente.
Cosa fare dopo: Esamina l'analisi e la cronologia dopo le modifiche in tempo reale per assicurarti che l'esperienza dei visitatori sia migliorata.
03
Installa il widget
Copia il codice di incorporamento corretto, installalo in contesti HTML, WordPress, React o avanzati SDK, quindi verifica il comportamento desktop e mobile.
Incorpora modaleCopia lo snippet di installazione del sito web
1Scegli HTML, WordPress, React o NPM/SDK in base allo stack del sito.
2Copia il codice dopo che il bot è stato salvato e sincronizzato.
3Incolla lo snippet prima del tag body di chiusura o nel layout del framework.
HTML installa
Installa il widget su un sito web HTML standard
A cosa serve: Utilizzalo quando puoi modificare il modello di pagina, il piè di pagina del tema o il layout globale di HTML.
Prima di iniziare
Salva prima il bot in modo che la modalità di incorporamento abbia un ID bot reale.
Utilizzare un sito di sosta prima della produzione.
Mantieni la versione esatta dello script e data-bot-id dal file modale.
1
Apri My Bots
Trova il bot che desideri installare e fai clic su Incorpora.
Risultato atteso: La modalità Incorpora si apre con le schede di installazione.
2
Seleziona HTML
Scegli la scheda HTML e fai clic su Copia codice.
Risultato atteso: Lo script del widget viene copiato con l'ID del bot allegato.
3
Apri il modello del sito web
Modifica il piè di pagina globale o il file di layout visualizzato su ogni pagina in cui dovrebbe apparire il widget.
Risultato atteso: Stai modificando la shell del sito condiviso, non una singola pagina isolata a meno che ciò non sia intenzionale.
4
Incolla prima di chiudere il corpo
Incolla lo snippet immediatamente prima del tag body di chiusura.
Risultato atteso: Lo script viene caricato dopo il contenuto della pagina e può montare il contenitore del widget.
5
Pubblica o distribuisci
Salva il modello e distribuisci il sito.
Risultato atteso: Lo script del widget è attivo nelle pagine di destinazione.
6
Prova desktop e dispositivi mobili
Apri il sito in una nuova finestra del browser e su un viewport mobile.
Risultato atteso: Il widget appare nella posizione configurata e si apre senza errori della console.
Come testarlo: Invia un messaggio dalla pagina live, quindi apri Posta in arrivo e Chat History per confermare che la conversazione appartiene al bot corretto.
Problema
Correggi
Manca il widget
Conferma che il codice sia prima del tag body di chiusura, che gli script non siano bloccati dal costruttore del sito e che il bot sia attivo.
Viene visualizzato il bot sbagliato
Copia nuovamente lo snippet e confronta data-bot-id con il bot desiderato.
Il widget si sovrappone ai controlli della pagina
Modifica la posizione o le dimensioni nelle Impostazioni widget e riprova sul dispositivo mobile.
Cosa fare dopo: Ottimizza le impostazioni del widget e acquisisci lead dopo l'installazione.
Installa in WordPress, React o flussi vocali avanzati SDK
A cosa serve: Utilizzalo quando il sito web è gestito da un CMS, un'app React o un'integrazione vocale personalizzata.
Prima di iniziare
Scopri quale stack possiede il layout condiviso.
Utilizza lo snippet esatto mostrato in sem.chat per il bot selezionato.
Per l'utilizzo avanzato di SDK, conferma di avere la chiave pubblica Vapi e l'ID assistente richiesti.
1
Opzione WordPress
Utilizza Aspetto, Editor temi, footer.php o un plugin affidabile per intestazioni e piè di pagina.
Risultato atteso: Lo snippet viene caricato sulle pagine pubbliche WordPress.
2
Opzione React
Crea un piccolo componente ChatWidget, aggiungi lo script in useEffect ed esegui il rendering nel layout root.
Risultato atteso: Il widget si carica una volta e si pulisce se il layout viene smontato.
3
Opzione SDK avanzata
Utilizza la scheda NPM/SDK solo quando hai bisogno di controlli personalizzati per le chiamate vocali oltre al widget predefinito.
Risultato atteso: La tua app controlla la sessione vocale mentre sem.chat rimane l'origine dell'assistente configurata.
4
Verifica l'ID del bot
Conferma che il codice installato faccia riferimento all'ID del bot dalla modalità Incorpora.
Risultato atteso: Il widget live si connette all'assistente desiderato.
5
Controlla la consolle
Apri gli strumenti per sviluppatori del browser e ricarica.
Risultato atteso: Non sono presenti errori di script bloccati, contenitori duplicati o di rete.
Come testarlo: Completa un messaggio di prova dal sito installato, quindi conferma che venga visualizzato nella Posta in arrivo con la pagina prevista URL.
Problema
Correggi
React carica i widget duplicati
Proteggi l'inserimento dello script con un riferimento o esegui il rendering del componente solo nel layout principale.
WordPress rimuove i tag dello script
Utilizza un plugin per l'inserimento del footer o un file del tema che consenta gli script.
Impossibile avviare la chiamata SDK
Controlla la chiave pubblica, l'ID dell'assistente, le autorizzazioni del browser e pianifica l'accesso per la voce.
Cosa fare dopo: Passa alle Impostazioni widget per controllare il comportamento, il branding e l'acquisizione di lead.
npm install @vapi-ai/web
import Vapi from '@vapi-ai/web';
const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');
vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04
Impostazioni del widget
Configura modalità, tema, dimensione, posizione, colore, branding, reazioni, suono, consenso, acquisizione di lead, valutazioni, e-mail di follow-up e stato di attivazione.
Bot Builder / WidgetAspetto del widget e comportamento dei visitatori
1Scegli chat, modalità vocale o ibrida.
2Imposta tema, colore, posizione, dimensione, branding, consenso e suono.
3Configura l'acquisizione dei lead, le valutazioni, le reazioni e il comportamento di follow-up.
Comportamento del widget
Configura il comportamento del widget rivolto ai visitatori
A cosa serve: Utilizzalo dopo la prima installazione o ogni volta che il widget deve corrispondere al sito Web e acquisire contatti migliori.
Prima di iniziare
Installa il widget su una pagina di staging.
Scopri se i visitatori devono iniziare con chat, vocale o entrambi.
Preparare il consenso e la copia per l'acquisizione dei lead, se richiesto per la regione.
1
Apri il generatore di bot
Apri My Bots, fai clic su Modifica, quindi scegli la scheda Widget.
Risultato atteso: I controlli del widget vengono visualizzati per il bot selezionato.
2
Scegli la modalità
Seleziona Chat, Voce o Ibrido in base all'esperienza del visitatore che desideri.
Risultato atteso: L'anteprima cambia per mostrare la modalità scelta.
3
Imposta l'aspetto
Scegli tema, colore, dimensione, posizione del pulsante e opzioni di branding.
Risultato atteso: Il widget si adatta al sito senza coprire contenuti importanti.
4
Abilita i controlli dei visitatori
Attiva o disattiva le reazioni, i suoni, le valutazioni e le richieste di consenso.
Risultato atteso: I visitatori vedono solo i controlli che desideri che utilizzino.
5
Configura l'acquisizione di lead
Scegli i campi obbligatori, il campo descrizione facoltativo e quando viene visualizzato il modulo.
Risultato atteso: I contatti vengono raccolti prima o durante conversations in base alla tua configurazione.
6
Imposta l'e-mail di follow-up
Configura il comportamento delle email di follow-up se il tuo piano lo include.
Risultato atteso: I visitatori possono ricevere messaggi di follow-up dopo aver risolto conversations.
7
Salva e prova
Fai clic su Salva, ricarica la pagina di staging e apri il widget.
Risultato atteso: Il widget live corrisponde alle impostazioni salvate.
Come testarlo: Apri il widget su desktop e dispositivo mobile, invia un modulo per i lead, lascia una valutazione e conferma che il contatto e la conversazione sono registrati.
Problema
Correggi
Il colore non è stato aggiornato
Salva il bot, aggiorna il sito Web e conferma che il widget installato utilizza lo stesso ID bot.
Mancano i campi lead
Confermare che l'acquisizione dell'elettrocatetere sia abilitata e che la condizione di attivazione selezionata sia soddisfatta.
I visitatori non possono usare la voce
Controlla le impostazioni vocali, l'autorizzazione del microfono del browser, l'accesso al piano e i limiti di minuti vocali.
Cosa fare dopo: Aggiungi impostazioni vocali/avatar e fonti di conoscenza prima del lancio della produzione.
05
Voce e avatar
Seleziona voci stock, configura modalità vocale e limiti, leggi trascrizioni, clona voci, assegna voci clonate e gestisci avatar stock o personalizzati.
Bot Builder / VoceVoce, limiti, trascrizioni e avatar
1Scegli una voce stock o una voce clonata salvata.
2Imposta limiti di minuti vocali e salvataggio della trascrizione.
3Scegli avatar di serie o carica un avatar personalizzato se il piano lo consente.
Configurazione vocale
Configura chiamate vocali e trascrizioni
A cosa serve: Usalo quando i visitatori dovrebbero parlare con il bot invece di limitarsi a digitare.
Prima di iniziare
Conferma che il piano includa minuti vocali e le opzioni voce/avatar desiderate.
Utilizza un ambiente browser silenzioso per i test.
Prepara una domanda realistica di supporto o di vendita da testare a voce.
1
Apri le impostazioni vocali
Apri il generatore di bot e seleziona l'area Voce o Voce e avatar.
Risultato atteso: I controlli vocali e la selezione vocale corrente sono visibili.
2
Seleziona una voce di borsa
Visualizza l'anteprima delle voci disponibili, scegli la soluzione migliore e salva la selezione.
Risultato atteso: Il bot utilizza la voce scelta per le chiamate.
3
Configura la modalità vocale
Utilizza le Impostazioni widget per scegliere Voce o Ibrido quando la voce deve essere disponibile per i visitatori.
Risultato atteso: I visitatori vedono un'opzione vocale nel widget.
4
Imposta i limiti vocali
Definire i limiti per utente o area di lavoro, se disponibili.
Risultato atteso: Le chiamate lunghe o ripetute non possono consumare più minuti del previsto.
5
Abilita trascrizioni
Attiva il salvataggio della trascrizione se hai bisogno della revisione delle chiamate nella cronologia.
Risultato atteso: Le chiamate vocali creano trascrizioni leggibili dopo la sessione.
6
Prova una chiamata
Apri il widget, consenti l'accesso al microfono, avvia una chiamata e poni la domanda preparata.
Risultato atteso: Il bot risponde a voce e la chiamata termina in modo pulito.
7
Leggi la trascrizione
Apri Chat History e trova la conversazione vocale.
Risultato atteso: La trascrizione mostra ciò che hanno detto il visitatore e il bot.
Come testarlo: Completa una breve chiamata e conferma che i minuti vocali, la trascrizione e la modalità di conversazione vengono registrati.
Problema
Correggi
Il browser blocca il microfono
Consenti l'autorizzazione del microfono nel browser e ricarica la pagina.
L'opzione vocale è bloccata
Apri Fatturazione e conferma che il piano dell'area di lavoro include funzionalità vocali.
La trascrizione è vuota
Conferma che il salvataggio della trascrizione sia abilitato e che la chiamata sia terminata normalmente.
Cosa fare dopo: Aggiungi o perfeziona le conoscenze in modo che le risposte vocali siano accurate.
Clone vocale e avatar
Clona una voce e assegna un avatar personalizzato
A cosa serve: Usalo quando l'assistente ha bisogno di una voce brandizzata o di un'esperienza avatar parlante.
Prima di iniziare
Utilizza solo audio e immagini per i quali sei autorizzato a utilizzare.
Registra campioni di voce pulita con un basso rumore di fondo.
Conferma i limiti del piano per voci clonate e avatar personalizzati.
1
Apri Clonazione vocale
Fai clic su Clona voce dall'area Voce.
Risultato atteso: La finestra di dialogo di caricamento mostra i requisiti del campione accettati.
2
Carica campioni
Carica da una a cinque registrazioni chiare e invia la richiesta di clonazione.
Risultato atteso: La voce clonata viene visualizzata dopo l'elaborazione oppure la finestra di dialogo mostra il requisito successivo.
3
Assegna la voce clonata
Seleziona la voce clonata nel selettore vocale e salva.
Risultato atteso: Le chiamate future utilizzeranno la voce clonata.
4
Scegli un avatar di serie
Scegli un avatar incluso se non è necessario il caricamento di avatar personalizzato.
Risultato atteso: L'esperienza vocale ha un'identità visiva.
5
Carica avatar personalizzato
Carica un'immagine chiara del viso o un breve video se il tuo piano lo supporta.
Risultato atteso: L'avatar viene elaborato e diventa disponibile per la selezione.
6
Esegui un'anteprima completa
Avvia una chiamata vocale e conferma insieme il comportamento della voce, dell'avatar e della trascrizione.
Risultato atteso: L'esperienza del visitatore corrisponde al marchio configurato.
Come testarlo: Fai una breve domanda con la voce clonata selezionata e conferma che la chiamata utilizza la voce/avatar prevista.
Problema
Correggi
La qualità del clone è scarsa
Registra campioni più puliti con un altoparlante, volume stabile e senza musica.
Il caricamento dell'avatar personalizzato non è disponibile
Controlla la fatturazione per i limiti di avatar vincolati dal piano.
La vecchia voce suona ancora
Salva il bot dopo aver selezionato la nuova voce e ricarica la pagina del widget.
Cosa fare dopo: Procedi a Conoscenza e dati in modo che l'esperienza vocale abbia risposte accurate.
06
Conoscenza e dati
Aggiungi conoscenza manuale, importa contenuti del sito web, applica i risultati della scansione, sincronizza i contenuti importati, aggiungi feed di prodotti URLs, aggiorna o rimuovi feed e verifica le risposte con domande di prova.
Bot Builder / ConoscenzaFonti di conoscenza e test di risposta
1Aggiungi conoscenza manuale per politiche, prezzi e regole del marchio.
2Importa pagine di siti Web e applica i risultati della scansione.
3Aggiungi feed di prodotti e sincronizzali quando l'inventario cambia.
Fonti di conoscenza
Addestra il bot con conoscenze manuali, importazione di siti Web e feed di prodotti
A cosa serve: Utilizzalo ogni volta che l'assistente fornisce risposte incomplete o necessita di nuove informazioni su prodotti, politiche o siti Web.
Prima di iniziare
Prepara la sorgente URLs e il feed prodotto URLs.
Decidi quali pagine non devono essere importate, ad esempio le pagine di amministrazione o quelle private.
Crea domande di prova per ogni argomento che aggiungi.
1
Conoscenza aperta
Apri Bot Builder e scegli la scheda Conoscenza o Dati.
Risultato atteso: Sono visibili la conoscenza manuale, l'importazione di siti Web e gli strumenti di feed dei prodotti.
2
Aggiungi conoscenza manuale
Incolla fatti concisi, politiche, prezzi, dettagli di contatto e note sullo stile delle risposte.
Risultato atteso: Il bot ha una fonte attendibile immediata per risposte ad alta priorità.
3
Importa il contenuto del sito web
Incolla il sito web pubblico URL e avvia la scansione/importazione.
Risultato atteso: I risultati della scansione mostrano le pagine rilevate o lo stato dell'importazione.
4
Esaminare e applicare i risultati
Mantieni le pagine utili, rimuovi le pagine non pertinenti, quindi applica il contenuto selezionato.
Risultato atteso: Solo il contenuto del sito web approvato entra nella knowledge base.
5
Aggiungi feed prodotto URLs
Incolla Google Merchant Center o il feed supportato URLs e importa.
Risultato atteso: Prodotti, prezzi, disponibilità e attributi diventano disponibili per il bot.
6
Aggiorna o rimuovi feed
Utilizza l'aggiornamento quando i dati del catalogo cambiano e rimuovi i feed non più utilizzati.
Risultato atteso: Il bot evita dati di prodotto obsoleti o duplicati.
7
Salva e sincronizza
Salva il bot e attendi il completamento della sincronizzazione.
Risultato atteso: Le informazioni più recenti vengono utilizzate dalle risposte in anteprima e dai widget live.
8
Fai domande di verifica
Fai una domanda di prova per ogni fonte che hai aggiunto.
Risultato atteso: La risposta cita o riflette accuratamente il contenuto aggiornato.
Come testarlo: Poni domande su prezzi, resi, disponibilità, informazioni sull'azienda e argomenti non supportati. Conferma che il bot risponda ad argomenti noti e non inventi dettagli sconosciuti.
Problema
Correggi
Il crawler importa pagine non pertinenti
Rimuovi quelle pagine dai risultati selezionati e aggiungi istruzioni manuali più chiare.
I prezzi dei prodotti sono stantii
Aggiorna il feed e conferma che il feed URL stesso contiene i valori correnti.
Bot inventa risposte
Aggiungi una regola secondo cui il bot dovrebbe dire che non è sicuro e offrire supporto umano quando manca la conoscenza.
Cosa fare dopo: Torna all'anteprima, prova di nuovo, quindi installa o aggiorna il widget.
07
Posta in arrivo, Live Support, Cronologia, Contatti
Gestisci conversations quotidiano, richiedi richieste di supporto live, trasferisci il controllo ad AI, esporta la cronologia, gestisci i contatti e sincronizza i contatti su SendPulse.
/posta in arrivoFlusso di lavoro delle conversazioni della posta in arrivo
1Filtra per bot o canale.
2Apri una conversazione e rispondi come un essere umano quando necessario.
3Utilizza con attenzione i controlli di traduzione, risoluzione e trasferimento.
/live-supportoControllo del trasferimento del supporto live
1Richiedi rapidamente i trasferimenti in attesa.
2Rispondi come agente o restituisci la conversazione all'intelligenza artificiale.
3Risolvere quando il visitatore non ha più bisogno dell'aiuto umano.
/chat-cronologiaCronologia delle conversazioni ed esportazioni
1Cerca per visitatore, bot, canale o data.
2Apri trascrizioni complete per sessioni di testo e vocali.
3Esporta CSV o JSON quando necessario.
/contattiContatti ed esportazione SendPulse
1Filtra i contatti per bot o fonte.
2Apri i dettagli di contatto e il contesto della conversazione.
3Esporta o sincronizza i contatti selezionati su SendPulse.
Risposta dalla posta in arrivo
Apri una conversazione e invia una risposta umana
A cosa serve: Utilizzalo quando un operatore deve rispondere a un cliente da sem.chat invece di lasciare che l'IA continui da sola.
Prima di iniziare
Conferma che l'operatore ha accesso al bot o all'area di lavoro.
Leggi la conversazione prima di rispondere.
Scopri se il visitatore si aspetta la stessa lingua.
1
Apri Posta in arrivo
Fai clic su Posta in arrivo nella barra laterale.
Risultato atteso: Gli conversations recenti vengono visualizzati con bot, canale, visitatore, stato e ora.
2
Filtra se necessario
Utilizza i filtri di canale, bot, da leggere o di stato per trovare la conversazione.
Risultato atteso: L'elenco si restringe al set di conversazioni di cui hai bisogno.
3
Apri la conversazione
Fai clic sulla riga del visitatore.
Risultato atteso: Sono visibili il thread completo, le informazioni sui visitatori e i controlli di risposta.
4
Traduci se necessario
Utilizza i controlli di traduzione quando la lingua del visitatore è diversa dalla lingua dell'agente.
Risultato atteso: L'agente può comprendere e rispondere in modo appropriato.
5
Invia una risposta
Scrivi la risposta umana e inviala.
Risultato atteso: Il messaggio viene aggiunto al thread come risposta di un agente/umano.
6
Risolvere o restare aperti
Risolvi la conversazione se completata o lasciala aperta per il follow-up.
Risultato atteso: Lo stato della casella di posta corrisponde allo stato reale del cliente.
Come testarlo: Invia una risposta di prova sicura a una conversazione di prova e conferma che venga visualizzata nel widget visitatore e in Chat History.
Problema
Correggi
L'invio della risposta non è riuscito
Controlla lo stato della rete, lo stato della conversazione e se è stato richiesto il supporto live.
La lingua dei visitatori è sbagliata
Utilizza la traduzione o aggiorna le impostazioni della lingua del bot prima di rispondere.
La conversazione non è nella Posta in arrivo
Cerca Chat History e conferma che il test del widget ha utilizzato il bot corretto.
Cosa fare dopo: Utilizza Live Support per le code di trasferimento attive e Chat History per i controlli.
Supporto dal vivo
Richiedi, rispondi, restituisci all'IA e risolvi un trasferimento
A cosa serve: Usalo quando l'AI richiede che un essere umano o un visitatore abbia esplicitamente bisogno di un agente.
Prima di iniziare
Avere un agente disponibile prima di abilitare il supporto live.
Definisci quando l'IA deve richiedere l'handoff nelle istruzioni del bot.
Mantieni abilitate le impostazioni di notifica per gli avvisi di trasferimento.
1
Apri Live Support
Fai clic su Live Support nella barra laterale.
Risultato atteso: L'attesa e il trasferimento attivo conversations sono visibili.
2
Reclama la richiesta
Fai clic su Rivendica nella conversazione in attesa.
Risultato atteso: Gli altri agenti possono vedere che la conversazione viene gestita attivamente.
3
Leggi il contesto
Apri i messaggi e i dettagli dei visitatori prima di rispondere.
Risultato atteso: L'agente capisce perché è avvenuto il trasferimento.
4
Invia la risposta umana
Rispondi chiaramente e mantieni aggiornato il thread.
Risultato atteso: Il visitatore riceve una risposta umana.
5
Restituirlo all'IA, se appropriato
Usa la mano indietro quando viene data risposta al problema e l'intelligenza artificiale può continuare.
Risultato atteso: L'intelligenza artificiale riprende a gestire la conversazione.
6
Risolvi una volta terminato
Fai clic su Risolvi dopo che il visitatore non ha più bisogno di aiuto.
Risultato atteso: L'handoff viene chiuso e rimosso dalla coda attiva.
Come testarlo: Crea un trasferimento di prova, richiedilo, rispondi una volta, restituiscilo e conferma le modifiche di stato in Live Support e Chat History.
Problema
Correggi
Gli agenti non rispondono alle richieste
Abilita browser/e-mail/notifiche push e aggiungi un processo per la proprietà della coda.
L’intelligenza artificiale continua a prendere il sopravvento troppo presto
Modifica le istruzioni e le regole di trasferimento in modo che il controllo umano rimanga attivo finché non viene risolto o restituito.
CRM esterno non è sincronizzato
Utilizza webhook o sondaggi dalla sezione Ricette per sviluppatori.
Cosa fare dopo: Connetti CRM/webhooks se i team di supporto lavorano all'esterno di sem.chat.
Storia e contatti
Cerca, esporta e utilizza record di conversazioni/contatti
A cosa serve: Utilizzalo per controlli, revisione dei lead, esportazione CSV e sincronizzazione SendPulse.
Prima di iniziare
Decidi se ti servono conversations, contatti o entrambi.
Applica l'intervallo di date corretto prima dell'esportazione.
Non esportare più dati personali del necessario.
1
Apri Chat History
Fai clic su Chat History nella barra laterale.
Risultato atteso: Sono visibili i filtri delle conversazioni, le statistiche e l'elenco delle trascrizioni.
2
Cerca e filtra
Filtra per bot, canale, modalità, visitatore o intervallo di date.
Risultato atteso: Rimangono visibili solo i conversations corrispondenti.
3
Apri una trascrizione
Fai clic su una conversazione per leggere l'intero thread del messaggio.
Risultato atteso: Sono visibili il contesto completo, i dettagli di contatto e i metadati della conversazione.
4
Esporta conversations
Fare clic su Esporta e scegliere il formato richiesto, se disponibile.
Risultato atteso: L'esportazione contiene i dati della conversazione filtrata.
5
Apri Contatti
Fai clic su Contatti nella barra laterale.
Risultato atteso: I record lead/contatto vengono visualizzati con origine, bot e stato.
6
Filtra ed esporta i contatti
Cerca i contatti, seleziona i record desiderati, quindi esporta o sincronizza su SendPulse.
Risultato atteso: I contatti selezionati sono disponibili all'esterno di sem.chat in base all'azione scelta.
Come testarlo: Esporta un piccolo CSV filtrato e aprilo localmente per verificare che le colonne e l'intervallo di date siano corretti.
Problema
Correggi
Contatto mancante dai Contatti
Conferma che l'acquisizione dei lead sia abilitata e che il visitatore abbia inviato il modulo.
L'esportazione è troppo grande
Restringi l'intervallo di date o il filtro bot prima dell'esportazione.
SendPulse sincronizzazione non disponibile
Connetti prima SendPulse in Integrazioni, quindi torna a Contatti.
Cosa fare dopo: Esamina Analytics per comprendere le tendenze delle prestazioni dopo l'esecuzione delle operazioni.
08
Canali e integrazioni
Connetti Slack, Facebook, Instagram, WhatsApp, Telegram tramite BotFather, credenziali manuali, collegamenti alternativi chat, SendPulse e integrazioni CRM.
/integrazioniCanali, CRM e connessioni email
1Scegli il canale o la scheda di integrazione CRM.
2Segui i passaggi OAuth o credenziali per ciascun provider.
3Disconnetti o riprova le integrazioni dalla stessa pagina.
Collega i canali
Connetti un canale di messaggistica o un'integrazione CRM
A cosa serve: Utilizzalo quando sem.chat deve ricevere conversations all'esterno del widget del sito Web o inviare contatti ad altri strumenti.
Prima di iniziare
Avere accesso amministrativo alla piattaforma esterna.
Scopri quale bot dovrebbe ricevere i messaggi del canale.
Utilizza i canali di prova prima di connettere gli account di produzione.
1
Apri Integrazioni
Fai clic su Integrazioni nella barra laterale.
Risultato atteso: Sono visibili i canali disponibili, gli strumenti CRM, SendPulse e le opzioni del widget del sito web.
2
Scegli l'integrazione
Fai clic su Connetti su Slack, Metacanali, Telegram, SendPulse, CRM o credenziali manuali.
Risultato atteso: Si apre la finestra di dialogo di configurazione o il flusso OAuth.
3
Completa la configurazione del fornitore
Per i canali OAuth, approva le autorizzazioni richieste. Per i canali manuali, incolla il token, il segreto, l'ID account o il webhook richiesti URL.
Risultato atteso: sem.chat memorizza la connessione e mostra l'integrazione come connessa.
4
Assegna il bot
Scegli quale bot dovrà gestire i messaggi da quel canale quando richiesto dalla finestra di dialogo.
Risultato atteso: I messaggi in arrivo vengono indirizzati all'assistente corretto.
5
Testare il canale
Invia un messaggio di prova dal canale esterno.
Risultato atteso: Il messaggio viene visualizzato nella Posta in arrivo o in Chat History nel canale corretto.
6
Se necessario, disconnettiti
Utilizzare Disconnetti dalla scheda di integrazione quando il canale deve interrompersi.
Risultato atteso: sem.chat interrompe la ricezione o l'invio tramite tale integrazione.
Come testarlo: Invia un messaggio di prova attraverso il canale connesso e conferma la risposta del bot, la riga della posta in arrivo e il record della cronologia.
Problema
Correggi
Il token Telegram non riesce
Crea o reimposta il token in BotFather e incollalo di nuovo.
I messaggi Slack non arrivano
Controlla gli ambiti dell'app, la sottoscrizione all'evento URL, il token del bot, il segreto di firma e l'appartenenza al canale.
La connessione al metacanale non riesce
Conferma che l'account Facebook/Instagram/WhatsApp disponga delle autorizzazioni di amministratore e dell'accesso aziendale richiesto.
La sincronizzazione di SendPulse non riesce
Riconnetti SendPulse e conferma che i campi dei contatti sono mappati.
Cosa fare dopo: Documentare la proprietà del canale per il team e monitorare la posta in arrivo dopo il lancio.
09
Pianificazione
Crea tipi di eventi, configura la disponibilità, collega calendari, gestisci le prenotazioni, crea collegamenti una tantum, configura e-mail di prenotazione, esamina analisi, imposta eventi a pagamento e testa collegamenti di prenotazione pubblici.
/programmazionePianificazione dell'area di lavoro
1Utilizza le schede per Tipi di eventi, Prenotazioni, Analisi, Collegamenti unici, Calendari, Email e Impostazioni.
2Modifica, copia, incorpora, attiva o metti in pausa i tipi di eventi.
3Copia il collegamento pubblico ed esegui un test di prenotazione privato.
Redattore di eventiConfigurazione del tipo di evento
1Inserisci nome, descrizione, durata, posizione e buffer.
2Imposta disponibilità, finestre di prenotazione, domande, opzioni per eventi a pagamento e regole di cancellazione.
3Salva l'evento prima di condividere il collegamento.
/book/:nomeutente/:eventSlugPagina di prenotazione pubblica
1I visitatori scelgono una data dalla pagina di prenotazione pubblica.
2I visitatori scelgono una fascia oraria disponibile.
3I visitatori confermano la prenotazione e ricevono e-mail di conferma.
Tipo di evento
Crea un tipo di evento e pubblica un link di prenotazione
A cosa serve: Utilizzalo quando i visitatori devono prenotare demo, consulenze, chiamate di vendita, onboarding o sessioni di supporto.
Prima di iniziare
Scegli il nome dell'evento, la durata, il tipo di riunione e il proprietario.
Imposta il fuso orario e la disponibilità prima di condividere i collegamenti.
Collega i calendari se la doppia prenotazione è importante.
1
Apri la pianificazione
Fai clic su Pianificazione nella barra laterale.
Risultato atteso: L'area di lavoro di pianificazione mostra schede per tipi di eventi, prenotazioni, analisi, collegamenti una tantum, calendari, e-mail e impostazioni.
2
Crea un tipo di evento
Fai clic su Crea, quindi aggiungi nome, descrizione, durata, posizione, buffer e regole di prenotazione.
Risultato atteso: L'evento ha abbastanza informazioni pubbliche affinché i visitatori possano capirlo.
3
Imposta la disponibilità
Configura l'orario settimanale, la sostituzione della data, le finestre di avviso e la finestra di prenotazione.
Risultato atteso: I visitatori vedono solo gli orari che sei disposto a offrire.
4
Aggiungi domande
Aggiungi le domande obbligatorie, ad esempio telefono, azienda, sito Web o obiettivo della riunione.
Risultato atteso: Le prenotazioni raccolgono il contesto di cui il tuo team ha bisogno prima della chiamata.
5
Connetti calendari
Apri Calendari e connetti Google, Outlook o iCal se disponibile.
Risultato atteso: Gli orari di punta possono essere bloccati e le prenotazioni confermate possono essere scritte nel calendario.
6
Imposta e-mail e promemoria
Apri Email e configura i messaggi di conferma, promemoria, annullamento e riprogrammazione.
Risultato atteso: I visitatori ricevono la corretta comunicazione di prenotazione.
7
Condividi e testa il collegamento pubblico
Copia il link dell'evento, aprilo in una finestra privata, scegli uno slot e completa una prenotazione di prova.
Risultato atteso: La prenotazione appare nella scheda Prenotazioni e vengono inviati messaggi di conferma.
Come testarlo: Completa una prenotazione di prova, una riprogrammazione e una cancellazione. Conferma che ogni evento venga visualizzato in Pianificazione e calendari collegati.
Problema
Correggi
Nessun orario appare sulla pagina pubblica
Controlla il fuso orario, la disponibilità settimanale, le modifiche della data, la finestra di avviso e i conflitti di calendario connessi.
Manca l'e-mail di prenotazione
Controlla le impostazioni e-mail e la cartella spam, quindi invia un'altra prenotazione di prova.
Il pagamento non riesce in un evento a pagamento
Verifica che le impostazioni di integrazione di fatturazione/pagamento e la valuta siano valide prima della pubblicazione.
Cosa fare dopo: Incorpora i link di prenotazione nel bot, nel sito web o nelle email di follow-up.
Pianificazione avanzata
Utilizza collegamenti unici, analisi, incorporamenti ed eventi a pagamento
A cosa serve: Utilizzalo quando la pianificazione richiede disponibilità temporanea, reporting, prenotazione incorporata o pagamento.
Prima di iniziare
Crea prima almeno un tipo di evento.
Connetti i calendari prima di utilizzare pesantemente collegamenti una tantum.
Definire la politica di rimborso/cancellazione prima di abilitare gli eventi a pagamento.
1
Crea un collegamento una tantum
Apri Collegamenti una tantum, seleziona gli slot o le regole offerti, quindi genera il collegamento.
Risultato atteso: Il destinatario può prenotare solo dalla disponibilità selezionata.
2
Incorpora la pianificazione
Utilizza l'opzione di incorporamento della scheda evento se il flusso di prenotazione deve apparire sul tuo sito web.
Risultato atteso: L'interfaccia utente di prenotazione può essere posizionata nella pagina in cui i visitatori effettuano la conversione.
3
Esaminare l'analisi della pianificazione
Apri Analytics all'interno di Scheduling.
Risultato atteso: Puoi visualizzare le prenotazioni, le tendenze di completamento e le prestazioni del tipo di evento.
4
Abilita eventi a pagamento
Apri l'editor degli eventi, imposta il prezzo, la valuta e il comportamento di pagamento.
Risultato atteso: I visitatori devono completare la fase di pagamento in base alla configurazione dell'evento.
5
Prenotazioni di audit
Apri Prenotazioni ed esamina le voci imminenti, completate, annullate e riprogrammate.
Risultato atteso: Il team può gestire le presenze e il follow-up.
Come testarlo: Prenota tramite la pagina pubblica e tramite una pagina incorporata se utilizzata. Conferma che entrambi creano lo stesso tipo di record di prenotazione.
Problema
Correggi
Il collegamento una tantum espone gli slot errati
Rigenera il collegamento con un set di slot più piccolo o un intervallo di date più rigoroso.
La prenotazione incorporata è troppo ristretta
Posiziona l'incorporamento in un contenitore di contenuti più ampio e controlla il layout mobile.
Le analisi sembrano vuote
Creare o attendere prenotazioni reali; l'analisi dipende dai record delle prenotazioni.
Cosa fare dopo: Collega i risultati della pianificazione a report e analisi.
10
Analisi e report
Scegli intervalli di date, utilizza date personalizzate, leggi le metriche principali, esporta CSV, esamina le tendenze di soddisfazione e conversazione, configura report e-mail e verifica la consegna.
/analiticaCruscotto di analisi
1Scegli intervalli di date o date personalizzate.
2Leggi le metriche di conversazione, soddisfazione, lingua, canale e conversione.
3Esporta CSV per l'analisi offline.
Impostazioni/RapportiConfigurazione del rapporto via e-mail
1Scegli la cadenza del rapporto giornaliero, settimanale o mensile.
2Aggiungi destinatari del rapporto.
3Invia un rapporto istantaneo per testare la consegna.
Revisione dell'analisi
Leggi analisi ed esporta dati sulle prestazioni
A cosa serve: Utilizzalo per revisioni settimanali, controlli del lancio, revisione della qualità del supporto e analisi delle conversioni.
Prima di iniziare
Scegli l'intervallo di date prima di leggere le metriche.
Scopri quale bot o canale stai valutando.
Escludi le date dei test privati quando riporti le prestazioni di produzione.
1
Apri Analisi
Fai clic su Analisi nella barra laterale.
Risultato atteso: Le metriche della dashboard e i pannelli grafici sono visibili.
2
Scegli l'intervallo di date
Seleziona oggi, 7 giorni, 30 giorni o date personalizzate.
Risultato atteso: Tutti i grafici si aggiornano al periodo selezionato.
3
Leggi le metriche principali
Esamina conversations, minuti vocali, soddisfazione, conversione e mix di canali.
Risultato atteso: Comprendi il volume e la qualità delle interazioni con i clienti.
4
Esaminare le tendenze
Osserva le tendenze della conversazione, i cambiamenti nella soddisfazione, le domande principali e i modelli di lingua/canale.
Risultato atteso: Puoi identificare dove migliorare le istruzioni o il personale del bot.
5
Esporta CSV
Utilizza Esporta CSV quando il team necessita dell'analisi del foglio di calcolo.
Risultato atteso: CSV contiene l'intervallo di date e le metriche selezionati.
6
Trasforma i risultati in cambiamenti
Aggiorna le istruzioni del bot, la conoscenza, le impostazioni del widget o la copertura del supporto in base ai dati.
Risultato atteso: L'analisi porta a miglioramenti concreti del prodotto.
Come testarlo: Esporta una piccola data personalizzata CSV e verifica che l'intervallo di date e le metriche corrispondano a ciò che mostra la dashboard.
Problema
Correggi
I parametri sembrano troppo alti
Controlla se la gestione temporanea/test conversations è inclusa nell'intervallo di date selezionato.
La soddisfazione è vuota
Abilita le valutazioni nelle Impostazioni widget e attendi che i visitatori lascino valutazioni.
I minuti vocali non corrispondono alle aspettative
Conferma che la modalità vocale sia abilitata solo sui bot previsti.
Cosa fare dopo: Pianifica report via email per una visibilità ricorrente.
Rapporti
Configura report e-mail ricorrenti e prova la consegna
A cosa serve: Utilizzalo quando proprietari, gestori o clienti necessitano di riepiloghi automatici delle prestazioni.
Prima di iniziare
Decidere chi dovrebbe ricevere i report.
Utilizza indirizzi email verificati.
Scegli una cadenza che corrisponda ai ritmi di revisione aziendale.
1
Apri Impostazioni, quindi Rapporti
Vai su Impostazioni e seleziona la scheda Rapporti oppure utilizza il reindirizzamento Rapporti, se disponibile.
Risultato atteso: Sono visibili la cadenza del report, i destinatari e la cronologia.
2
Scegli la cadenza
Abilita report giornalieri, settimanali o mensili.
Risultato atteso: La pianificazione del report viene archiviata per l'area di lavoro.
3
Aggiungi destinatari
Inserisci gli indirizzi email che dovrebbero ricevere i report.
Risultato atteso: I report vengono inviati alle parti interessate corrette.
4
Invia un rapporto istantaneo
Fare clic su Invia ora o sull'azione equivalente del report istantaneo.
Risultato atteso: Viene inviata immediatamente un'e-mail di report per la verifica.
5
Esaminare la cronologia dei rapporti
Controlla il pannello della cronologia dopo l'invio dei report.
Risultato atteso: Puoi confermare lo stato e i tempi di consegna.
Come testarlo: Invia un report istantaneo a un destinatario di prova e conferma la ricezione e la formattazione.
Problema
Correggi
L'email di segnalazione non arriva
Controlla l'ortografia del destinatario, la cartella spam e segnala lo stato della cronologia.
Le persone sbagliate ricevono segnalazioni
Aggiorna i destinatari e salva prima del prossimo invio pianificato.
Il contenuto del report sembra rumoroso
Modifica le aspettative relative all'intervallo di date e utilizza Analytics per una revisione manuale più approfondita.
Cosa fare dopo: Utilizza la cadenza del report come ritmo operativo per i miglioramenti del bot.
Avvia o aggiorna piani, gestisci il portale di fatturazione, invita compagni di squadra, imposta ruoli, modifica profilo/lingua, configura notifiche, abilita 2FA, utilizza azioni in zone di pericolo ed esegui il flusso di lavoro di affiliazione.
/fatturazionePianificazione e controlli di fatturazione
1Esamina il piano attuale, lo stato di prova e i limiti di usage.
2Confronta le funzionalità del piano prima dell'aggiornamento.
3Apri il portale di fatturazione per fatture, metodi di pagamento, cancellazione o riattivazione.
/impostazioniImpostazioni, squadra e sicurezza
1Utilizza Generale per il profilo e la lingua.
2Utilizza Team per inviti e ruoli.
3Utilizza la sicurezza per 2FA, chiavi API e azioni in zone di pericolo.
/affiliatoControlli del programma di affiliazione
1Partecipa al programma per creare un link di riferimento.
2Copia il link di riferimento per le campagne.
3Imposta l'e-mail di pagamento e richiedi pagamenti idonei.
Fatturazione
Avvia, aggiorna, annulla o riattiva un piano
A cosa serve: Utilizzalo quando l'area di lavoro necessita di attivazione di prova, più limiti, fatture, aggiornamenti di pagamento o modifiche all'abbonamento.
Prima di iniziare
Il proprietario dell'account o l'amministratore della fatturazione deve eseguire le azioni di fatturazione.
Conferma quali funzionalità sono pianificate: voce, voci clonate, avatar personalizzati, API, team, CRM e canali.
Utilizza il portale di fatturazione sicuro per le modifiche al metodo di pagamento e alla fattura.
1
Fatturazione aperta
Fai clic su Fatturazione nella barra laterale.
Risultato atteso: Sono visibili il piano attuale, lo stato di prova, i limiti di usage e le schede del piano.
2
Confronta i piani
Controlla chat, voce, team, API, avatar, integrazione, pianificazione e limiti di supporto.
Risultato atteso: Sai quale piano sblocca la funzionalità necessaria.
3
Scegli l'intervallo di fatturazione
Seleziona mensile o annuale se l'interruttore è disponibile.
Risultato atteso: Aggiornamento di prezzi e risparmi per l'intervallo selezionato.
4
Aggiorna o avvia il pagamento
Scegli il piano desiderato e completa il checkout.
Risultato atteso: L'abbonamento diventa attivo dopo la conferma del pagamento.
5
Apri il portale clienti
Utilizza il portale di fatturazione per metodi di pagamento, fatture, cancellazioni o riattivazioni.
Risultato atteso: Le azioni di fatturazione sensibili avvengono nel portale sicuro del fornitore.
6
Verifica l'accesso alle funzionalità
Torna alla funzione che era bloccata e ricarica l'app.
Risultato atteso: La funzionalità sbloccata è ora disponibile se il piano la include.
Come testarlo: Dopo l'aggiornamento, apri la funzionalità precedentemente bloccata, come il clone vocale o i tasti API, e conferma che il blocco è stato rimosso.
Problema
Correggi
La funzionalità rimane bloccata dopo l'aggiornamento
Aggiorna l'app, attendi qualche istante per la sincronizzazione dell'abbonamento, quindi controlla nuovamente Fatturazione.
Il pagamento è stato annullato
Torna a Fatturazione e avvia nuovamente il pagamento; non si verificano modifiche al piano dopo un checkout annullato.
Necessita di cambio fattura o carta
Apri il portale clienti invece di modificare i dettagli di pagamento all'interno dell'app.
Cosa fare dopo: Invita i compagni di squadra e proteggi l'account del proprietario.
Squadra e sicurezza
Invita compagni di squadra, imposta ruoli, modifica profilo, abilita 2FA e gestisci le impostazioni
A cosa serve: Utilizzatelo quando l'area di lavoro passa dalla configurazione individuale al funzionamento in team.
Prima di iniziare
Conosci il ruolo di ogni compagno di squadra prima di inviare inviti.
Utilizza l'accesso con privilegi minimi: proprietario, amministratore, editor, visualizzatore.
Avere un'app di autenticazione pronta per 2FA.
1
Apri Impostazioni
Fai clic su Impostazioni nella barra laterale.
Risultato atteso: Sono visibili le schede Generale, Notifiche, Team, Report, Sviluppatori, Sicurezza e correlate.
2
Modifica profilo e lingua
Aggiorna il nome visualizzato, le informazioni del profilo e la lingua preferita in generale.
Risultato atteso: L'app identifica correttamente l'utente e utilizza la lingua scelta ove disponibile.
3
Invita i membri del team
Apri Team, inserisci un'e-mail, scegli un ruolo e invia l'invito.
Risultato atteso: Il compagno di squadra riceve un collegamento di invito e appare come in sospeso finché non viene accettato.
4
Imposta le autorizzazioni del ruolo
Utilizza Proprietario per il controllo completo, Amministratore per la gestione, Editor per le modifiche ai contenuti e Visualizzatore per l'accesso in sola lettura.
Risultato atteso: Ciascun utente dispone di un accesso adeguato alla propria responsabilità.
5
Configura le notifiche
Scegli e-mail, browser, push, supporto live, fatturazione e notifiche di report.
Risultato atteso: Le persone giuste ricevono avvisi senza rumore inutile.
6
Abilita 2FA
Apri Sicurezza, abilita l'autenticazione a due fattori, scansiona il codice e memorizza i dettagli di ripristino.
Risultato atteso: L'account richiede un secondo fattore dopo l'accesso con password.
7
Utilizzare con attenzione le azioni nelle zone di pericolo
Esporta i dati necessari e conferma i widget/integrazioni attivi prima di azioni distruttive sull'account.
Risultato atteso: L'area di lavoro evita la perdita accidentale di dati.
Come testarlo: Invita un compagno di squadra di test, accetta l'invito in un browser separato e conferma che il ruolo espone solo le funzionalità previste.
Problema
Correggi
E-mail di invito mancante
Controlla lo spam, invia nuovamente l'invito e verifica l'indirizzo.
Il compagno di squadra vede troppo
Riduci il loro ruolo e rivedi le impostazioni di accesso ai bot.
La configurazione 2FA non riesce
Controlla l'ora del dispositivo, scansiona nuovamente il codice QR e memorizza i dettagli di ripristino prima di fare affidamento su di esso.
Cosa fare dopo: Configura le chiavi API solo per gli utenti e i servizi che ne hanno bisogno.
Affiliato
Unisciti all'affiliato, copia il link di riferimento, imposta l'e-mail di pagamento e richiedi il pagamento
A cosa serve: Utilizzalo quando un partner o un cliente desidera segnalare nuovi utenti sem.chat e monitorare l'attività delle commissioni.
Prima di iniziare
Utilizza l'account che dovrebbe possedere l'attribuzione dei referral.
Preparare l'e-mail di pagamento prima di richiedere il pagamento.
Controlla le regole del programma prima di pubblicare campagne di referral.
1
Apri affiliazione
Fai clic su Affiliato nella barra laterale o apri la scheda Affiliato da Impostazioni se collegata lì.
Risultato atteso: La pagina del programma di affiliazione mostra le aree di adesione, referral, pagamento e cronologia.
2
Partecipa al programma
Fai clic su Partecipa se l'account non è ancora stato iscritto.
Risultato atteso: Vengono creati un codice di riferimento e un collegamento di riferimento.
3
Copia il link di riferimento
Copia il collegamento univoco e utilizzalo nei contenuti, nelle campagne o nei messaggi dei partner.
Risultato atteso: Le iscrizioni tramite il collegamento possono essere attribuite all'account affiliato.
4
Imposta l'e-mail di pagamento
Inserisci l'e-mail di pagamento e salvala.
Risultato atteso: I pagamenti idonei possono essere instradati correttamente.
5
Esamina referenze e commissioni
Controlla l'elenco dei referral, lo stato delle commissioni e la cronologia dei pagamenti.
Risultato atteso: Sai cosa è in sospeso, idoneo o già pagato.
6
Richiedi il pagamento
Fai clic su Richiedi pagamento quando vengono soddisfatte le regole e i minimi del programma.
Risultato atteso: La richiesta di pagamento viene registrata per l'elaborazione.
Come testarlo: Apri il link di riferimento in un browser privato e conferma che arrivi al flusso di registrazione previsto con il monitoraggio dei riferimenti.
Problema
Correggi
Manca il collegamento di riferimento
Partecipa prima al programma o aggiorna la pagina di affiliazione dopo l'adesione.
Richiesta di pagamento non disponibile
Controlla la soglia minima di pagamento, lo stato della commissione idonea e l'e-mail di pagamento.
Referral non attribuito
Conferma che il visitatore abbia utilizzato l'esatto link di riferimento e non abbia rimosso i parametri di monitoraggio.
Cosa fare dopo: Utilizza analisi e report per monitorare l'impatto dei clienti segnalati, se applicabile.
12
Notifiche e App Updates
Esamina gli avvisi, contrassegna le notifiche come lette, filtra gli eventi importanti e utilizza gli aggiornamenti dell'app per comprendere le modifiche dei nuovi prodotti.
/notificheCentro notifiche
1Utilizza Contrassegna tutti come letti dopo aver esaminato gli avvisi non letti.
2Filtra per dati da leggere, fatturazione, supporto in tempo reale o eventi di sistema.
3Apri la funzionalità correlata dopo aver letto l'avviso.
/app-aggiornamentiFeed degli aggiornamenti dell'app
1Leggi le note sulla versione per nuove funzionalità e correzioni.
2Utilizza i dettagli per formare i compagni di squadra prima delle modifiche al flusso di lavoro.
3Controlla gli aggiornamenti dopo aver notato modifiche all'interfaccia utente o al comportamento.
Notifiche
Esamina le notifiche e agisci in base agli avvisi
A cosa serve: Utilizzalo quando l'app segnala trasferimenti, stato di fatturazione, eventi di sistema, consegna di report o attività importanti nell'area di lavoro.
Prima di iniziare
Assicurati che le preferenze di notifica siano impostate in Impostazioni.
Avere una copertura di supporto live se gli avvisi di trasferimento sono abilitati.
Esamina gli avvisi non letti prima di contrassegnarli come letti.
1
Apri notifiche
Fai clic su Notifiche nella barra laterale o nella voce di notifica dell'intestazione dell'app.
Risultato atteso: Il centro notifiche elenca gli avvisi recenti.
2
Filtra avvisi
Utilizza i filtri da leggere o di categoria per concentrarti su fatturazione, supporto in tempo reale, bot, report o eventi di sistema.
Risultato atteso: Restano visibili solo gli avvisi corrispondenti.
3
Apri la pagina correlata
Fai clic sull'avviso o utilizza il relativo contesto per aprire Fatturazione, Live Support, Rapporti o il bot pertinente.
Risultato atteso: Agisci in base alla notifica anziché limitarti a leggerla.
4
Marco ha letto
Contrassegna un singolo avviso come letto o utilizza Contrassegna tutti letti dopo la revisione.
Risultato atteso: I conteggi non letti e gli elementi recensiti non sono più evidenziati.
5
Regola le preferenze
Apri Impostazioni, Notifiche se arrivano troppi o troppo pochi avvisi.
Risultato atteso: Il flusso di notifiche soddisfa le esigenze del team.
Come testarlo: Crea un evento di test sicuro come una richiesta di supporto live o un report istantaneo, quindi conferma che la notifica venga visualizzata e possa essere contrassegnata come letta.
Problema
Correggi
Non arriva alcuna notifica
Controlla le preferenze di notifica delle Impostazioni, l'autorizzazione del browser e se l'evento è effettivamente accaduto.
Troppi avvisi
Disabilita le categorie rumorose o inviale solo ai membri del team responsabili.
Il conteggio dei documenti non letti sembra bloccato
Aggiorna l'app dopo aver contrassegnato tutti i filtri letti e conferma che non nascondono gli elementi non letti.
Cosa fare dopo: Controlla App Updates quando il comportamento cambia o vengono visualizzati nuovi controlli.
Aggiornamenti dell'app
Utilizza gli aggiornamenti dell'app per comprendere le modifiche al prodotto
A cosa serve: Utilizzalo quando i compagni di squadra devono sapere cosa è cambiato prima di utilizzare una nuova funzionalità.
Prima di iniziare
Aggiornamenti aperti dopo versioni principali o quando l'interfaccia utente cambia.
Condividi note di aggiornamento pertinenti con gli utenti del supporto e delle vendite.
Ritestare i flussi di lavoro critici dopo modifiche importanti.
1
Apri App Updates
Fai clic su App Updates nella barra laterale.
Risultato atteso: Il feed di aggiornamento mostra nuove funzionalità, correzioni e note sulla versione.
2
Leggi l'ultimo aggiornamento
Apri la scheda di aggiornamento più recente o la visualizzazione dei dettagli.
Risultato atteso: Puoi vedere cosa è cambiato e quale flusso di lavoro influisce.
3
Mappa la modifica al tuo flusso di lavoro
Identifica se l'aggiornamento interessa bot, widget, supporto, pianificazione, fatturazione o sviluppatori.
Risultato atteso: I membri giusti del team sanno cosa controllare.
4
Ritestare i percorsi critici
Se l'aggiornamento influisce su un flusso di lavoro di produzione, ripetere i passaggi manuali pertinenti da questa documentazione.
Risultato atteso: Il team conferma che il flusso di lavoro modificato funziona ancora.
5
Condividere internamente
Invia il riepilogo dell'aggiornamento agli utenti proprietari dell'area interessata.
Risultato atteso: L'adozione da parte del team è più agevole e le domande di supporto diminuiscono.
Come testarlo: Dopo un aggiornamento pertinente, ripeti la guida per la funzionalità interessata e verifica che gli screenshot o i nomi dei passaggi corrispondano ancora.
Problema
Correggi
L'aggiornamento menziona una funzionalità bloccata
Apri Fatturazione per confermare se il piano attuale la include.
La squadra ha mancato un cambio
Aggiungi la revisione App Updates al rilascio o alle routine operative settimanali.
La documentazione sembra obsoleta dopo un aggiornamento
Utilizza la Guida per l'ingegnere per aggiornare screenshot e passaggi.
Cosa fare dopo: Mantieni aggiornata la documentazione pubblica man mano che le funzionalità si evolvono.
13
Ricette per sviluppatori
Genera chiavi API, utilizza l'autenticazione x-api-key, chiama endpoint basati su azioni, collega il supporto live a un CRM, registra webhook, verifica le firme e incorpora il widget nel codice.
Impostazioni/SviluppatoriTasti API, avvio rapido e schede usage
1Genera e revoca le chiavi API dalla scheda Chiavi API.
2Utilizza Quick Start per i primi esempi di arricciatura.
3Esaminare l'utilizzo prima di abilitare l'automazione a volume elevato.
API avvio rapido
Genera una chiave API ed effettua le prime chiamate API
A cosa serve: Utilizzalo per segnalare script, app personalizzate, bridge CRM, supporto live esterno o automazione.
Prima di iniziare
Utilizzare un ambiente lato server. Non esporre le chiavi API nel browser JavaScript.
Genera una chiave separata per ogni integrazione.
Copia immediatamente la chiave perché i segreti vengono visualizzati una volta.
1
Apri sviluppatori
Apri Impostazioni e seleziona Sviluppatori oppure utilizza il reindirizzamento Sviluppatori, se disponibile.
Risultato atteso: Sono visibili le schede API Chiavi, Quick Start, Documentazione e Utilizzo.
2
Genera una chiave
Fai clic su Genera chiave, assegnagli un'etichetta chiara e copiala immediatamente.
Risultato atteso: La chiave inizia con sk_live_ ed è disponibile per le richieste lato server.
3
Invia intestazione x-api-key
Includi x-api-key in ogni richiesta API pubblica.
Risultato atteso: Il pubblico API può autenticare la richiesta e definirne l'ambito al proprietario.
4
Elenca i bot
Chiama action=list-bots per trovare l'ID bot che ti serve.
Risultato atteso: La risposta restituisce ID bot, nomi, stato attivo e riepilogo della configurazione.
5
Invia un messaggio chat
POST azione chat con botId e messaggio.
Risultato atteso: La risposta restituisce informazioni sulla risposta, sul modello e su usage.
6
Controlla usage
Chiama action=usage prima di eseguire lavori ad alto volume.
Risultato atteso: Conosci il piano attuale e lo stato di usage prima dell'esecuzione dell'automazione.
7
Ruotare le chiavi quando necessario
Revocare le chiavi inutilizzate e generarne di nuove per fornitori o servizi modificati.
Risultato atteso: I vecchi servizi non possono continuare a utilizzare credenziali obsolete.
Come testarlo: Esegui list-bots e chat da un terminale locale o da un ambiente server, quindi conferma che la conversazione venga visualizzata in Chat History se chat è stato inviato.
Problema
Correggi
401 o risposta non autorizzata
Controlla l'ortografia di x-api-key, copia la chiave completa e conferma che non è stata revocata.
Bot non trovato
Utilizza nuovamente list-bots e conferma che il bot appartiene al proprietario della chiave API.
Problema CORS del browser
Sposta la chiamata API nel tuo backend; Le chiavi API sono destinate all'uso lato server.
Cosa fare dopo: Utilizza /api-docs per un riferimento mirato agli endpoint e mantieni questa pagina come guida al flusso di lavoro.
Elenca i bot
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
Invia un messaggio chat
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"action": "chat",
"botId": "YOUR_BOT_ID",
"message": "What can you help me with?"
}'
Bridge CRM con supporto live
Effettua un sondaggio o invia richieste di supporto live a CRM
A cosa serve: Utilizzalo quando gli agenti lavorano in un altro sistema ma sem.chat riceve la conversazione dei visitatori.
Prima di iniziare
Crea una chiave API dedicata denominata per il bridge CRM.
Decidi se il polling o i webhook sono adatti alla tua infrastruttura.
Assicurati che CRM memorizzi gli ID delle conversazioni per risposte/risoluzioni future.
1
Elenca i trasferimenti in attesa
GET action=live-support-list con status=richiesto o status=all.
Risultato atteso: Il CRM riceve il conversations aperto che richiede l'attenzione umana.
2
Recupera i messaggi
GET azione=live-support-messages con conversationId.
Risultato atteso: CRM contiene il contesto completo della discussione e i dettagli dei visitatori.
3
Reclama prima di rispondere
POST azione=live-support-claim.
Risultato atteso: sem.chat contrassegna la conversazione come gestita attivamente.
4
Invia la risposta dell'agente
POST action=live-support-reply con conversationId, messaggio e agentName.
Risultato atteso: Il visitatore riceve la risposta umana e gli aggiornamenti del thread.
5
Risolvi o restituisci
POST action=live-support-resolve con risoluzione risoluzione o restituzione.
Risultato atteso: La conversazione lascia la coda di attesa o l'IA riprende il controllo.
6
Accedi allo stato in CRM
Memorizza lo stato di trasferimento, l'ID del messaggio e i timestamp più recenti.
Risultato atteso: CRM e sem.chat rimangono controllabili.
Come testarlo: Crea un trasferimento sicuro, esegui il mirroring su CRM, rispondi dal bridge e conferma gli aggiornamenti del thread del visitatore.
Problema
Correggi
Biglietti CRM duplicati
Utilizza conversationId come chiave di idempotenza nel tuo bridge CRM.
Le risposte arrivano fuori ordine
Memorizza i timestamp dei messaggi ed evita risposte simultanee da più sistemi.
L'intelligenza artificiale risponde mentre l'agente sta lavorando
Richiedi prima il trasferimento e restituiscilo solo quando l'agente ha finito.
Cosa fare dopo: Registra i webhook se il polling è troppo lento o troppo costoso.
Webhook
Registra i webhook e verifica X-SemChat-Signature
A cosa serve: Utilizzalo quando il tuo sistema necessita di eventi in tempo reale per trasferimenti, messaggi e aggiornamenti della risoluzione.
Prima di iniziare
Il webhook URL deve essere HTTPS e raggiungibile dalla rete Internet pubblica.
Archiviare immediatamente il segreto del webhook; viene mostrato una volta.
Verificare le firme prima di elaborare gli eventi.
1
Registra il webhook
POST azione webhook-register con URL ed eventi.
Risultato atteso: La risposta include i dettagli del webhook e un segreto per la firma una tantum.
2
Conserva il segreto
Salva il segreto nel tuo ambiente server o nel gestore dei segreti.
Risultato atteso: Le consegne future possono essere verificate.
3
Verifica la firma
Leggi X-SemChat-Signature e confrontalo con un HMAC SHA-256 sul corpo della richiesta non elaborata.
Risultato atteso: Sono accettate solo consegne autentiche sem.chat.
4
Gestire i tentativi in modo idempotente
Utilizza l'ID evento o l'ID conversazione/messaggio per evitare elaborazioni duplicate.
Risultato atteso: I nuovi tentativi non creano record CRM duplicati.
5
Elenca webhook
GET azione webhook-list per controllare gli endpoint configurati.
Risultato atteso: Puoi vedere URL, eventi, stato abilitato e stato di consegna recente.
6
Elimina i webhook obsoleti
POST azione webhook-delete con ID webhook.
Risultato atteso: I vecchi endpoint smettono di ricevere eventi.
Come testarlo: Registra un endpoint di test, attiva un evento di supporto live, verifica la firma e conferma che il tuo gestore restituisca 2xx.
Problema
Correggi
La firma non corrisponde
Utilizza il corpo non elaborato, non analizzato JSON, e conferma il segreto del webhook corretto.
Il webhook non riceve eventi
Conferma che l'elenco eventi includa l'evento che stai testando e che l'endpoint sia HTTPS.
Il webhook è scaduto
Riconoscere rapidamente ed elaborare lavori lunghi in modo asincrono.
Cosa fare dopo: Collega gli ingegneri a /api-docs per dettagli ed esempi sull'endpoint.
Utilizza correttamente il pubblico basato sulle azioni API
A cosa serve: Usalo quando scegli l'azione giusta per una funzionalità.
Prima di iniziare
Ogni richiesta utilizza la stessa funzione API pubblica URL.
Le azioni GET utilizzano parametri di query. Le azioni POST utilizzano il corpo JSON.
Invia x-api-key su tutte le richieste.
Come testarlo: Chiama usage e list-bots come prova del fumo dopo qualsiasi modifica della chiave API o dell'endpoint.
Problema
Correggi
Mancata corrispondenza del metodo
Utilizzare il metodo mostrato nella tabella degli endpoint. Alcune azioni sono solo GET o solo POST.
Valore richiesto mancante
Controlla botId, conversationId, l'ID webhook e l'ortografia dell'azione.
Cosa fare dopo: Utilizza Quick Start per le prime richieste, quindi /api-docs per il riferimento completo.
Metodo
Azione
Scopo
GET
list-bots
Elenca tutti i bot disponibili per il proprietario della chiave API.
GET
get-bot
Recupera una configurazione del bot in base all'ID bot.
POST
chat
Invia un messaggio visitatore a un bot e restituisci la risposta AI.
GET
conversations
Elenca conversations recente per un bot, fino a 100 record.
GET
usage
Piano di restituzione, crediti, conteggio bot, conversations e chiave API usage.
GET
live-support-list
Elenco conversations in attesa o gestito da un agente umano.
GET
live-support-messages
Recupera un thread di trasferimento con messaggi e informazioni sui visitatori.
POST
live-support-reply
Invia una risposta da parte di un agente umano da un sistema esterno.
POST
live-support-claim
Richiedi una conversazione di trasferimento in attesa.
POST
live-support-resolve
Risolvi il passaggio di consegne o restituisci il controllo all'IA.
POST
webhook-register
Registra un endpoint webhook HTTPS.
GET
webhook-list
Elenca le registrazioni dei webhook senza restituire segreti.
POST
webhook-delete
Elimina una registrazione webhook in base all'ID.
14
Guida per l'ingegnere: aggiunta di funzionalità
Aggiungi percorsi, navigazione nel dashboard, impostazioni del generatore di bot, tabelle/funzioni/migrazioni Supabase, documenti API, documentazione pubblica, controlli SEO e verifica locale.
Flusso di lavoro delle funzionalità dell'app
Aggiungi un percorso dell'app, una pagina, un elemento di navigazione e una voce di documenti
A cosa serve: Utilizzalo quando aggiungi una nuova funzionalità del dashboard rivolto al cliente.
Prima di iniziare
Crea un ramo prima della modifica.
Identificare se la funzionalità appartiene al repository dell'app o al repository frontend pubblico sem.chat.
Ispeziona il percorso esistente, la barra laterale, i18n e i modelli di impostazioni prima di aggiungere una nuova struttura.
1
Aggiungi il percorso
Aggiorna src/App.tsx con un percorso protetto per le pagine dei clienti o un percorso pubblico solo quando la pagina deve essere pubblica.
Risultato atteso: Il URL si risolve nell'app senza colpire NotFound.
2
Crea o aggiorna il componente della pagina
Utilizza modelli di pagina esistenti, caricamento dei dati, stati vuoti, stati di caricamento e autorizzazioni.
Risultato atteso: La funzionalità si comporta in modo coerente con la dashboard.
3
Aggiungi la navigazione nel dashboard
Aggiorna la barra laterale/fonte di navigazione con etichetta, icona, percorso e piani di accesso, se necessario.
Risultato atteso: Gli utenti possono scoprire la nuova pagina dalla shell dell'app.
4
Aggiungi la scheda o l'impostazione del generatore di bot
Se la funzionalità appartiene a un bot, aggiungila nelle schede Bot Builder e rendila persistente attraverso i flussi di salvataggio esistenti.
Risultato atteso: La configurazione specifica del bot viene salvata con il bot, non bloccata nello stato locale.
5
Aggiungi modifiche a schema/funzione Supabase
Crea migrazioni per tabelle/criteri e funzioni edge per il lavoro lato server.
Risultato atteso: Il comportamento del database e del server può essere distribuito ripetutamente.
6
Aggiorna la forma API se pubblica
Aggiungi o estendi la gestione delle azioni in supabase/functions/public-api/index.ts e documenta il comportamento x-api-key.
Risultato atteso: Le integrazioni possono utilizzare la funzionalità in modo sicuro.
7
Aggiorna i documenti dell'app e la documentazione pubblica
Aggiorna i documenti per sviluppatori in-app e questa pagina /documentazione con screenshot e passaggi clic per clic.
Risultato atteso: Utenti e ingegneri vedono la funzionalità in entrambi i posti.
8
Esegui controlli
Esegui test/creazione dell'app, ottimizzatore SEO nel sito pubblico, controlli della mappa del sito e verifica del browser.
Risultato atteso: La funzionalità funziona localmente e il sito pubblico rimane scansionabile.
Come testarlo: Apri il nuovo percorso, utilizza la funzionalità end-to-end, controlla gli errori della console/rete e verifica eventuali modifiche al database dall'interfaccia utente.
Problema
Correggi
Il percorso funziona ma il navigatore non lo evidenzia
Controlla la corrispondenza del percorso della barra laterale e i percorsi di reindirizzamento.
I dati funzionano localmente ma non vengono distribuiti
Conferma la migrazione, le policy RLS e le variabili di ambiente delle funzioni edge.
Documenti pubblici mancanti dalla mappa del sito
Esegui l'ottimizzatore SEO e controlla sitemap.xml per il canonico URL.
Cosa fare dopo: Cattura o rigenera gli screenshot della documentazione ogni volta che l'interfaccia utente cambia.
Flusso di lavoro di manutenzione dei documenti
Aggiorna questa pagina di documentazione pubblica dopo le modifiche al prodotto
A cosa serve: Utilizzalo quando cambiano screenshot, flussi di lavoro, comportamento di API o navigazione.
Prima di iniziare
Utilizzare solo dati dimostrativi sicuri.
Non esporre mai clienti reali, email, dettagli di pagamento, chiavi API o conversations private.
Aggiorna prima il manuale in inglese, quindi aggiorna ogni pagina di documentazione localizzata prima dei controlli SEO.
1
Controlla il percorso modificato
Apri il percorso dell'app e identifica cosa è cambiato visivamente e proceduralmente.
Risultato atteso: Sai quali righe della guida, dello screenshot e della risoluzione dei problemi necessitano di modifiche.
2
Cattura o genera uno screenshot sicuro
Utilizza un'area di lavoro demo e maschera i segreti prima di salvare le risorse WebP in risorse/documentazione.
Risultato atteso: Lo screenshot è accurato e sicuro da pubblicare.
3
Aggiorna la guida
Modificare le sezioni pertinenti A cosa serve, Prima di iniziare, Passaggi, Risultati previsti, Test, Risoluzione dei problemi e Successivo.
Risultato atteso: La guida indica agli utenti cosa fare clic e cosa dovrebbe accadere dopo ogni clic.
4
Aggiorna la navigazione se necessario
Aggiungi la sezione al sommario permanente, al selettore di sezioni mobile e all'indice visivo se si tratta di una pagina principale.
Risultato atteso: I lettori possono trovare rapidamente i nuovi contenuti.
5
Esegui gli strumenti SEO
Esegui node tools/seo-optimize-static-pages.js e node tools/seo-optimize-static-pages.js --check.
Risultato atteso: L'output canonico, dei metadati, della mappa del sito e dei robot rimane corretto.
6
Esegui controlli di pulizia e differenze
Esegui node tools/static-translation-cleanup.js --audit e git diff --check.
Risultato atteso: Le traduzioni statiche e gli spazi bianchi sono puliti.
7
Verifica del browser
Servire il sito localmente e testare/documentare su desktop e dispositivi mobili.
Risultato atteso: Le immagini vengono caricate, la ricerca funziona, i pulsanti di copia funzionano, l'evidenziazione del sommario e il layout non si sovrappongono al banner dei cookie.
Come testarlo: Cerca il nome della funzione modificata su /documentazione e verifica che venga visualizzato il blocco guida corretto.
Problema
Correggi
I marcatori delle schermate si spostano sui dispositivi mobili
Mantieni i marcatori all'interno dell'immagine dello screenshot o utilizza le coordinate dei marcatori reattivi.
La ricerca non trova la nuova guida
Aggiungi parole chiave utili a data-title e includi i termini esatti del prodotto cercati dagli utenti.
La documentazione localizzata diventa obsoleta
Dopo aver modificato il manuale in inglese, aggiorna ogni pagina di documentazione localizzata, esegui di nuovo l’ottimizzatore SEO e conferma che sitemap.xml includa ogni URL della documentazione.
Cosa fare dopo: Applica insieme le modifiche alla pagina dei documenti, alle risorse, ai collegamenti di intestazione/piè di pagina, al file .htaccess e alla mappa del sito.
Hai bisogno del riferimento API mirato?
La pagina /api-docs precedente rimane disponibile per i dettagli API a livello di endpoint.