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.
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.
- 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.
- 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.
- 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.
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.
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.
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.
| Attributo | Valori | Predefinito | Cosa fa |
|---|---|---|---|
data-widget | L’id del tuo widget | Obbligatorio | A quale widget appartiene la conversazione. |
data-api-key | La tua chiave pubblica di incorporamento | Obbligatorio | La chiave pubblica di incorporamento di quel widget. Vale solo per il widget e non dà accesso all’account. |
data-position | bottom-right · bottom-left | bottom-right | In quale angolo stanno il pulsante e la finestra di chat. |
data-launcher-color | Colore esadecimale | #4F46E5 | Colore di riempimento della bolla del pulsante. |
data-accent | Colore esadecimale | Nessuno | Vecchio nome di data-launcher-color. Usato solo quando data-launcher-color manca. |
data-launcher-icon | chat · lettermark | chat | Il simbolo sul pulsante: una bolla di chat oppure il monogramma bianco Prohost. |
data-hide-mobile | Solo presenza | Disattivo | Nasconde il pulsante sotto i 768px. La finestra resta apribile da un tuo pulsante — vedi sotto. |
data-sound | on | Impostazione del widget | Attiva 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.
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.
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.
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.