Web-Chat-Widget

Gästechat,
auf deiner eigenen Website.

Ein Script-Tag genügt für die Chat-Blase auf deiner Website. Gäste schreiben dir von dort, und jede Unterhaltung landet im selben Prohost-Posteingang wie deine Airbnb- und Vrbo-Threads — deine KI antwortet als Erste.

Ein Script-Tag
Antworten in deinem Posteingang
deine-website.de
Schreib uns
Antwortet meist in wenigen Minuten
Ist am Sonntag ein später Check-out möglich?
Ja — wir halten die Unterkunft bis 14 Uhr frei.

Was das Widget kann

Es ist derselbe Gästechat, der auf deiner Prohost-Direktbuchungsseite läuft — nur verpackt für jede Website, die dir gehört.

Läuft auf deiner Website

Füge ein Script-Tag in den Footer oder den Bereich für eigenen Code ein. Kein Plug-in, kein Build-Schritt, nichts, was du selbst hosten musst.

Ein Posteingang für alles

Web-Chat-Unterhaltungen landen im Prohost-Posteingang direkt neben deinen OTA-Threads — dein Team beantwortet alles an einem Ort.

Deine KI antwortet zuerst

Dieselbe KI, die deine Gästenachrichten übernimmt, antwortet auch hier — mit dem Wissen über deine Unterkünfte und mit Übergabe an einen Menschen, wenn es nötig ist.

In drei Schritten eingebunden

Snippet in den Widget-Einstellungen kopieren, in deine Website einfügen, veröffentlichen.

  1. Widget anlegen

    Öffne die KI-Chat-Widget-App in Prohost und lege Name, Begrüßung und Stil des Chat-Buttons fest, den deine Besucher sehen.

  2. Snippet kopieren

    Kopiere das Snippet im Bereich Zu einer anderen Website hinzufügen. Es enthält bereits deine Widget-ID, deinen Embed-Key und deine Button-Einstellungen.

  3. Vor dem schließenden Body-Tag einfügen

    Setze es in den seitenweiten Footer oder den Bereich für eigenen Code und veröffentliche. Beim nächsten Seitenaufruf erscheint der Chat-Button in der Ecke.

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>

Ersetze WIDGET_ID und WIDGET_API_KEY durch die Werte aus deinen Widget-Einstellungen — oder kopiere einfach das fertige Snippet aus der App, das beides schon enthält. Der Embed-Key ist öffentlich und gilt nur für dieses eine Widget: Er gewährt keinerlei Zugriff auf dein Konto. Prohost blendet den Key nach der ersten Anzeige aus; nutze Key rotieren, wenn du ein frisches, kopierbares Snippet brauchst.

Die kürzeste Variante, die funktioniert

Pflicht sind nur die Widget-ID und der Embed-Key. Lässt du die Launcher-Attribute weg, nimmt der Chat-Button seine eigenen Standardwerte — indigofarbene Blase und Chat-Symbol —, egal was du in der App eingestellt hast. Das Chat-Fenster selbst richtet sich weiterhin nach deinen Einstellungen.

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

Funktioniert mit den meisten Website-Baukästen — Webflow, WordPress, Squarespace und Wix haben alle einen Platz für eigenen Code im Footer.

Attributreferenz

Alle data-*-Attribute, die der Loader liest. Alles andere am Script-Tag wird ignoriert.

AttributWerteStandardWirkung
data-widgetDeine Widget-IDPflichtZu welchem Widget die Unterhaltung gehört.
data-api-keyDein öffentlicher Embed-KeyPflichtDer öffentliche Embed-Key dieses Widgets. Er gilt nur für das Widget und gewährt keinen Kontozugriff.
data-positionbottom-right · bottom-leftbottom-rightIn welcher Ecke Chat-Button und Chat-Fenster sitzen.
data-launcher-colorHex-Farbe#4F46E5Füllfarbe der Chat-Blase.
data-accentHex-FarbeKeinerÄlterer Name für data-launcher-color. Wird nur verwendet, wenn data-launcher-color fehlt.
data-launcher-iconchat · lettermarkchatDas Zeichen auf dem Button: eine Chat-Blase oder das weiße Prohost-Wortzeichen.
data-hide-mobileNur VorhandenseinAusBlendet den Button unter 768px aus. Das Chat-Fenster lässt sich weiterhin über einen eigenen Button öffnen — siehe unten.
data-soundonWidget-EinstellungSchaltet den Antwortton für diese Einbindung ein, unabhängig von der Widget-Einstellung. Siehe unten.

