Passa al contenuto principale

Widget di chat web

Il canale Web Chat aggiunge una finestra di chat al suo sito web. I visitatori fanno clic sul pulsante della chat in un angolo della pagina e le scrivono. Le loro conversazioni arrivano nella posta in arrivo di MonoChat come quelle di qualsiasi altro canale, dove il suo team, i suoi flussi e i suoi agenti AI rispondono.

Collegare il canale​

  1. Vada in Impostazioni › Chat › Canali e faccia clic su Collega.
  2. Selezioni Web Chat.
  3. Compili le impostazioni qui sotto e salvi. Ogni campo spiega a cosa serve, e la parte destra del modulo mostra un'anteprima della finestra che si aggiorna man mano che modifica le impostazioni. Nell'anteprima può passare tra il pulsante della chat chiuso, la finestra aperta e una conversazione di esempio.
  4. Copi lo snippet mostrato dal canale e lo aggiunga al suo sito (veda Installare lo snippet).

Può collegare più canali Web Chat, per esempio uno per sito web.

Impostazioni​

ImpostazioneCosa fa
Nome del canaleIl nome del canale in MonoChat. La finestra lo mostra come intestazione quando il Titolo del widget è vuoto.
Titolo del widgetL'intestazione della finestra di chat.
SottotitoloUna riga sotto il titolo, ad esempio in quanto tempo risponde di solito. Svuoti il campo per nascondere la riga.
LogoUn'immagine mostrata accanto al titolo: un file PNG, JPEG, GIF, SVG o WebP.
ColoreIl colore del pulsante della chat, dell'intestazione e dei messaggi del visitatore. Il testo sopra diventa nero o bianco per restare leggibile.
PosizioneIn basso a destra o in basso a sinistra nella pagina.
AllegatiConsente ai visitatori di inviare immagini, video, audio e documenti fino a 10 MB.
Pulsante delle emojiMostra accanto alla casella del messaggio un pulsante con le emoji più comuni. Attivo per impostazione predefinita.
Nascondi il pulsanteNasconde il pulsante della chat; la finestra si apre allora da un suo pulsante con l'API JavaScript.
Visualizzazione mobileCome si apre la finestra sugli smartphone: Schermo intero oppure Compatta, un pannello sui tre quarti inferiori della pagina.
Domini consentitiI siti su cui la finestra può comparire: un host esatto (www.example.com) o tutti i sottodomini (*.example.com), con una porta facoltativa (localhost:3000). Se lasciato vuoto, qualsiasi sito può mostrarla.

Lingue​

I pulsanti e le etichette della finestra seguono la lingua del browser del visitatore e sono in inglese quando MonoChat non dispone di quella lingua.

Il Titolo del widget, il Sottotitolo, l'Introduzione del modulo e il Testo del consenso hanno una versione per ogni lingua del suo workspace; le lingue si impostano in Impostazioni › CRM › Lingue (veda Impostazioni della lingua). Faccia clic sul campo per scrivere ogni versione. La finestra mostra la versione nella lingua del browser del visitatore oppure, se per quella lingua non ce n'è una, quella nella sua lingua predefinita.

Per mostrare la finestra in una sola lingua qualunque sia il browser, chiami MonoChat('setLocale', 'tr-TR') dall'API JavaScript.

Modulo pre-chat​

Con il modulo disattivato, i visitatori iniziano subito a scrivere. Per chiedere loro un indirizzo email o un numero di telefono, usi un flusso (veda I flussi e il widget).

Con il modulo attivato, la finestra chiede questi dati prima del primo messaggio:

CampoOpzioni
NomeDisattivato, facoltativo o obbligatorio
EmailDisattivato, facoltativo o obbligatorio
TelefonoDisattivato, facoltativo o obbligatorio

Può anche scrivere il testo mostrato sopra i campi e aggiungere una casella di consenso con un testo suo e un link alla sua informativa sulla privacy. Quando la casella è attiva, i visitatori devono spuntarla per avviare la chat. Nome, indirizzo email e numero di telefono vengono salvati nel profilo del cliente.

Installare lo snippet​

Il canale mostra uno snippet con l'indirizzo del widget e la chiave del canale già compilati, subito dopo il collegamento e sotto l'anteprima quando modifica il canale. Lo incolli prima del tag di chiusura </body> di ogni pagina che deve mostrare la chat:

<script>
window.MonoChat = window.MonoChat || function () { (MonoChat.q = MonoChat.q || []).push(arguments) }
</script>
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>"></script>

La finestra si carica dopo la sua pagina, quindi non la rallenta.

Passare dal vecchio WebChat

Se il suo sito contiene ancora lo snippet di un vecchio canale WebChat, lo rimuova e incolli al suo posto lo snippet del nuovo canale Web Chat.

Modalità a pagina intera​

Per dare alla chat una pagina tutta sua, come una pagina di assistenza, aggiunga &mode=fullpage al secondo tag dello snippet:

<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>&mode=fullpage"></script>

La finestra occupa allora l'intera pagina e resta aperta, senza intestazione né pulsante della chat, e close e toggle non hanno effetto. Si carica insieme alla pagina invece che dopo, e l'impostazione Visualizzazione mobile non si applica.

