Guida agli Agenti Web

Un agente Web è il tuo agente vocale messo direttamente sul tuo sito: il visitatore clicca un pulsante sulla pagina e parla subito con lui, a voce, invece di compilare un modulo e aspettare una risposta. In questa guida lo creiamo, lo vestiamo e lo incolliamo su una pagina, passo per passo.

Un agente Web è lo stesso cervello del tuo agente vocale, con una porta d'ingresso nuova: il browser al posto del telefono. Il visitatore non deve chiamare un numero: clicca un widget sulla pagina e ci parla direttamente da lì.

  ┌─ IL TUO SITO ──────────┐          ┌─ IL TUO AGENTE ──────┐
  │  🌐  [ Parla con noi ] │          │  ascolta e risponde  │
  └───────────┬────────────┘          └──────────┬───────────┘
              │                                   │
              └──────────  si parlano  ───────────┘
                        a voce, dal vivo,
                          nel browser

   1. il visitatore clicca il pulsante sul tuo sito
   2. da quel momento lui e l'agente si parlano a voce, senza uscire dalla pagina

Come si legge: i due riquadri sono il tuo sito (a sinistra) e il tuo agente (a destra); la linea che li unisce è la conversazione a voce che avviene dentro il browser, dopo che il visitatore ha cliccato il pulsante.

Un agente = un canale. Come l'agente WhatsApp fa solo WhatsApp e quello telefonico solo telefono, un agente Web vive solo sul web. Se ti serve coprire più canali, crei più agenti.

Dove si crea

Vai su Agent Builder e apri il builder avanzato: compare la scelta del canale, con le card Inbound, Outbound, Web e WhatsApp. Scegli Web, quella con l'icona del mappamondo: "Widget vocale incorporabile per i visitatori del tuo sito".

Se non vedi la card Web, la funzione non è ancora attiva sul tuo workspace: si abilita su richiesta al supporto.

Da qui entri nel builder. Ed è una bella notizia: è lo stesso builder che già conosci per gli agenti telefonici. Non devi imparare uno strumento nuovo.

Come è fatto: sei tab, e una è la novità

Il builder ha sei schede in alto. Cinque le hai già viste con l'agente telefonico e funzionano identiche: le riassumo al volo:

• Identità: nome e descrizione dell'agente.

• Personalità: tono, settore, stile.

• Voce: la voce con cui parla.

• Azioni: gli strumenti che può usare (raccolta dati, strumenti personalizzati…).

• Istruzioni: obiettivi, primo messaggio, base di conoscenza da cui attinge.

Il cuore nuovo, quello che rende "Web" un agente Web, è la scheda Web. È lì che vestiamo il widget e lo prepariamo per il sito. Dedichiamole tutto lo spazio che merita.

Una differenza da sapere. Sul web alcuni strumenti da telefono non hanno senso e sono disattivati: trasferimento a un operatore umano, trasferimento a un altro agente, richiamami e rilevamento segreteria. Se il tuo caso d'uso ha bisogno del passaggio a una persona in carne e ossa, tienilo presente: sul widget vocale non è previsto (per ora).

La scheda Web, parte 1: vestire il widget

Qui decidi che faccia ha il pulsante sul tuo sito e come si comporta. Mentre modifichi, un pannello di anteprima a destra ti mostra il widget aggiornarsi in tempo reale: vedi subito l'effetto di ogni scelta.

Cosa puoi impostare:

Le etichette sono un tocco di cura che fa la differenza: puoi cambiare "Parla con noi" in qualcosa di tuo, e riscrivere "Avvia chiamata", "Termina", "Cambia lingua", "Muta microfono" e i testi dei termini. Piccole parole, ma è la voce del tuo brand sul pulsante.

Esempio. Un negozio online mette avatar personalizzato, colore primario sul proprio arancione, posizione basso-destra, etichetta principale "Hai domande? Parla con noi" e trascrizione attiva (così chi preferisce leggere segue comunque). In due minuti il widget sembra parte del sito, non un pezzo incollato.

Salva e vai live

Due pulsanti in alto, due significati:

• Salva: conserva la configurazione del widget. Utile anche perché la scheda di embed si sblocca solo dopo il primo salvataggio (l'agente ha bisogno di un'identità per generare il suo codice).

• Go live: pubblica l'agente e lo rende operativo. Per l'agente Web, a differenza di quello telefonico, non serve alcun numero di telefono: la sua "linea" è il browser. Parte una finestra di avanzamento che ti mostra i passaggi fino al completamento.

La scheda Web, parte 2: metterlo sul sito

Ora la parte che porta l'agente dal builder alla tua pagina. Tre gesti in ordine, ed è fatta.

1. Di' dove può girare: le origini consentite

Per sicurezza, il widget funziona solo sui siti che autorizzi tu. Nel riquadro "Origini consentite" aggiungi il dominio (o i domini) dove vuoi mostrarlo:

https://www.esempio.com
https://*.esempio.com   ← il jolly copre tutti i sottodomini

Puoi aggiungerne diversi. È la rete di protezione che impedisce a chiunque altro di incollare il tuo agente sul proprio sito.

2. Accendi l'interruttore

Attiva "Rendi questo agente embeddabile". Un dettaglio utile: l'interruttore non si accende finché non hai messo almeno un'origine: è il sistema che ti guida nell'ordine giusto, così non pubblichi un widget "aperto a tutti" per sbaglio.

3. Copia il codice e incollalo

Nel riquadro "Codice widget" trovi lo snippet da incollare nel tuo sito (pulsante "Copia codice"). È fatto di due righe:

<deepagent-agent agent-id="ID-DEL-TUO-AGENTE"></deepagent-agent>
<script async src="https://TUO-DOMINIO-DEEPAGENT/embed.js"></script>

Lo incolli nell'HTML della pagina (di solito nel footer va benissimo) e il widget compare da solo, nell'angolo e con i colori che hai scelto. Se la pagina è su un'origine che hai autorizzato, si connette e inizia a lavorare.

Vuoi personalizzare la conversazione con dati del visitatore? Nel riquadro "Variabili di contesto consentite" dichiari quali informazioni il tuo sito può passare al widget (es. userName, piano). Solo le chiavi che elenchi qui vengono accettate: di nuovo, sicurezza prima di tutto. È un extra opzionale: se non ti serve, saltalo.

Il builder ti aiuta anche con dei promemoria: se provi a copiare lo snippet prima di aver attivato l'embed o aggiunto un'origine, te lo ricorda con un avviso, così non ti sfugge un passaggio.

Provalo senza uscire dal builder

Non devi pubblicare per vederlo funzionare. Dopo aver salvato, nella scheda Web compare il widget vero, dal vivo, dentro il builder stesso: è lo stesso componente che finirà sul tuo sito. Ci clicchi, provi l'avatar, i colori, le etichette e la conversazione, e aggiusti finché è come lo vuoi.

Prima di pubblicare

L'unico ordine obbligato è nella scheda Web: origine consentita → accendi l'embed → copia lo snippet. Se salti un passaggio, il builder te lo segnala prima che tu possa copiare il codice o accendere l'interruttore. Ricorda inoltre i due limiti attuali: sul widget non c'è passaggio a un operatore umano, e la vista dedicata alle conversazioni web è ancora in arrivo.

Il vantaggio è che parti da un agente che già sa parlare: gli aggiungi solo un nuovo punto d'ingresso, il tuo sito. Da quando l'embed è live, chi visita la pagina può parlare con l'agente invece di compilare un modulo.