data-hide-mobile zählt nur als vorhanden oder nicht: Jeder Wert, auch eine leere Zeichenkette, schaltet es ein. Alle anderen Attribute werden über ihren Wert ausgewertet — data-sound reagiert ausschließlich auf den exakten Kleinbuchstaben-Wert on.

So funktioniert der Antwortton

Ein kurzer, leiser Ton erklingt im Chat-Fenster, wenn eine Antwort eintrifft und der Besucher gerade woanders hinschaut.

Einstellung

Ton für Gäste abspielen

Der Schalter in deinen Widget-Einstellungen — die maßgebliche Quelle. Er gilt für dieses Widget überall, auch auf deiner bei Prohost gehosteten Direktbuchungsseite. Du kannst ihn jederzeit ändern, ganz ohne Code-Anpassung.

Attribut

data-sound="on"

Eine ausdrückliche Übersteuerung im eingefügten Script-Tag. Sie kann den Ton nur einschalten: Einen Aus-Wert gibt es nicht. Das Attribut existiert, damit vor Einführung der Einstellung eingefügte Snippets weiterlaufen — und damit du den Ton für eine bestimmte Website erzwingen kannst.

Eines von beiden genügt

Der Ton erklingt, wenn die Einstellung aktiv ist oder das Attribut den exakten Wert on trägt. Das von der App erzeugte Snippet hält beides im Gleichklang: Es enthält das Attribut, solange die Einstellung aktiv ist, und lässt es weg, wenn sie aus ist.

Um den Ton überall stummzuschalten, deaktiviere die Einstellung und kopiere das Snippet erneut in deine Website. Ein bereits eingefügtes Attribut übersteuert die Einstellung weiterhin — das ist so gewollt.

  • Der Besucher muss zuerst mit der Seite interagieren

    Browser blockieren Audio, bis jemand klickt, tippt oder etwas eingibt. Das Öffnen des Chat-Buttons zählt dazu, ebenso das Schreiben im Chat-Fenster — wer die Nachricht geschickt hat, die zur Antwort führte, hört den Ton also. Blockiert der Browser die Wiedergabe trotzdem, geht nichts kaputt: Das Ungelesen-Zeichen am Button ist das eigentliche Signal, der Ton nur eine Zugabe.

  • Nie, während gerade gelesen wird

    Kein Ton, solange das Chat-Fenster offen und der Tab im Vordergrund ist — die Antwort steht ja schon auf dem Bildschirm. Er erklingt bei geschlossenem Fenster oder wenn der Tab im Hintergrund liegt. Das Ungelesen-Zeichen folgt einer etwas engeren Regel: Es erscheint nur bei geschlossenem Fenster.

  • Mehrere Antworten, ein Ton

    Kommen mehrere Nachrichten gleichzeitig an, gibt es ein einziges Signal statt eines pro Nachricht.

Von deiner eigenen Seite aus steuern

Der Loader stellt unter window.ProhostWebchat einen kleinen Event-Bus bereit — damit kann deine Website das Chat-Fenster öffnen und auf Vorgänge darin reagieren.

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_startedDie Unterhaltung existiert jetzt — der Besucher hat seine erste Nachricht gesendet. Im payload steht die conversationId.
webchat_message_sentDer Besucher hat eine Nachricht gesendet.
webchat_host_messageEine Antwort deines Teams oder deiner KI ist eingetroffen. Das steuert das Ungelesen-Zeichen und, falls aktiviert, den Ton.

Praktisch in Kombination mit data-hide-mobile: Blende den Standard-Button auf dem Handy aus und öffne das Chat-Fenster stattdessen über deinen eigenen Button. Ereignisse werden nur weitergereicht, wenn sie aus der Prohost-Einbettung stammen, nie von einer anderen Quelle.

Alles in der App verwalten

Name, Begrüßung, Akzentfarbe des Fensters und der Antwortton liegen in der KI-Chat-Widget-App, und jede Website mit deinem Widget übernimmt Änderungen daran von allein. Farbe und Symbol des Chat-Buttons sind anders: Sie stecken im Snippet, also kopiere es nach einer Änderung neu — genau wie nach dem Rotieren deines Embed-Keys.