Widget di chat web

La chat con gli ospiti,
sul tuo sito.

Un solo tag script mette una bolla di chat sul tuo sito. Gli ospiti ti scrivono da lì e ogni conversazione arriva nella stessa casella Prohost dei tuoi thread Airbnb e Vrbo, con la tua IA che risponde per prima.

Un solo tag script
Risposte nella tua casella
il-tuo-sito.com
Scrivici
Di solito risponde in pochi minuti
Domenica è possibile un check-out posticipato?
Sì, possiamo tenere l’alloggio fino alle 14.

Cosa fa il widget

È la stessa chat per ospiti che gira sul tuo sito di prenotazione diretta Prohost, pronta per qualsiasi sito che gestisci.

Vive sul tuo sito

Incolla un tag script nel footer del sito o nell’area del codice personalizzato. Nessun plugin, nessuna build, niente da ospitare.

Una casella per tutto

Le conversazioni della chat web arrivano nella casella Prohost accanto ai thread delle OTA, così il tuo team risponde a tutto da un unico posto.

La tua IA risponde per prima

La stessa IA che gestisce i messaggi con gli ospiti risponde anche qui, con la conoscenza dei tuoi alloggi, e passa la parola a una persona quando serve.

Installalo in tre passaggi

Copia lo snippet dalle impostazioni del widget, incollalo nel sito, pubblica.

  1. Crea il tuo widget

    Apri l’app Widget Chat IA in Prohost e imposta nome, messaggio di benvenuto e stile del pulsante che vedranno i visitatori.

  2. Copia il tuo snippet

    Nella sezione Aggiungi a un altro sito, copia lo snippet. Contiene già l’id del widget, la chiave di incorporamento e le impostazioni del pulsante.

  3. Incollalo prima del tag body di chiusura

    Mettilo nel footer globale del sito o nell’area del codice personalizzato e pubblica. Al caricamento successivo il pulsante compare nell’angolo.

html
<script
  src="https://app.prohost.ai/webchat.js"
  data-widget="WIDGET_ID"
  data-api-key="WIDGET_API_KEY"
  data-position="bottom-right"
  data-launcher-color="#4F46E5"
  data-launcher-icon="chat"
  data-sound="on"
  async></script>

Sostituisci WIDGET_ID e WIDGET_API_KEY con i valori dalle impostazioni del widget, oppure copia direttamente lo snippet già pronto dall’app, che li compila per te. La chiave di incorporamento è pubblica e vale solo per quel widget: non dà alcun accesso al tuo account. Prohost nasconde la chiave dopo la prima visualizzazione, quindi usa Ruota chiave se ti serve uno snippet copiabile aggiornato.

La versione più corta che funziona

Sono obbligatori solo l’id del widget e la chiave di incorporamento. Se ometti gli attributi del pulsante, questo usa i propri valori predefiniti — la bolla indaco e l’icona della chat — a prescindere da cosa hai scelto nell’app. La finestra invece continua a seguire le tue impostazioni.

html
<script
  src="https://app.prohost.ai/webchat.js"
  data-widget="WIDGET_ID"
  data-api-key="WIDGET_API_KEY"
  async></script>

Funziona con la maggior parte dei site builder: Webflow, WordPress, Squarespace e Wix hanno tutti uno spazio per il codice personalizzato nel footer.

Riferimento attributi

Tutti gli attributi data-* letti dal loader. Qualsiasi altra cosa sul tag script viene ignorata.

AttributoValoriPredefinitoCosa fa
data-widgetL’id del tuo widgetObbligatorioA quale widget appartiene la conversazione.
data-api-keyLa tua chiave pubblica di incorporamentoObbligatorioLa chiave pubblica di incorporamento di quel widget. Vale solo per il widget e non dà accesso all’account.
data-positionbottom-right · bottom-leftbottom-rightIn quale angolo stanno il pulsante e la finestra di chat.
data-launcher-colorColore esadecimale#4F46E5Colore di riempimento della bolla del pulsante.
data-accentColore esadecimaleNessunoVecchio nome di data-launcher-color. Usato solo quando data-launcher-color manca.
data-launcher-iconchat · lettermarkchatIl simbolo sul pulsante: una bolla di chat oppure il monogramma bianco Prohost.
data-hide-mobileSolo presenzaDisattivoNasconde il pulsante sotto i 768px. La finestra resta apribile da un tuo pulsante — vedi sotto.
data-soundonImpostazione del widgetAttiva il suono di risposta per questo incorporamento, a prescindere dall’impostazione del widget. Vedi sotto.

