Configurare MagicAI Chat

In questo articolo imparerai a creare una configurazione di chat nel Backoffice, a scorrere le sezioni della finestra di dialogo di configurazione, a salvarla come bozza o a pubblicarla direttamente e a distribuirla nei tuoi studi.

Contenuti

• Prerequisiti
• Panoramica delle configurazioni
• Creare una nuova configurazione
• Salvare la configurazione
• Vista dettaglio e stato
• Configurazione del self-service per i clienti
• Fast Finance Link
• Attivare e autorizzare (whitelist)
• Incorporare il widget di chat
• Dati di terzi e licenze
• Dove i membri trovano la chat

Prerequisiti

• Autorizzazione: Configurare le impostazioni della chat MagicAI, disponibile in Impostazioni / Diritti nella sottocategoria Intelligenza artificiale . Un'autorizzazione separata, Conversazioni in chat MagicAI, controlla la visibilità della casella di posta lato agente e si trova nella sottocategoria Comunicazione .
• Licenza: MagicAI Chat non fa parte dei normali piani tariffari; viene fornito con un proprio modello di licenza. Contatta il tuo account manager di Sport Alliance per abilitarlo per uno studio.
• Immagini avatar: un avatar principale del chatbot per il widget di chat aperto e un avatar di invito all'azione per il pulsante di chat flottante, ciascuno fino a 3 MB.
• Almeno una fonte di conoscenza: file (max. 10 MB), URL o Zendesk Help Center.
• Per un passaggio di consegne umano tramite Zendesk: sottodominio Zendesk, nome utente dell'agente e token API.
• Per le offerte di abbonamento: un canale di offerte mantenuto (Sales tool, Studio pages and Connect API, MySports o Open API).
• Studio di fatturazione predefinito valido: lo studio di fatturazione predefinito della configurazione deve essere uno studio in cui il chatbot è disponibile contrattualmente e che fa parte degli studi autorizzati della configurazione. Se una di queste condizioni non è soddisfatta, la configurazione non può essere salvata.

Panoramica delle configurazioni

Apri il punto di accesso della configurazione in Impostazioni / MagicAI / Chat. La barra laterale mostra la nuova sezione MagicAI con una voce Chat e riporta un badge Nuovo al lancio.

La pagina di panoramica elenca tutte le configurazioni di chat della tua sede.

Colonne dell'elenco:

• Nome: l'identificatore interno, visibile solo agli utenti del Backoffice. Un chip Bozza compare accanto al nome mentre la configurazione è ancora in fase di creazione.
• Nome del marchio: il nome del marchio del tuo studio. Di per sé non visibile agli abbonati, ma utile per distinguere le configurazioni tra i marchi.
• Nome del chatbot: il nome pubblico che gli abbonati vedono nel widget di chat.
• Ultimo aggiornamento: la marca temporale dell'ultima modifica alla configurazione.
• Pubblicato per: un badge con il numero di studi in cui la configurazione è attualmente attiva. Un chip Attivo compare qui una volta che la configurazione è attivata in almeno uno studio.
• Sedi: un badge con il numero di studi per cui la configurazione è autorizzata; passa il mouse o fai clic per vedere l'elenco degli studi.

Dall'elenco puoi filtrare per stato, cercare per nome o nome del marchio, ordinare e mostrare o nascondere le colonne. Usa il selettore di sede in alto a destra per vedere le configurazioni di altre sedi. Avvia la finestra di dialogo di configurazione con Crea configurazione di chat in alto a destra.

L'attivazione e la disattivazione avvengono sempre da questa pagina di panoramica. La vista dettaglio gestisce solo i contenuti e l'autorizzazione (whitelist). Consulta Attivare e autorizzare (whitelist) per tutte le regole di attivazione.

Creare una nuova configurazione

Crea configurazione di chat apre un'unica finestra di dialogo che ti guida attraverso cinque sezioni, ognuna delle quali termina con un pulsante Continua . L'intestazione della finestra di dialogo offre un'azione Salva bozza che puoi usare in qualsiasi momento per conservare il lavoro in corso. Non vengono visualizzati numeri di passaggio; il titolo della sezione e l'avanzamento nella finestra di dialogo indicano a che punto sei.

