Incorporamento nel sito web

Una sola riga di script per aggiungere la finestra di chat al sito, oltre ai metodi richiamabili dalla pagina e alle regole linguistiche.

Il {API} qui sotto indica l'indirizzo del servizio; lo trovi nella pagina «Integrazione» del pannello di amministrazione.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key è la chiave pubblica; copiala dalla pagina «Integrazione» del pannello.
  • Nella pagina «Integrazione», registra i siti consentiti per l'incorporamento (ad esempio https://shop.example.com); anche se altri siti ottengono la tua chiave pubblica, non potranno usarla. Compila questo campo prima di andare online.
  • Opzionale data-theme="dark" per usare lo stile scuro.
  • Opzionale data-language="de": se il sito è multilingua, passa la lingua della pagina corrente; l'assistenza clienti userà questa lingua per impostazione predefinita (i visitatori possono comunque cambiarla). I codici lingua supportati sono elencati nella Panoramica delle API pubbliche.
  • Opzionale data-language="auto": prende <html lang> della pagina come lingua predefinita; quando poi la pagina cambia lingua (modificando l'attributo lang, anche senza ricaricare in un'applicazione a pagina singola) la finestra di assistenza cambia automaticamente.

Nella pagina puoi chiamare:

MetodoAzione
AICS.open() / AICS.close() / AICS.toggle()Apre, chiude o attiva/disattiva la finestra di assistenza, ad esempio su un pulsante «Contatta l'assistenza»
AICS.identify(userToken)Dopo l'accesso del cliente, comunica all'assistenza chi è (vedi Identificare i clienti connessi)
AICS.setLanguage(code)Da chiamare quando il sito cambia lingua: la finestra di assistenza e le risposte successive seguiranno la nuova lingua, ad esempio AICS.setLanguage("ja"); accetta anche forme come zh-Hans e pt-BR
AICS.reset()Da chiamare quando il cliente esce: rimuove la finestra di assistenza e scarta la sessione corrente; ricaricando lo script si ottiene una nuova finestra anonima, così la persona successiva non vede la conversazione precedente

Lingua

  • La finestra di assistenza mostra la lingua corrispondente alla località del visitatore (IP), inclusi i testi dell'interfaccia e il messaggio di benvenuto; se data-language è impostato, ha priorità la lingua della pagina. Se non è possibile determinare la località, viene usata la «Lingua predefinita» impostata nel pannello.
  • L'AI risponde nella lingua usata dal cliente; se dal contenuto inviato dal cliente non si riesce a capire la lingua (emoji, numero d'ordine), usa la lingua determinata come sopra.
  • Il cliente può cambiare lingua dal menu nella parte superiore della finestra oppure chiedere direttamente all'AI «Rispondi in inglese». Da quel momento l'AI continuerà a usare quella lingua, anche se il cliente scrive in un'altra lingua.
  • Anche il cambio di lingua del sito (tramite AICS.setLanguage o, con data-language="auto", modificando <html lang>) conta come scelta del cliente; tra questo e i metodi precedenti vale l'ultima scelta. La lingua predefinita con cui si apre la pagina non sovrascrive però la lingua scelta dal cliente.
  • In «Impostazioni del bot → Lingua» nel pannello puoi disattivare il rilevamento tramite IP, modificare la lingua predefinita e limitare le lingue disponibili.
  • Se il servizio è distribuito dietro un reverse proxy o una CDN, devi configurare TRUSTED_PROXIES o COUNTRY_HEADER lato server; altrimenti non sarà possibile ottenere l'IP reale del visitatore.

Questa pagina ti è stata utile?

Ultimo aggiornamento: