Manuale visivo passo passo

sem.chat documentazione

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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
L'email di verifica non arrivaControlla lo spam, conferma l'ortografia dell'e-mail, quindi richiedi un'altra e-mail di verifica.
La dashboard si apre su FatturazioneL'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 lavoroInvitali 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.
ProblemaCorreggi
Il codice di incorporamento non è disponibileSalva 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 sbagliatoConferma che data-bot-id nello snippet corrisponda all'ID bot dalla modalità Incorpora.
Nessuna conversazione appare nella cronologiaAggiorna 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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
La risposta è troppo genericaAggiungi conoscenze più specifiche e riscrivi le istruzioni con esempi di buone risposte.
Il bot rifiuta le domande a cui dovrebbe rispondereRimuovi istruzioni eccessivamente rigide e aggiungi conoscenze attendibili per quell'argomento.
Il salvataggio non genera codice di incorporamentoControlla 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.
ProblemaCorreggi
La vecchia risposta appare ancoraAggiorna la pagina del sito Web, conferma di aver salvato il bot corretto e controlla se la conoscenza importata necessita di una sincronizzazione.
Il trasferimento fallisceConferma che l'e-mail del destinatario sia valida e che l'account di destinazione possa accettare il bot.
È stato fatto clic su Elimina per erroreSosta 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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
Manca il widgetConferma 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 sbagliatoCopia nuovamente lo snippet e confronta data-bot-id con il bot desiderato.
Il widget si sovrappone ai controlli della paginaModifica 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.

HTML incorpora
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
Installazione della piattaforma

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.
ProblemaCorreggi
React carica i widget duplicatiProteggi l'inserimento dello script con un riferimento o esegui il rendering del componente solo nel layout principale.
WordPress rimuove i tag dello scriptUtilizza un plugin per l'inserimento del footer o un file del tema che consenta gli script.
Impossibile avviare la chiamata SDKControlla 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.

WordPress frammento di piè di pagina
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
React componente
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
Voce avanzata SDK
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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
Il colore non è stato aggiornatoSalva il bot, aggiorna il sito Web e conferma che il widget installato utilizza lo stesso ID bot.
Mancano i campi leadConfermare che l'acquisizione dell'elettrocatetere sia abilitata e che la condizione di attivazione selezionata sia soddisfatta.
I visitatori non possono usare la voceControlla 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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
Il browser blocca il microfonoConsenti l'autorizzazione del microfono nel browser e ricarica la pagina.
L'opzione vocale è bloccataApri Fatturazione e conferma che il piano dell'area di lavoro include funzionalità vocali.
La trascrizione è vuotaConferma 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.
ProblemaCorreggi
La qualità del clone è scarsaRegistra campioni più puliti con un altoparlante, volume stabile e senza musica.
Il caricamento dell'avatar personalizzato non è disponibileControlla la fatturazione per i limiti di avatar vincolati dal piano.
La vecchia voce suona ancoraSalva 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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
Il crawler importa pagine non pertinentiRimuovi quelle pagine dai risultati selezionati e aggiungi istruzioni manuali più chiare.
I prezzi dei prodotti sono stantiiAggiorna il feed e conferma che il feed URL stesso contiene i valori correnti.
Bot inventa risposteAggiungi 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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
L'invio della risposta non è riuscitoControlla lo stato della rete, lo stato della conversazione e se è stato richiesto il supporto live.
La lingua dei visitatori è sbagliataUtilizza la traduzione o aggiorna le impostazioni della lingua del bot prima di rispondere.
La conversazione non è nella Posta in arrivoCerca 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.
ProblemaCorreggi
Gli agenti non rispondono alle richiesteAbilita browser/e-mail/notifiche push e aggiungi un processo per la proprietà della coda.
L’intelligenza artificiale continua a prendere il sopravvento troppo prestoModifica le istruzioni e le regole di trasferimento in modo che il controllo umano rimanga attivo finché non viene risolto o restituito.
CRM esterno non è sincronizzatoUtilizza 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.
ProblemaCorreggi
Contatto mancante dai ContattiConferma che l'acquisizione dei lead sia abilitata e che il visitatore abbia inviato il modulo.
L'esportazione è troppo grandeRestringi l'intervallo di date o il filtro bot prima dell'esportazione.
SendPulse sincronizzazione non disponibileConnetti 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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
Il token Telegram non riesceCrea o reimposta il token in BotFather e incollalo di nuovo.
I messaggi Slack non arrivanoControlla 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 riesceConferma che l'account Facebook/Instagram/WhatsApp disponga delle autorizzazioni di amministratore e dell'accesso aziendale richiesto.
La sincronizzazione di SendPulse non riesceRiconnetti 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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
Nessun orario appare sulla pagina pubblicaControlla 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 prenotazioneControlla le impostazioni e-mail e la cartella spam, quindi invia un'altra prenotazione di prova.
Il pagamento non riesce in un evento a pagamentoVerifica 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.
ProblemaCorreggi
Il collegamento una tantum espone gli slot erratiRigenera il collegamento con un set di slot più piccolo o un intervallo di date più rigoroso.
La prenotazione incorporata è troppo ristrettaPosiziona l'incorporamento in un contenitore di contenuti più ampio e controlla il layout mobile.
Le analisi sembrano vuoteCreare 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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
I parametri sembrano troppo altiControlla se la gestione temporanea/test conversations è inclusa nell'intervallo di date selezionato.
La soddisfazione è vuotaAbilita le valutazioni nelle Impostazioni widget e attendi che i visitatori lascino valutazioni.
I minuti vocali non corrispondono alle aspettativeConferma 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.
ProblemaCorreggi
L'email di segnalazione non arrivaControlla l'ortografia del destinatario, la cartella spam e segnala lo stato della cronologia.
Le persone sbagliate ricevono segnalazioniAggiorna i destinatari e salva prima del prossimo invio pianificato.
Il contenuto del report sembra rumorosoModifica 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.