Informazioni di base

La prima sezione raccoglie i dati di base della configurazione.

Nomi

• Nome: nome interno della configurazione (max. 30 caratteri). Visibile solo agli utenti del Backoffice.
• Nome del marchio: il tuo nome del marchio (max. 30 caratteri). Mostrato nella panoramica del Backoffice.
• Nome del chatbot: il nome che gli abbonati vedono nel widget di chat (max. 30 caratteri).

Messaggio di benvenuto

• Messaggio di benvenuto: il saluto mostrato quando un abbonato apre la chat (max. 400 caratteri).

Nota: Gli abbonati devono poter riconoscere chiaramente che stanno interagendo con un sistema di IA (ai sensi del Regolamento UE sull’IA, articolo 50). Formula il messaggio di benvenuto di conseguenza. Esempio: «Ciao! Sono il tuo assistente digitale IA. Sarò felice di aiutarti con domande sul tuo abbonamento, sui nostri corsi o con informazioni generali sullo studio. Come posso aiutarti oggi?»

Studio di fatturazione

• Studio di fatturazione predefinito: lo studio di riserva utilizzato per le conversazioni di chat che non possono ancora essere assegnate a uno studio specifico (per esempio un potenziale cliente non autenticato). Lo studio deve essere nell'elenco autorizzato della configurazione ed essere uno studio in cui il chatbot è disponibile contrattualmente; altrimenti la configurazione non può essere salvata.

Consenso legale

Se compili entrambi i campi, l'anteprima mostra una finestra di consenso con le azioni Rifiuta e Accetta che gli abbonati vedono prima del loro primo messaggio. Entrambi i campi sono facoltativi: se li lasci vuoti, non viene mostrata alcuna finestra di consenso.

• Titolo di consenso legale: titolo della finestra di consenso (max. 30 caratteri).
• Descrizione del consenso legale: il testo del corpo che spiega a cosa acconsente l'abbonato, con opzioni di testo formattato (grassetto, corsivo, sottolineato, colore del testo, link).

Testo di consenso suggerito

Il testo seguente è una bozza di lavoro per la finestra di consenso. Adatta i link segnaposto alla tua informativa sulla privacy e alle tue condizioni d'uso prima della pubblicazione.