Google Tag Manager​

  1. Nel suo contenitore, aggiunga un tag Custom HTML e vi incolli lo snippet così com'è.
  2. Scelga l'attivatore All Pages, oppure uno che si attivi solo sulle pagine che devono mostrare la chat.
  3. Faccia clic su Submit e poi su Publish.

Se gli script della sua pagina chiamano MonoChat, possono essere eseguiti prima del tag. Lasci anche nella pagina il primo <script> dello snippet, così le loro chiamate attendono la finestra.

Website builder e negozi online​

Se non può modificare il codice del sito, incolli lo snippet così com'è nel campo che la sua piattaforma offre per il codice su ogni pagina, in fondo alla pagina o nel footer:

PiattaformaDove va lo snippet
WordPressInstalli il plugin WPCode e incolli lo snippet nel suo campo Footer. Su WordPress.com, la possibilità di aggiungere codice dipende dal suo piano.
ShopifyOnline Store › Edit code: apra theme.liquid e incolli lo snippet subito prima di </body>.
WixSettings › Custom Code › Add Custom Code: scelga tutte le pagine e Body – end. Il sito deve essere pubblicato e avere un dominio collegato.
SquarespaceIl campo Footer di Code Injection, nei piani Core, Plus e Advanced.
WebflowSite settings › Custom code › Footer code, poi pubblichi il sito.
ikasSales Channel › Extensions › Scripts › Add Script: incolli lo snippet come contenuto dello script, salvi e verifichi che lo script sia attivo.

API JavaScript​

Lo snippet definisce una funzione MonoChat nella sua pagina. La chiami dai suoi script, link e pulsanti per controllare la finestra. Le chiamate fatte prima che la finestra sia caricata attendono finché non è pronta, quindi può farle subito dopo lo snippet.

Comandi​

ChiamataCosa fa
MonoChat('open')Apre la finestra.
MonoChat('close')Chiude la finestra.
MonoChat('toggle')Apre la finestra se è chiusa e la chiude se è aperta.
MonoChat('hideLauncher')Nasconde il pulsante della chat. La finestra si apre comunque con open e toggle.
MonoChat('showLauncher')Mostra di nuovo il pulsante della chat.
MonoChat('setUser', { name, email, phone })Trasmette ciò che sa già del visitatore. Vedi Visitatori autenticati.
MonoChat('setLocale', 'tr-TR')Mostra la finestra in questa lingua, qualunque sia la lingua del browser. Vedi Lingue.
MonoChat('on', event, callback)Chiama callback ogni volta che si verifica event. Vedi Eventi.

Eventi​

EventoQuandocallback riceve
readyLa finestra è stata caricata.Niente
openLa finestra si apre, dal pulsante della chat o con una chiamata.Niente
closeLa finestra si chiude.Niente
unreadCambia il numero di risposte non lette: arriva una risposta mentre la finestra è chiusa, oppure il visitatore la apre.Il numero di risposte non lette

Registri i suoi callback subito dopo lo snippet, così non perde ready.

Visitatori autenticati​

Quando il visitatore ha effettuato l'accesso al suo sito, ne trasmetta i dati con setUser. Ogni campo è facoltativo e la finestra legge solo name, email e phone.

  • Il modulo pre-chat viene compilato con questi dati. Viene saltato quando ha tutto ciò che chiede, a meno che la casella di consenso non sia attiva: i visitatori la spuntano sempre da soli.
  • Vengono salvati nel profilo del cliente in MonoChat, così il suo team vede chi sta scrivendo.
  • Se l'indirizzo email o il numero di telefono non è valido, nessuno dei dati viene salvato.

Esempi​

Aprire la finestra da un proprio pulsante e nascondere il pulsante della chat:

<button onclick="MonoChat('open')">Scrivici</button>
<script>
MonoChat('hideLauncher')
</script>

Trasmettere un utente autenticato e mostrare la finestra nella lingua della pagina:

<script>
MonoChat('setUser', { name: 'Jane Doe', email: 'jane@example.com', phone: '+1 555 010 0000' })
MonoChat('setLocale', document.documentElement.lang)
</script>

Mostrare il numero di risposte non lette su un proprio pulsante:

<button onclick="MonoChat('open')">Assistenza <span id="chat-unread"></span></button>
<script>
MonoChat('hideLauncher')
MonoChat('on', 'unread', function (count) {
document.getElementById('chat-unread').textContent = count || ''
})
</script>

Inviare un evento al proprio strumento di analisi quando un visitatore apre la finestra:

<script>
MonoChat('on', 'open', function () {
gtag('event', 'chat_opened')
})
</script>

Conversazioni​

Ogni visitatore è un cliente in MonoChat e la sua conversazione resta nel suo browser: un visitatore che torna con lo stesso browser vede gli ultimi 200 messaggi, per 90 giorni dopo l'ultimo messaggio. Un altro browser o dispositivo avvia una nuova conversazione. Le risposte del suo team e l'indicatore di scrittura compaiono nella finestra in tempo reale.