11

Fatturazione, Team, Sicurezza, Impostazioni, Affiliazione

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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
La funzionalità rimane bloccata dopo l'aggiornamentoAggiorna l'app, attendi qualche istante per la sincronizzazione dell'abbonamento, quindi controlla nuovamente Fatturazione.
Il pagamento è stato annullatoTorna a Fatturazione e avvia nuovamente il pagamento; non si verificano modifiche al piano dopo un checkout annullato.
Necessita di cambio fattura o cartaApri 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.
ProblemaCorreggi
E-mail di invito mancanteControlla lo spam, invia nuovamente l'invito e verifica l'indirizzo.
Il compagno di squadra vede troppoRiduci il loro ruolo e rivedi le impostazioni di accesso ai bot.
La configurazione 2FA non riesceControlla 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.
ProblemaCorreggi
Manca il collegamento di riferimentoPartecipa prima al programma o aggiorna la pagina di affiliazione dopo l'adesione.
Richiesta di pagamento non disponibileControlla la soglia minima di pagamento, lo stato della commissione idonea e l'e-mail di pagamento.
Referral non attribuitoConferma 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
Screenshot reale dell’area di lavoro demo di sem.chat
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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
Non arriva alcuna notificaControlla le preferenze di notifica delle Impostazioni, l'autorizzazione del browser e se l'evento è effettivamente accaduto.
Troppi avvisiDisabilita le categorie rumorose o inviale solo ai membri del team responsabili.
Il conteggio dei documenti non letti sembra bloccatoAggiorna 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.
ProblemaCorreggi
L'aggiornamento menziona una funzionalità bloccataApri Fatturazione per confermare se il piano attuale la include.
La squadra ha mancato un cambioAggiungi la revisione App Updates al rilascio o alle routine operative settimanali.
La documentazione sembra obsoleta dopo un aggiornamentoUtilizza 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
Screenshot reale dell’area di lavoro demo di sem.chat
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.
ProblemaCorreggi
401 o risposta non autorizzataControlla l'ortografia di x-api-key, copia la chiave completa e conferma che non è stata revocata.
Bot non trovatoUtilizza nuovamente list-bots e conferma che il bot appartiene al proprietario della chiave API.
Problema CORS del browserSposta 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.
ProblemaCorreggi
Biglietti CRM duplicatiUtilizza conversationId come chiave di idempotenza nel tuo bridge CRM.
Le risposte arrivano fuori ordineMemorizza i timestamp dei messaggi ed evita risposte simultanee da più sistemi.
L'intelligenza artificiale risponde mentre l'agente sta lavorandoRichiedi 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.
ProblemaCorreggi
La firma non corrispondeUtilizza il corpo non elaborato, non analizzato JSON, e conferma il segreto del webhook corretto.
Il webhook non riceve eventiConferma che l'elenco eventi includa l'evento che stai testando e che l'endpoint sia HTTPS.
Il webhook è scadutoRiconoscere rapidamente ed elaborare lavori lunghi in modo asincrono.

Cosa fare dopo: Collega gli ingegneri a /api-docs per dettagli ed esempi sull'endpoint.

Registra il webhook
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": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
Verifica la firma del webhook
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
Mappa degli 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.
ProblemaCorreggi
Mancata corrispondenza del metodoUtilizzare il metodo mostrato nella tabella degli endpoint. Alcune azioni sono solo GET o solo POST.
Valore richiesto mancanteControlla 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.

MetodoAzioneScopo
GETlist-botsElenca tutti i bot disponibili per il proprietario della chiave API.
GETget-botRecupera una configurazione del bot in base all'ID bot.
POSTchatInvia un messaggio visitatore a un bot e restituisci la risposta AI.
GETconversationsElenca conversations recente per un bot, fino a 100 record.
GETusagePiano di restituzione, crediti, conteggio bot, conversations e chiave API usage.
GETlive-support-listElenco conversations in attesa o gestito da un agente umano.
GETlive-support-messagesRecupera un thread di trasferimento con messaggi e informazioni sui visitatori.
POSTlive-support-replyInvia una risposta da parte di un agente umano da un sistema esterno.
POSTlive-support-claimRichiedi una conversazione di trasferimento in attesa.
POSTlive-support-resolveRisolvi il passaggio di consegne o restituisci il controllo all'IA.
POSTwebhook-registerRegistra un endpoint webhook HTTPS.
GETwebhook-listElenca le registrazioni dei webhook senza restituire segreti.
POSTwebhook-deleteElimina 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.
ProblemaCorreggi
Il percorso funziona ma il navigatore non lo evidenziaControlla la corrispondenza del percorso della barra laterale e i percorsi di reindirizzamento.
I dati funzionano localmente ma non vengono distribuitiConferma la migrazione, le policy RLS e le variabili di ambiente delle funzioni edge.
Documenti pubblici mancanti dalla mappa del sitoEsegui 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.
ProblemaCorreggi
I marcatori delle schermate si spostano sui dispositivi mobiliMantieni i marcatori all'interno dell'immagine dello screenshot o utilizza le coordinate dei marcatori reattivi.
La ricerca non trova la nuova guidaAggiungi parole chiave utili a data-title e includi i termini esatti del prodotto cercati dagli utenti.
La documentazione localizzata diventa obsoletaDopo 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.

Apri API Documenti