• Titolo: Avviso sul trattamento dei dati
• Descrizione: Il tuo inserimento, compresi i dati personali, viene elaborato automaticamente per rispondere alla tua richiesta. Puoi revocare questo consenso in qualsiasi momento con effetto per il futuro. Non inserire dati sanitari o altre informazioni sensibili. Trovi maggiori informazioni sul trattamento dei dati e sui tuoi diritti nella nostra [informativa sulla privacy] e nelle nostre [condizioni d'uso].

Stile

Personalizza l'aspetto visivo del widget di chat in modo che corrisponda al tuo marchio. Configuri tre colori di base più una forma della bolla; tutti gli altri colori dell'interfaccia (testo, bordi, stati di errore) vengono derivati automaticamente.

Colori e look

• Primario: colore d'accento principale come valore esadecimale, usato per gli elementi principali dell'interfaccia come pulsanti ed evidenziazioni, per es. #166cb8.
• Sfondo della chat: colore della superficie del widget di chat come valore esadecimale, per es. #6d2929.
• Colore sfumato dell'intestazione: secondo colore facoltativo usato per la sfumatura dell'intestazione. Se vuoto, l'intestazione usa il colore primario. Valore esadecimale.
• Utilizzare una forma arrotondata per le bolle di chat: interruttore sì/no.

Avatar

Sono supportati due slot per avatar. È consentita una sola immagine per slot.

• Avatar chatbot aperto: il logo principale mostrato nell'intestazione del widget di chat (max. 3 MB).
• Avatar chatbot chiuso: il logo o l'icona mostrato sul pulsante di chat flottante che apre il widget (max. 3 MB).

Funzionalità

Attiva le funzionalità che il bot deve gestire. Ogni funzionalità sblocca una funzione specifica per gli utenti finali. Dopo il salvataggio puoi perfezionare ogni flusso di lavoro sulla sua scheda nella vista dettaglio.

Configurare il Passaggio di consegne umano

Se attivi Passaggio di consegne umano, scegli il Tipo. di trasferimento. È consentita una sola configurazione di Passaggio di consegne umano per chatbot.

Tipo Email

• Email: indirizzo di destinazione per le conversazioni trasferite. Deve essere un indirizzo e-mail valido.

Tipo Zendesk

• URL: URL della tua istanza Zendesk.
• Nome utente: il nome utente dell'agente usato per creare i ticket.
• Token: token API per l'autenticazione.

Configurare le offerte di abbonamento

Se attivi Offerte di abbonamento, devi anche selezionare il Tipo di gruppo di fasce tariffarie da cui vengono estratte le offerte. Senza una selezione, la configurazione non può essere salvata. Le quattro opzioni corrispondono ai valori di RateBundleGroupTypeEnum:

• Sales tool: offerte del gruppo di fasce tariffarie Sales tool.
• Studio pages and Connect API: offerte del gruppo di fasce tariffarie Studio pages and Connect API.
• MySports: offerte del gruppo di fasce tariffarie MySports.
• Open API: offerte del gruppo di fasce tariffarie Open API.

La tua selezione determina da dove il bot estrae le offerte e dove avviene la registrazione.

Fonti di conoscenza

È richiesta almeno una fonte di conoscenza. Usa + Aggiungere una fonte di conoscenza per aggiungerne altre. Per ogni fonte scegli il Tipo di fonte: File, URL o Zendesk.

Aggiungere una fonte è solo metà del lavoro. Il modo in cui struttura i contenuti all'interno delle tue fonti influisce direttamente sulla qualità delle risposte, e alcuni argomenti dovrebbero essere omessi del tutto perché il software li fornisce già. Per sapere cosa includere, cosa tralasciare e come formattare i tuoi contenuti, consulta Costruire la base di conoscenza per MagicAI Chat.

Tipo File

Carica direttamente un file di testo o PDF (max. 10 MB per file). Per più file, crea più fonti.

Tipo URL

Inserisci l'URL di partenza di una pagina web. Il sistema esegue la scansione fino a 5 livelli di profondità e segue un massimo di 50 link a partire dall'URL di partenza. Entrambi i limiti sono fissi e non modificabili.

Tipo Zendesk

Inserisci l'URL di base del tuo Zendesk Help Center, per esempio https://yourstudio.zendesk.com. Gli articoli vengono recuperati in tutte le lingue disponibili nel tuo Zendesk Help Center, secondo la configurazione per tenant.

Aggiornare le fonti di informazione

Quando salvi una nuova fonte di informazione, viene pubblicata e indicizzata automaticamente in modo che il bot possa usarla.

Se il contenuto dietro una fonte di informazione esistente cambia (per esempio il tuo sito web è stato aggiornato o hai caricato un nuovo file), attiva un aggiornamento immediato con il pulsante Aggiornare le fonti di conoscenza in fondo alla scheda delle fonti di informazione nella pagina di dettaglio. Questo reindicizza tutte le fonti immediatamente, in modo che le modifiche compaiano subito nelle risposte del bot. Se non esegui un aggiornamento manuale, tutte le fonti di informazione vengono reindicizzate automaticamente ogni notte.

Contenuto e formato consigliati

La capacità del chatbot di rispondere bene dipende molto più dalla struttura e dal linguaggio delle tue fonti che dal tipo di fonte. Segui queste raccomandazioni quando prepari i contenuti.

• Formati preferiti: Markdown o testo semplice. Entrambi sono chiaramente strutturati e si suddividono in blocchi in modo pulito. I PDF funzionano finché il testo è estraibile; evita i PDF scansionati, i file di sole immagini e i fogli Excel.
• Usa una struttura a FAQ: il titolo è la domanda, il corpo è una risposta autonoma. Ogni sezione deve avere senso di per sé; una certa ripetizione tra le sezioni va bene se mantiene ogni blocco autosufficiente.
• Terminologia coerente: usa le stesse parole per lo stesso concetto ovunque. Evita il linguaggio di marketing, le affermazioni contraddittorie tra le fonti e i contenuti obsoleti.

Salvare la configurazione

La finestra di dialogo offre due modi per uscire dal flusso di creazione:

• Salva bozza (azione nell'intestazione della finestra di dialogo): conserva la configurazione in stato Bozza . In questa modalità i campi obbligatori possono essere vuoti. Usalo per conservare configurazioni in corso senza renderle attivabili.
• Continua (il pulsante principale in fondo a ogni sezione): fa avanzare attraverso le sezioni. Nell'ultima sezione diventa l'azione di invio e salva la configurazione in stato Pubblicato . I campi obbligatori devono essere completi; altrimenti la finestra di dialogo blocca l'invio. Pubblicato significa solo che la configurazione è memorizzata e completa; non rende ancora la chat attiva per gli abbonati. L'attivazione negli studi è un passaggio separato (vedi Attivare e autorizzare (whitelist)).

In entrambi i casi arrivi alla pagina di dettaglio, dove ogni sezione appare come una scheda e può essere modificata individualmente.

Vista dettaglio e stato

La pagina di dettaglio ha due schede:

• Impostazioni: schede per Informazioni di base, Consenso legale, Stile (con le sotto-schede Colori e look e Avatar), Funzionalità, Fonti di conoscenza e Frammento di codice.
• Self-service: schede per Dati personali degli abbonati e Dati del contratto. Consulta Configurazione del self-service per i clienti.

La pagina di dettaglio mostra lo stato attuale in due punti.

Chip di stato accanto al titolo della configurazione:

• Bozza: la configurazione è ancora in fase di creazione e non può essere attivata.
• Attivo: pubblicata e attivata in almeno uno studio.
• Inattivo: pubblicata ma attualmente non attivata da nessuna parte.

Banner di avviso in cima alla pagina:

• Le bozze mostrano: Questa configurazione non è ancora completa ed è attualmente in stato di "Bozza". Per attivarla, è necessario compilare tutti i campi obbligatori.
• Le configurazioni pubblicate mostrano un banner di conferma (gravità informativa).

L'azione Modifica delle impostazioni nell'intestazione della pagina di dettaglio è disponibile solo quando la configurazione è in stato Pubblicato .

Configurazione del self-service per i clienti

Quando attivi Self-service per i clienti nella sezione Funzionalità, la scheda Self-service della pagina di dettaglio diventa il luogo in cui controllare quali aree dell'account gli abbonati possono leggere e modificare tramite la chat. La scheda contiene due schede.

Dati personali degli abbonati

• Dati anagrafici: se gli abbonati possono visualizzare o modificare i loro dati anagrafici.
• Indirizzo: accesso alle informazioni sull'indirizzo.
• Dati contatto: accesso a telefono, e-mail e dati di contatto simili.

Dati del contratto

• Dati del contratto: quali contratti sono visibili (Tutti i contratti o Contratti attivi).
• Risoluzione del contratto principale: se gli abbonati possono risolvere il loro contratto principale tramite la chat.
• Suggerire una sospensione prima della cancellazione: se la chat suggerisce in modo proattivo una sospensione quando un abbonato tenta di disdire.
• Sospensioni: se gli abbonati possono richiedere una sospensione.

Ogni campo modificabile mostra il suo stato attuale (per esempio, Attivato) e un link Controllare le modifiche che apre le impostazioni di verifica del campo.

Fast Finance Link

Se attivi Fast Finance Link nella sezione Funzionalità, il chatbot può inviare a un abbonato autenticato un Fast Finance Link via e-mail, dopo aver verificato il suo stato di pagamento, in modo che possa saldare richieste aperte o aggiornare il proprio metodo di pagamento. L'invio utilizza lo stesso percorso dell'invio manuale dall'account membro, incluso il modello di comunicazione lì configurato.

• Prerequisito: nelle impostazioni del Fast-Finance Link dello studio deve essere configurato un modello di comunicazione per l'invio manuale. Senza modello, il chatbot non può inviare l'e-mail. Maggiori dettagli nell'articolo Configurare il Fast-Finance Link.
• Il link non compare mai nella conversazione della chat. Dopo l'invio, il chatbot mostra all'abbonato solo una conferma mascherata dell'indirizzo destinatario (ad esempio d***n@example.com).
• Quali elementi (pagamento, metodo di pagamento) include l'e-mail dipende dalla configurazione del Fast-Finance Link dello studio; il chatbot non effettua una propria selezione.
• Il chatbot non promette mai che una restrizione di accesso venga rimossa immediatamente dopo il pagamento. Informa l'abbonato che la restrizione può risolversi di conseguenza e consiglia di contattare lo studio se il problema persiste.

Attivare e autorizzare (whitelist)

Due concetti distinti controllano dove una configurazione è disponibile e dove è attivata:

• Autorizzazione (whitelist): gli studi che hanno accesso a una configurazione. Impostato nella vista dettaglio della configurazione.
• Attivazione: gli studi in cui questa configurazione è quella attiva. Impostato dalla panoramica delle configurazioni. La chat diventa visibile agli abbonati solo quando il codice di incorporamento è presente anche sul sito web dello studio (vedi Incorporare il widget di chat).

Questo vale per il sito web dello studio. Nella Member Platform e in Branded Web non serve alcun codice di incorporamento. Dove i membri trovano la chat.

Per attivare una configurazione:

1. Apri la panoramica in Impostazioni / MagicAI / Chat.
2. Seleziona la configurazione che vuoi attivare.
3. Scegli gli studi in cui deve essere eseguita.

Regole importanti:

• Può essere attiva una sola configurazione per studio. Attivare una configurazione in uno studio disattiva automaticamente qualsiasi configurazione che era attiva lì in precedenza.
• Se attivi una configurazione in uno studio non ancora autorizzato, lo studio viene aggiunto automaticamente all'elenco autorizzato.
• Non puoi attivare una configurazione ancora in stato di bozza. Salvala prima come configurazione completa e pubblicata; altrimenti l'attivazione fallisce con Impossibile attivare una bozza di configurazione.
• Non puoi eliminare una configurazione mentre è attiva in qualche studio. Disattivala prima ovunque.

Incorporare il widget di chat

La pagina di dettaglio contiene una scheda Frammento di codice con il codice di incorporamento per il sito web del tuo studio. Copia il frammento e incollalo nel codice sorgente del tuo sito web per mostrare il widget di chat. Lo snippet serve solo per il sito web dello studio. Nella Member Platform e in Branded Web la chat compare senza di esso.

La scheda si comporta in modo diverso a seconda dello stato della configurazione:

• Bozza: la scheda mostra il messaggio La configurazione attuale è in modalità bozza. Per ottenere uno snippet di codice, completare la configurazione del chatbot. L'azione di copia è disattivata.
• Pubblicato: il frammento viene mostrato insieme a un'azione Copia che colloca il codice negli appunti.

Dove i membri trovano la chat

I membri raggiungono la chat in tre punti. Sul sito web dello studio compare appena hai inserito il codice di incorporamento. Nella Member Platform e in Branded Web compare da sola, come pulsante di chat flottante, senza ulteriore configurazione.

Un membro vede la chat nella Member Platform e in Branded Web quando il proprio studio ha una configurazione pubblicata e attivata. Conta lo studio del membro, non lo studio che sta visitando. In un gruppo con più studi decidi quindi studio per studio se i suoi membri ricevono la chat.

Due conseguenze da conoscere:

• Una configurazione ancora in stato di bozza non raggiunge i membri da nessuna parte, né sul sito web né nella Member Platform.
• Se disattivi una configurazione in uno studio, la chat scompare per i membri di quello studio anche nella Member Platform e in Branded Web, non solo sul sito web.

Dati di terzi e licenze

Per i dati di localizzazione degli studi utilizziamo dati geografici di GeoNames.org, con licenza CC BY 4.0. La licenza ci obbliga a divulgare l'uso in modo trasparente; lascia questo avviso al suo posto quando riutilizzi l'articolo.

Avviso: Questo articolo è stato tradotto con l'aiuto dell'intelligenza artificiale. Ci scusiamo per eventuali errori.