Vai al contenuto
AurionAI

Aggiungi il widget web al tuo sito

5 min di letturaDi Emmanuel Yazbeck

Il widget web integra il supporto AurionAI nel tuo sito. I visitatori lo aprono tramite un pulsante in un angolo della pagina. Nella pagina Widget puoi attivare il widget, scegliere i siti web che possono visualizzarlo, modificarne l'aspetto e copiare il codice di incorporamento.

Disponibilità: tutti i profili. La voce nel widget richiede il profilo AI Voice o AI Voice + Helpdesk. Solo per amministratori.

Prerequisiti

  • Hai il ruolo Proprietario o Amministratore. Gli altri utenti visualizzano Accesso negato.
  • Puoi aggiungere uno script alle pagine del tuo sito web, oppure puoi chiedere al tuo team web di farlo.
  • Conosci l'indirizzo web di ogni sito che mostrerà il widget, ad esempio https://portal.northwind.example.

Aprire la pagina del widget

  1. Nella barra laterale, seleziona Configurazione.
  2. Apri la categoria Integrazioni.
  3. Seleziona Widget.

La pagina contiene le schede Stato e sicurezza, Aspetto e Codice di incorporamento. Con il profilo Helpdesk o AI Voice + Helpdesk, è presente anche la scheda Impostazioni chat.

La pagina Widget con la scheda Stato e sicurezza.

Chat, voce o entrambi

Il tuo profilo prodotto determina ciò che il widget offre. La scheda Stato e sicurezza lo mostra:

  • AI Voice: Questo widget è configurato per la modalità solo voce in base al piano AI Voice.
  • Helpdesk: Questo widget è configurato per la modalità solo chat in base al piano Helpdesk.
  • AI Voice + Helpdesk: Questo widget supporta sia chat che voce in base al Suo piano.

La parte vocale utilizza lo stesso agente AI della tua linea telefonica. Leggi Nome agente, saluto e comportamento. La parte chat utilizza la persona del servizio clienti del tuo agente e risponde in base agli articoli pubblicati nel tuo Help Center. Per gli articoli dell'Help Center, leggi Scrivi e pubblica articoli e Impostazioni della knowledge base.

Attivare il widget e impostare i siti consentiti

  1. Nella scheda Stato e sicurezza, attiva Abilita widget web.
  2. In Origini consentite, inserisci ogni sito web che può mostrare il widget. Inserisci un sito per riga, con https://, il nome host e, se necessario, la porta. Non aggiungere un percorso.
  3. Seleziona Salva impostazioni widget web.

Come AurionAI verifica i siti consentiti:

  • Il sito della pagina deve corrispondere esattamente a una voce: lo stesso http o https, lo stesso nome host e la stessa porta. https://northwind.example e https://www.northwind.example sono due siti diversi.
  • I percorsi non vengono considerati. Una voce copre tutte le pagine di un sito.
  • Puoi inserire fino a 50 siti.
  • Su qualsiasi altro sito, AurionAI rifiuta di avviare il widget.
  • Il tuo Help Center AurionAI mostra sempre il widget, sia sul suo indirizzo aurionai.net sia sul tuo dominio personalizzato una volta che tale dominio è verificato. Non è necessario aggiungerli e non dipendono da Abilita widget web. Leggi Usa il tuo dominio.

Per il single sign-on nel widget, leggi Single sign-on per gli utenti finali.

Modificare l'aspetto del widget

Nella scheda Aspetto:

  1. Seleziona Posizione del launcher: In basso a destra o In basso a sinistra.
  2. Seleziona un Tema accento. Per usare i tuoi colori personalizzati, attiva Usa colori personalizzati e imposta Colore primario e Colore di accento.
  3. In Lingua da modificare, seleziona una lingua. Quindi inserisci Titolo del widget, Etichetta launcher, Testo di benvenuto e Messaggio bolla del launcher per quella lingua. Ripeti per ogni lingua necessaria.
  4. Facoltativo: sotto Logo aziendale, carica un file PNG, SVG o JPG di 200 KB o meno.
  5. Facoltativo: imposta Tema del widget, Azioni rapide e Mostra badge "Powered by".
  6. Seleziona Salva impostazioni widget web.

Il widget mostra i testi nella lingua del browser del visitatore. Quando una lingua non ha testo, utilizza il testo in inglese.

Aggiungere il widget al tuo sito web

  1. Nella scheda Codice di incorporamento, seleziona Lingua del widget. Rilevamento automatico (lingua della pagina) segue la lingua della pagina.
  2. Seleziona Copia snippet.
  3. Incolla il codice nelle pagine del tuo sito web, oppure forniscilo al tuo team web.

Il codice contiene la tua Chiave pubblica del widget. Se selezioni Rigenera chiave, AurionAI crea immediatamente una nuova chiave. La rigenerazione della chiave invalida gli snippet precedenti che usano la chiave precedente. Copia il nuovo codice nel tuo sito web dopo aver rigenerato la chiave.

Risultato

Su un sito consentito, il pulsante del widget appare nell'angolo che hai scelto. I visitatori possono chattare, parlare con l'agente AI o entrambe le cose, a seconda del tuo profilo. Il widget legge le sue impostazioni ogni volta che viene caricata una pagina con il widget, quindi le modifiche salvate vengono visualizzate al successivo caricamento della pagina.

Se qualcosa va storto

  • È richiesta almeno un'origine consentita quando il widget è abilitato. Inserisci almeno un sito oppure disattiva il widget.
  • Il salvataggio non riesce con un messaggio relativo a un'origine consentita. Ogni riga deve iniziare con http:// o https:// e contenere un nome host. Rimuovi percorsi, stringhe di query e nomi utente.
  • Il salvataggio non riesce con un messaggio che inizia con "Widget GA gate checks failed". AurionAI verifica alcune impostazioni di sicurezza quando il widget diventa utilizzabile per la prima volta su un sito. Se il messaggio indica recording_consent, disattiva la registrazione delle chiamate oppure inserisci un testo di consenso. Leggi Registrazione delle chiamate. Per gli altri nomi, contatta il supporto AurionAI. Leggi Ottieni assistenza.
  • Il widget non appare sul tuo sito. Verifica che Abilita widget web sia attivo, che il sito sia presente in Origini consentite con il corretto https, nome host e porta, e che la pagina utilizzi il codice aggiornato. Dopo Rigenera chiave, il vecchio codice non funziona più. Il widget si interrompe anche quando il tuo account è sospeso.
  • Il logo deve essere PNG, SVG o JPG. Usa un file PNG, SVG o JPG.
  • Impossibile caricare la configurazione del widget web. Aggiorni la pagina e riprovi. Ricarica la pagina.
  • Salvataggio impostazioni widget vocale non riuscito Riprova. Se l'errore persiste, contatta il supporto AurionAI.

Articoli correlati

Hai ancora bisogno di aiuto? Invia una richiesta o .