Il pulsante delle emoji accanto alla casella del messaggio offre le emoji più comuni. I visitatori possono anche digitare qualsiasi emoji dalla tastiera.

I messaggi che un visitatore invia mostrano le spunte, come su WhatsApp: una spunta grigia quando il messaggio è stato inviato, due spunte grigie quando è arrivato in MonoChat e due spunte blu appena qualcuno del suo team ha aperto la conversazione. In MonoChat le sue risposte risultano consegnate quando la finestra del visitatore le riceve e lette quando il visitatore apre la finestra.

Quando la finestra è chiusa, una nuova risposta mostra il numero di messaggi non letti sul pulsante della chat e riproduce un breve suono. I browser riproducono il suono solo dopo che il visitatore ha fatto clic o digitato in un punto qualsiasi della pagina.

Tipi di messaggio​

La finestra mostra i messaggi come la schermata della chat di MonoChat: il nome dell'agente sopra le risposte, una riga con la data dove inizia un nuovo giorno e l'ora all'interno di ogni fumetto, con le spunte sui messaggi del visitatore.

Oltre a testo, emoji e file, le sue risposte possono usare i tipi qui sotto. Li invii dal nodo di flusso Invia messaggio, dai messaggi brevi, dalle app e dalle funzioni (veda Tipi di messaggio).

TipoCome lo mostra la finestra
Immagine, video, audio, stickerAll'interno del fumetto.
DocumentoUna scheda con il tipo e il nome del file che scarica il file.
Risposte rapidePulsanti sotto l'ultimo messaggio. Un clic invia il titolo del pulsante come risposta del visitatore.
PulsanteUn messaggio con un'intestazione facoltativa (un testo, un'immagine, un video o un documento), un piè di pagina e pulsanti che inviano una risposta, aprono un indirizzo web o chiamano un numero di telefono.
URL CTAUn messaggio con un solo pulsante che apre un indirizzo web.
ElencoLe righe all'interno del fumetto, raggruppate per sezione. Un clic su una riga la invia come risposta del visitatore.
CaroselloSchede che il visitatore scorre lateralmente, ciascuna con un'immagine o un video, un titolo, un sottotitolo e pulsanti.
PosizioneUn segnaposto con il nome e l'indirizzo del luogo che apre il luogo in Google Maps.
Richiesta di posizioneUn pulsante Invia posizione. Il browser chiede il permesso al visitatore, poi la posizione del visitatore arriva in MonoChat come messaggio di posizione.
ContattiIl nome e l'azienda di ogni contatto, con link per chiamare i numeri di telefono e scrivere agli indirizzi email del contatto.

Le risposte rapide, i pulsanti di risposta, le righe dell'elenco e la richiesta di posizione funzionano solo sull'ultimo messaggio, così i visitatori non possono rispondere a una domanda vecchia.

Icone dei pulsanti​

I pulsanti che aprono un indirizzo web possono mostrare un'icona: la scelga nel campo Icona di un messaggio URL CTA o di un pulsante URL web. Il campo compare solo quando crea il messaggio per Web Chat: gli altri canali non mostrano icone. Le icone sono Link, Sito web, WhatsApp, Instagram, Messenger, Facebook, Telegram, TikTok, Telefono, E-mail e Posizione; un pulsante senza icona mostra l'icona del link.

I flussi e il widget​

Messaggi di benvenuto, orari di apertura, risposte fuori orario, richiesta di un indirizzo email o di un numero di telefono e messaggi proattivi si configurano con i flussi, non con le impostazioni del canale.

L'evento Azione del cliente ricevuta avvia un flusso dalla finestra:

  • Widget della chat aperto per la prima volta: il visitatore apre la finestra e non ha una conversazione aperta. MonoChat avvia la conversazione, o riapre quella chiusa, così il flusso può scrivere al visitatore prima che lo faccia lui. Riaprire la finestra mentre la conversazione è aperta non lo attiva di nuovo.
  • Widget della chat aperto: il visitatore apre la finestra, ogni volta, compresa la prima. Un visitatore senza una conversazione aperta ne riceve una, come sopra.
  • Widget della chat chiuso: il visitatore chiude la finestra durante una conversazione aperta.

Quando il modulo pre-chat è attivo, la finestra conta come aperta dopo che il visitatore lo ha compilato.

Visualizzare una pagina con il widget non attiva nessuno di essi. Un visitatore che non ha scritto diventa cliente in MonoChat solo se un flusso ascolta l'azione.

In modalità a pagina intera la finestra si apre con la pagina, quindi caricare la pagina conta come aprire la finestra. Ogni canale conta al massimo 60 aperture della finestra al minuto; quelle in più non avviano alcun flusso.

Per accogliere i visitatori, crei un flusso che parte da Azione del cliente ricevuta impostato su Widget della chat aperto per la prima volta e aggiunga un nodo Invia messaggio con il suo messaggio di benvenuto. Lo crei con l'editor di messaggi, con pulsanti di risposta, un elenco o link con icone.

Powered by MonoChat​

La finestra mostra una piccola riga Powered by con il logo di MonoChat. Non è un'impostazione del canale: si può nascondere solo per un'intera installazione di MonoChat.