data-hide-mobile conta solo per la sua presenza: qualsiasi valore, anche una stringa vuota, lo attiva. Tutti gli altri attributi vengono valutati sul valore, e data-sound in particolare reagisce solo al valore esatto in minuscolo on.

Come funziona il suono di risposta

Un tocco breve e discreto suona nella finestra di chat quando arriva una risposta e il visitatore sta guardando altrove.

Impostazione

Riproduci suono per gli ospiti

L’interruttore nelle impostazioni del widget, ed è quello che fa fede. Vale per questo widget ovunque giri, incluso il tuo sito di prenotazione diretta ospitato da Prohost. Cambialo quando vuoi, senza toccare il codice.

Attributo

data-sound="on"

Una forzatura esplicita sul tag script che hai incollato. Può solo attivare il suono: non esiste un valore per spegnerlo. Serve a far funzionare ancora gli snippet incollati prima che l’impostazione esistesse, e a forzare il suono su un sito specifico.

Ne basta uno dei due

Il suono parte se l’impostazione è attiva oppure se l’attributo ha esattamente il valore on. Lo snippet generato dall’app tiene le due cose allineate: include l’attributo finché l’impostazione è attiva e lo omette quando è disattivata.

Per silenziarlo ovunque, disattiva l’impostazione e ricopia lo snippet nel sito. Un attributo già incollato continua a prevalere sull’impostazione: è voluto.

  • Il visitatore deve prima interagire con la pagina

    I browser bloccano l’audio finché qualcuno non clicca, tocca o scrive. Aprire il pulsante conta, e scrivere nella finestra pure — quindi chi ha inviato il messaggio che ha generato la risposta la sentirà. Se il browser blocca comunque la riproduzione non si rompe nulla: il contatore di non letti sul pulsante è il segnale principale e il suono è un extra.

  • Non suona mai mentre stanno leggendo

    Nessun suono se la finestra è aperta e la scheda è in primo piano: la risposta è già a schermo. Suona a finestra chiusa o con la scheda in secondo piano. Il contatore di non letti segue una regola un po’ più stretta: compare solo a finestra chiusa.

  • Una raffica di risposte, un solo suono

    Più messaggi che arrivano insieme producono un unico avviso, non uno per messaggio.

Comandalo dalla tua pagina

Il loader espone un piccolo bus di eventi su window.ProhostWebchat, così il tuo sito può aprire la finestra e reagire a quello che succede dentro.

javascript
function wireUpWebchat() {
  window.ProhostWebchat.on('webchat_host_message', (event) => {
    console.log(event.type);
  });

  document.querySelector('#my-chat-button')?.addEventListener('click', () => {
    window.ProhostWebchat.open();
    // window.ProhostWebchat.close() collapses it again.
  });
}

if (window.ProhostWebchat) {
  wireUpWebchat();
} else {
  // src*= rather than src$= — the tag may carry a cache-busting query string.
  document
    .querySelector('script[src*="/webchat.js"]')
    ?.addEventListener('load', wireUpWebchat);
}
webchat_session_startedLa conversazione ora esiste: il visitatore ha inviato il primo messaggio. Il suo payload contiene il conversationId.
webchat_message_sentIl visitatore ha inviato un messaggio.
webchat_host_messageÈ arrivata una risposta dal tuo team o dalla tua IA. Alimenta il contatore di non letti e, se attivo, il suono.

Utile insieme a data-hide-mobile: nascondi il pulsante predefinito sul telefono e apri la finestra da un pulsante tuo. Gli eventi vengono inoltrati solo se arrivano dall’incorporamento Prohost, mai da un’altra origine.

Gestisci tutto dall’app

Nome, messaggio di benvenuto, colore d’accento della finestra e suono di risposta stanno nell’app Widget Chat IA, e ogni sito che usa il tuo widget recepisce quelle modifiche da solo. Colore e icona del pulsante sono diversi: stanno nello snippet, quindi ricopialo dopo averli cambiati, come dopo aver ruotato la chiave di incorporamento.