Vai al contenuto
Documentazione

Moduli in chat: raccogli i dati in un solo passaggio

Crea brevi moduli fino a 20 campi, come una richiesta di preventivo o un reso, che l'agente mostra sotto la risposta quando servono. Gli invii arrivano in Leads, via email, su Slack, via webhook e a un webhook proprio del modulo.

Un modulo in chat raccoglie più dati in una volta, per esempio per cosa un visitatore vuole un preventivo, oppure un numero d'ordine e il motivo di un reso, invece di far fare all'agente una domanda alla volta. Crei il modulo nella scheda Actions (azioni). L'agente decide quando mostrarlo. I campi sono sempre quelli che hai impostato tu.

Creare un modulo

  1. Nella scheda Actions vai a Forms, sotto le tue azioni, e clicca su Add form.
  2. Compila i campi:
    • Name (nome): mostrato ai visitatori come titolo del modulo. Fino a 60 caratteri.
    • When to show it (quando mostrarlo): lo legge l'agente, i visitatori non lo vedono. Descrivi in massimo 1.000 caratteri i momenti in cui il modulo è utile. Per esempio: "Quando il visitatore chiede il prezzo di un ordine personalizzato o vuole un preventivo per più articoli."
    • Fields (campi): ciò che chiede il modulo, fino a 20 campi. Ognuno ha un Label (etichetta) di massimo 60 caratteri, un Type (tipo) e una casella Required (obbligatorio). Due campi non possono avere la stessa etichetta. Usa le frecce per cambiare l'ordine.
    • Button text (testo del pulsante): facoltativo, fino a 30 caratteri. Se lo lasci vuoto, i visitatori vedono "Invia" nella loro lingua.
    • Message after sending (messaggio dopo l'invio): facoltativo, fino a 300 caratteri. Se lo lasci vuoto, i visitatori vedono un breve ringraziamento nella loro lingua.
  3. Lascia attivo Agent can show this form, controlla la Preview (anteprima) e clicca su Add form.
TipoCosa inserisce il visitatore
Short textFino a 200 caratteri
Long textFino a 2.000 caratteri
EmailUn indirizzo email, controllato prima dell'invio
PhoneUn numero di telefono di massimo 30 caratteri, controllato prima dell'invio
NumberUn numero come 12 o 12.5, anche con la virgola
DateUna data, scelta in un campo data
DropdownUna delle tue opzioni. Inserisci un'opzione per riga, fino a 20 opzioni di massimo 60 caratteri ciascuna.

I visitatori vedono nome, etichette, opzioni, testo del pulsante e messaggio esattamente come li scrivi, quindi scrivili nella lingua dei tuoi visitatori. Il resto del modulo, come "(facoltativo)", i messaggi di errore, l'"Invia" predefinito e il ringraziamento predefinito, segue Widget language nella scheda Appearance.

Gestire i moduli

Ogni modulo nell'elenco mostra il badge Form, il numero di campi e il numero di invii.

  • L'interruttore Enabled impedisce all'agente di offrire il modulo, senza eliminarlo. Un modulo già mostrato in una chat indica allora "Questo modulo non è più disponibile."
  • Edit apre il modulo. Se rinomini o rimuovi un campo, le risposte già inviate dai visitatori restano. Un modulo mostrato di nuovo in una chat, per esempio dopo un ricaricamento, presenta la tua versione attuale.
  • Il pulsante del cestino elimina il modulo e tutti i suoi invii. Non si può annullare, quindi esporta prima gli invii dalla scheda Leads se vuoi conservarli.

Un agente può avere fino a 10 moduli. I moduli non contano nel limite di 25 azioni.

Quando l'agente mostra un modulo

L'agente legge When to show it per ogni modulo attivo. Quando la conversazione lo richiede, mostra il modulo sotto la sua risposta e lo cita con una breve frase. Non chiede gli stessi dati in chat.

  • Il modulo viene costruito da quello che hai salvato. Il modello di IA decide solo quando mostrarlo, mai cosa chiede.
  • L'agente mostra al massimo un modulo sotto una risposta.
  • Nessun modulo compare sotto una risposta che mostra già il modulo lead perché una delle tue regole l'ha attivato.
  • I moduli non compaiono nelle chat temporanee, dove non viene salvato nulla. L'agente invita invece il visitatore a tornare alla sua conversazione salvata.

I moduli compaiono nella bolla della chat, nell'iframe incorporato, nel link diretto, nella pagina di assistenza e nel Playground. Vengono salvati con la risposta, quindi si vedono anche nelle trascrizioni della scheda Conversations, dove Why this answer li elenca sotto Actions called come "Form".

Cosa fanno i visitatori

Il visitatore compila il modulo sotto la risposta e clicca sul pulsante. I campi obbligatori e le risposte di tipo email, telefono, numero e data vengono controllati prima dell'invio. Poi il modulo mostra il tuo Message after sending.

Ogni modulo si può inviare una volta per conversazione. Dopo risulta inviato, anche se il visitatore ricarica la pagina.

Gli invii nella scheda Leads

Nella scheda Leads, il riquadro Form submissions elenca ciò che i visitatori hanno inviato. Scegli un modulo in Form per vederne gli invii, dal più recente, 20 per pagina, con le risposte e un link alla conversazione.

  • Refresh carica i nuovi invii.
  • Export CSV scarica fino a 10.000 degli invii più recenti del modulo scelto. Il file ha le colonne Submitted at (UTC), una colonna per campo con la sua etichetta attuale, nell'ordine del modulo, e Conversation ID. Un campo rimosso riceve una colonna dopo queste quando un invio vi ha risposto. Le risposte che iniziano con =, +, - o @ ricevono un apostrofo iniziale, così i fogli di calcolo non le leggono come formule.
  • Il pulsante del cestino elimina un invio. I webhook e le email già inviati non cambiano.

Notifiche

  • Email: ogni invio arriva via email ai destinatari delle tue notifiche dei lead, ma solo finché Email when a new lead arrives è attivo. L'oggetto è New " seguito dal nome del modulo, da " form from e dal nome dell'agente. L'email elenca le risposte e l'ora, con un pulsante See the conversation. Se il modulo ha un campo email, la risposta va all'indirizzo inserito dal visitatore. Ogni agente invia al massimo 30 email di moduli all'ora, separate dalle notifiche dei lead; gli invii oltre questo limite vengono comunque salvati.
  • Slack: nel riquadro Slack alerts, seleziona Form submission in Post a message for. Vedi Notifiche Slack.
  • Webhook: iscrivi un webhook a Form submitted per ricevere l'evento form.submitted con le risposte di tutti i moduli. Vedi Webhook.
  • Il webhook proprio del modulo: invia solo gli invii di questo modulo a un indirizzo; vedi sotto.

Un webhook per un solo modulo

Ogni modulo può avere un webhook tutto suo, per esempio per inviare le richieste di preventivo al tuo CRM e le richieste di reso al sistema del tuo negozio. Riceve solo gli invii di questo modulo.

  1. Nella scheda Actions, clicca su Edit su un modulo salvato. Webhook for this form si trova in fondo all'editor. Un nuovo modulo lo riceve dopo che l'hai aggiunto.
  2. In Endpoint URL, incolla l'indirizzo che il tuo server o il tuo strumento fornisce per i webhook in entrata e clicca su Add webhook. L'indirizzo deve iniziare con https:// e puntare a un server pubblico, come per i webhook dell'agente.
  3. Copia il segreto di firma che compare, conservalo dove il tuo ricevitore può leggerlo e clicca su I've saved it. Viene mostrato per intero solo questa volta.
  4. Clicca su Send test event per controllare il collegamento.

Il pannello si salva da solo, separatamente dal modulo. Il suo interruttore Active mette in pausa gli invii, Save address cambia l'indirizzo, New secret sostituisce il segreto, Remove elimina il webhook e la sua cronologia degli invii, e Recent deliveries mostra gli ultimi 20 invii con un pulsante Resend per quelli non riusciti. L'elenco dei moduli mostra "own webhook" accanto a un modulo che ne ha uno.

  • Invia l'evento form.submitted, con lo stesso payload, la stessa firma, gli stessi nuovi tentativi e lo stesso registro degli invii dei webhook dell'agente. I suoi eventi non si possono cambiare.
  • Non conta nei 5 webhook dell'agente e non compare nel riquadro Webhooks della scheda Leads.
  • I webhook dell'agente iscritti a Form submitted continuano a ricevere gli invii di tutti i moduli, compreso questo. Per inviare gli invii di un modulo solo al suo webhook, togli la selezione da Form submitted nei webhook dell'agente.
  • Eliminare il modulo elimina anche il suo webhook. Un agente duplicato riceve una copia dei moduli senza i loro webhook.
  • Aggiungere o rimuovere il webhook, cambiarne l'indirizzo e creare un nuovo segreto richiedono il ruolo Admin o il proprietario dell'account; gli editor possono attivarlo o disattivarlo e inviare un evento di prova. Vedi Membri del team e ruoli.

Duplicare un agente

Un agente duplicato riceve una copia dei moduli, senza i webhook propri dei moduli. Gli invii restano con l'agente originale.

Visualizza come Markdown