Widget de chat web

Le chat voyageurs,
sur votre propre site.

Une seule balise script pose une bulle de chat sur votre site. Les voyageurs vous écrivent depuis là, et chaque conversation arrive dans la même boîte de réception Prohost que vos fils Airbnb et Vrbo — votre IA répondant en première ligne.

Une seule balise script
Les réponses dans votre boîte
votre-site.com
Écrivez-nous
Répond en général en quelques minutes
Un départ tardif est-il possible dimanche ?
Oui, nous pouvons garder le logement jusqu’à 14 h.

Ce que fait le widget

C’est le même chat voyageurs que celui de votre site de réservation directe Prohost, prêt à poser sur n’importe quel site qui vous appartient.

Vit sur votre site

Collez une balise script dans le pied de page ou la zone de code personnalisé. Aucun plug-in, aucune étape de build, rien à héberger.

Une seule boîte pour tout

Les conversations du chat web arrivent dans la boîte Prohost à côté de vos fils OTA : votre équipe répond à tout au même endroit.

Votre IA répond en premier

La même IA que pour votre messagerie voyageurs répond ici aussi, avec la connaissance de vos logements, et passe la main à un humain quand il le faut.

Installation en trois étapes

Copiez l’extrait depuis les réglages de votre widget, collez-le dans votre site, publiez.

  1. Créez votre widget

    Ouvrez l’app Widget de chat IA dans Prohost et définissez le nom, le message d’accueil et le style du bouton que verront vos visiteurs.

  2. Copiez votre extrait

    Dans la section Ajouter à un autre site, copiez l’extrait. Il contient déjà l’identifiant de votre widget, votre clé d’intégration et vos réglages de bouton.

  3. Collez-le avant la balise body fermante

    Placez-le dans le pied de page global ou la zone de code personnalisé, puis publiez. Le bouton apparaît dans le coin au chargement suivant.

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>

Remplacez WIDGET_ID et WIDGET_API_KEY par les valeurs de vos réglages de widget, ou copiez simplement l’extrait tout prêt depuis l’app, qui les remplit pour vous. La clé d’intégration est publique et limitée à ce seul widget : elle ne donne aucun accès à votre compte. Prohost masque la clé après le premier affichage ; utilisez Renouveler la clé si vous avez besoin d’un extrait copiable à jour.

La version la plus courte qui fonctionne

Seuls l’identifiant du widget et la clé d’intégration sont obligatoires. Si vous omettez les attributs du bouton, celui-ci reprend ses propres valeurs par défaut — la bulle indigo et l’icône de chat — quel que soit votre choix dans l’app. La fenêtre, elle, suit toujours vos réglages.

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

Fonctionne avec la plupart des créateurs de sites : Webflow, WordPress, Squarespace et Wix disposent tous d’un emplacement pour du code personnalisé en pied de page.

Référence des attributs

Tous les attributs data-* que lit le loader. Tout le reste sur la balise script est ignoré.

AttributValeursPar défautEffet
data-widgetL’identifiant de votre widgetObligatoireÀ quel widget la conversation appartient.
data-api-keyVotre clé d’intégration publiqueObligatoireLa clé d’intégration publique de ce widget. Elle est limitée au widget et ne donne aucun accès au compte.
data-positionbottom-right · bottom-leftbottom-rightDans quel coin se placent le bouton et la fenêtre de chat.
data-launcher-colorCouleur hexadécimale#4F46E5Couleur de remplissage de la bulle du bouton.
data-accentCouleur hexadécimaleAucuneAncien nom de data-launcher-color. Utilisé uniquement si data-launcher-color est absent.
data-launcher-iconchat · lettermarkchatLe symbole du bouton : une bulle de chat, ou le monogramme blanc Prohost.
data-hide-mobilePrésence seuleDésactivéMasque le bouton en dessous de 768px. La fenêtre reste ouvrable depuis un bouton à vous — voir plus bas.
data-soundonRéglage du widgetActive le son de réponse pour cette intégration, quel que soit le réglage du widget. Voir plus bas.

data-hide-mobile ne compte que par sa présence : n’importe quelle valeur, y compris une chaîne vide, l’active. Tous les autres attributs sont évalués sur leur valeur, et data-sound ne réagit qu’à la valeur exacte en minuscules on.

Comment fonctionne le son de réponse

Un carillon bref et discret retentit dans la fenêtre de chat quand une réponse arrive et que le visiteur regarde ailleurs.

Réglage

Jouer un son pour les voyageurs

L’interrupteur dans les réglages de votre widget, et la référence qui fait foi. Il s’applique à ce widget partout où il tourne, y compris sur votre site de réservation directe hébergé par Prohost. Modifiable à tout moment, sans toucher au code.

Attribut

data-sound="on"

Une dérogation explicite sur la balise script que vous avez collée. Elle ne peut qu’activer le son : il n’existe pas de valeur pour le couper. Elle existe pour que les extraits collés avant l’arrivée du réglage continuent de fonctionner, et pour vous permettre de forcer le son sur un site précis.

L’un ou l’autre suffit

Le carillon retentit si le réglage est activé ou si l’attribut porte la valeur exacte on. L’extrait généré par l’app garde les deux alignés : il inclut l’attribut tant que le réglage est activé et l’omet quand il est désactivé.

Pour couper le son partout, désactivez le réglage puis recopiez l’extrait dans votre site. Un attribut déjà collé continue de primer sur le réglage : c’est volontaire.

  • Le visiteur doit d’abord interagir avec la page

    Les navigateurs bloquent l’audio tant que personne n’a cliqué, touché ou tapé. Ouvrir le bouton compte, écrire dans la fenêtre aussi — celui qui a envoyé le message à l’origine de la réponse l’entendra donc. Si le navigateur bloque quand même la lecture, rien ne casse : la pastille de non-lus sur le bouton reste le signal principal et le son n’est qu’un bonus.

  • Jamais pendant qu’il lit

    Pas de carillon tant que la fenêtre est ouverte et l’onglet au premier plan : la réponse est déjà à l’écran. Il retentit fenêtre fermée ou onglet en arrière-plan. La pastille de non-lus suit une règle un peu plus stricte : elle n’apparaît que fenêtre fermée.

  • Une rafale de réponses, un seul carillon

    Plusieurs messages arrivant ensemble produisent un seul signal, pas un par message.

Pilotez-le depuis votre propre page

Le loader expose un petit bus d’événements sur window.ProhostWebchat : votre site peut ainsi ouvrir la fenêtre et réagir à ce qui s’y passe.

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 conversation existe désormais : le visiteur a envoyé son premier message. Son payload porte le conversationId.
webchat_message_sentLe visiteur a envoyé un message.
webchat_host_messageUne réponse de votre équipe ou de votre IA est arrivée. C’est ce qui alimente la pastille de non-lus et, si le son est activé, le carillon.

Pratique avec data-hide-mobile : masquez le bouton par défaut sur mobile et ouvrez la fenêtre depuis votre propre bouton. Les événements ne sont relayés que s’ils proviennent de l’intégration Prohost, jamais d’une autre origine.

Gérez tout depuis l’app

Le nom, le message d’accueil, la couleur d’accent de la fenêtre et le son de réponse vivent dans l’app Widget de chat IA, et tous les sites qui font tourner votre widget récupèrent ces changements tout seuls. La couleur et l’icône du bouton, c’est différent : elles sont dans l’extrait, alors recopiez-le après les avoir modifiées — comme après le renouvellement de votre clé d’intégration.