Widget

Auf der Seite Widget legen Sie fest, wie der Chat-Bildschirm aussieht und sich verhält, wenn Gäste mit Mira sprechen. Hier verwalten Sie den Link, den Sie an Gäste weitergeben, den Code für Ihre Website und den Begrüßungsbildschirm des Chats. Die Informationen, die Mira gibt (Zeiten, Regeln usw.), stehen nicht auf dieser Seite, sondern auf der Seite Business Info.

Was Sie auf dem Bildschirm sehen#

Wenn Sie im linken Menü auf Widget klicken, sehen Sie oben ein Label WIDGET & CHAT SETTINGS, den Titel Widget und eine kurze Beschreibung. Darunter folgen aufklappbare Boxen (Abschnitte). Sie können jede Box öffnen oder schließen, indem Sie auf ihren Titel klicken. Auf dem Computer gibt es links das Menü On this page; ein Klick auf den Namen einer Box scrollt die Seite zu dieser Box und öffnet sie (Panel-Übersicht).

In den Boxen nur für Pro (5, 6, 7, 8) zeigt ein Basic-Tarif Folgendes: ein Badge PRO im Boxtitel, eine gelbe Warnung in der Box (zum Beispiel „Changing the assistant's name/photo is a Pro feature.") und einen Link Upgrade to Pro. Die Felder sind ausgegraut und nicht anklickbar, und die Schaltfläche Save Changes ist ausgeblendet. Zu den Tarifen siehe Konto und Tarife.

Wenn Sie eine Box speichern, erscheint oben eine grüne Bestätigung (ihr Text lautet ✓ Business info updated successfully.; die Seite Widget verwendet dieselbe Meldung).

Schritt für Schritt: das Widget einrichten#

Beispiel: „Blue Bay Hotel", ein Hotel mit 30 Zimmern, hat eine eigene Website und möchte den Chat dort einbinden.

1. Öffnen Sie Widget und sehen Sie sich die Box Live Preview an. Sie sehen Ihre Assistentin in einer nachgebildeten Website, genau so, wie sie auf Ihrer eigenen Seite aussehen wird. Nach etwa 1,5 Sekunden erscheint über dem Chat-Symbol eine kleine Begrüßungsblase. Klicken Sie auf das Symbol und probieren Sie ein paar Fragen aus.
2. Wählen Sie in der Box Website Widget die Position (Right (center), Left (center), Bottom right, Bottom left) und drücken Sie Save.
3. Drücken Sie in derselben Box Copy Code (zwei Sekunden lang zeigt die Schaltfläche Copied ✓) und fügen Sie den Code in Ihre Website ein. Wie das geht, steht unter Installation auf Ihrer Website und Guest Link.
4. (Pro) Geben Sie Ihrer Assistentin in AI Receptionist Identity einen eigenen Namen und ein eigenes Foto.
5. (Pro) Schreiben Sie Greeting Bubble und Custom Welcome Message passend zu Ihrem Betrieb.
6. Fügen Sie die 3-5 Fragen, die Gäste am häufigsten stellen, zu Guided Suggestion Chips hinzu.
7. Entscheiden Sie sich bei Direct Booking Banner und Pricing Visibility.
8. (Optional) Sobald Sie den Code in Ihre Website eingefügt haben und er funktioniert, geben Sie in der Box Domain Security die Domain bluebayhotel.com ein, haken Enable domain security an und speichern. So kann eine andere Website, die Ihren Code kopiert, Ihren Chat nicht verwenden.
9. Nach jeder Änderung lädt die Seite neu und die Live Preview wird automatisch aktualisiert; prüfen Sie dort das Ergebnis.

Feld für Feld#

Live Preview#

Eine Vorschau, die mit Ihrem echten Widget-Code und Ihren echten Einstellungen läuft: Ihre Assistentin sitzt in einer Seite, die aussieht wie „die Website Ihres Betriebs". Die Titelleiste zeigt den Namen Ihres Betriebs (und Ihr Logo, falls vorhanden), rechts eine Sprachauswahl (🇹🇷 Türkçe, 🇬🇧 English, 🇩🇪 Deutsch, 🇷🇺 Русский) mit einer kleinen Schaltfläche ➜ daneben. Wenn Sie eine Sprache wählen und ➜ drücken, lädt die Vorschau in dieser Sprache neu, sodass Sie Ihre Assistentin in allen vier Sprachen ausprobieren können. Die Vorschau startet in Ihrer Default Language.

Der Link Open in new tab ↗ oben rechts öffnet die Vorschau in einem größeren Tab. Die Vorschau lädt mit frischen Daten neu, wann immer Sie eine Box speichern (bei jedem Neuladen der Seite). Sie aktualisiert sich nicht während des Tippens.

Guest Link#

Wenn ein Gast ihn zum ersten Mal öffnet, sieht er zuerst ein Fenster Terms & Conditions. Dieses Fenster ist für alle Betriebe gleich und kann im Panel nicht geändert werden: Es hat oben rechts eine Sprachauswahl (TR / EN / DE / RU), unter der Überschrift Terms and Conditions vier Punkte (dass die Antworten von einer KI erzeugt werden, dass Gespräche aufgezeichnet werden können, dass sensible Daten wie Kreditkartendaten nicht im Chat geteilt werden sollen und dass Fortfahren die Annahme der Bedingungen bedeutet) sowie die Schaltflächen Decline und Accept & Continue. Ein Gast, der Accept & Continue drückt, sieht das Fenster im selben Browser nicht wieder. Decline schließt das Fenster ebenfalls, und der Gast kann weiterchatten; da die Wahl aber nicht gespeichert wird, erscheint das Fenster beim nächsten Öffnen des Chats erneut.

Auch wenn Sie Ihr Panel im dunklen Design nutzen, öffnet sich der Chat-Bildschirm, den Ihre Gäste sehen (Guest Link, Website-Widget und Zimmer-QR), immer im hellen Design; Ihr Panel-Design wird nie an Gäste weitergegeben.

Wenn Sie an den Link etwas wie ?lang=en anhängen, können Sie den Chat in der gewünschten Sprache starten (tr, en, de, ru). Einzelheiten finden Sie unter Installation auf Ihrer Website und Guest Link.

Install App on Phone#

Diese Box dient nur zur Information; Sie müssen nichts einstellen. Gäste, die den Guest Link öffnen, sehen oben rechts auf dem Chat-Bildschirm eine Schaltfläche Install App (auf einem schmalen Bildschirm nur das Handy-Symbol). Unter Android / Chrome installiert das Antippen der Schaltfläche sofort und legt eine Verknüpfung zu Mira auf dem Startbildschirm des Telefons an. Unter iPhone / Safari öffnet die Schaltfläche, weil Apple keine automatische Installation unterstützt, eine kurze Anleitung mit den Schritten Share → Add to Home Screen.

Website Widget#

Hier sehen Sie den einzeiligen Code, den Sie in Ihre Website einfügen, und die Position des Widgets.

Um die Position zu ändern, müssen Sie den Code nicht erneut kopieren: Die Position wird auf dem Server gespeichert, und das Widget liest sie bei jedem Öffnen. Eine Änderung erreicht die Besucher Ihrer Website nach spätestens etwa 1 Minute (Widget-Einstellungen werden kurz zwischengespeichert).

Brand Colors (Pro)#

Färbt den Gast-Chat-Bildschirm und die Chat-Blase auf Ihrer Website in Ihren eigenen Markenfarben ein. Sie wählen nur zwei Farben; hellere Töne, Hover-Farben und Textfarben werden automatisch daraus abgeleitet.

1. Öffnen Sie die Box Brand Colors.
2. Klicken Sie auf die Felder Main color und Dark color und wählen Sie Ihre Farbe im Farbwähler (oder geben Sie den Farbcode ein).
3. Drücken Sie Save Changes. Die Seite lädt neu, und die Box bleibt geöffnet.
4. Prüfen Sie in der Live Preview die neuen Farben der Chat-Blase und des Fensters.

• Die Textfarbe auf den Schaltflächen (weiß oder dunkel) wird je nach gewählter Farbe automatisch bestimmt; wählen Sie eine sehr helle Hauptfarbe, wird die Schrift auf den Schaltflächen dunkel.
• Die neuen Farben erscheinen im Guest Link sofort und in der Blase auf Ihrer Website nach spätestens etwa 1 Minute. Sie müssen den Code auf Ihrer Website nicht ändern.
• Dieselben Farben gelten auch für das Panel selbst: Schaltflächen, der aktive Link im linken Menü, Links und der Hintergrund des linken Menüs erscheinen in Ihren Farben. Alle Teammitglieder sehen das Panel in diesen Farben.
• Wechselt der Tarif zurück zu Basic, werden die gespeicherten Farben nicht gelöscht, aber nicht mehr verwendet; der Chat-Bildschirm kehrt zu den Standardfarben zurück.

AI Receptionist Identity (Pro)#

Der Standardname der Assistentin ist Mira. Um sich von anderen Airoomier-Betrieben in Ihrer Gegend abzuheben, können Sie ihr einen eigenen Namen und ein eigenes Foto geben. Wenn Sie es leer lassen, ändert sich nichts.

Name und Foto werden verwendet in: dem Titel des Chat-Bildschirms („Selin · Digitale Rezeptionistin"), dem runden Foto auf dem Begrüßungsbildschirm und dem Satz „Hallo, willkommen! Ich bin Selin.", Miras Antwort, wenn ein Gast fragt „Wer sind Sie?", dem schwebenden Blasen-Symbol auf Ihrer Website sowie dem Namen/Symbol der Startbildschirm-Verknüpfung, die ein Gast auf seinem Telefon anlegt. Wenn Sie ein falsches Format oder eine Datei über 2 MB hochladen, schlägt das Speichern mit einem Fehler fehl.

Greeting Bubble (Pro)#

Diese Box gilt für Ihre Website: Sie passen die kleine Blase an, die über dem Chat-Symbol erscheint, wenn ein Besucher auf Ihre Website kommt. Es ist die Blase, die vor dem Öffnen des Chats angezeigt wird, und sie unterscheidet sich von der Begrüßungsnachricht, die bei geöffnetem Chat erscheint (die nächste Box).

Bei Feldern, die Sie leer lassen, wird die Standardblase verwendet („Hallo, ich bin Mira — Ihre KI-Rezeption! 👋 / Fragen Sie mich gern alles zu Ihrem Aufenthalt."). Wenn der Titel leer ist, greift nur beim Titel der Standard; wenn die Beschreibung leer ist, nur bei der Beschreibung. Ihr Text wird in Ihrer Inhaltssprache geschrieben und automatisch ins Englische/Deutsche/Russische übersetzt; der Besucher sieht die Version in der Sprache Ihrer Website. Die Blase erscheint etwa 1,5 Sekunden nach dem Öffnen der Seite und wird pro Seitenaufruf einmal angezeigt; ✕ schließt sie, und ein Klick auf die Blase öffnet den Chat.

Custom Welcome Message (Pro)#

Sie passen den Begrüßungstext in der Mitte des Bildschirms an, den ein Gast sieht, wenn er den Chat zum ersten Mal öffnet. Er erscheint sowohl im Guest Link als auch im Widget auf Ihrer Website.

Die Texte werden in Ihrer Inhaltssprache geschrieben und automatisch in die anderen Sprachen übersetzt. Wenn es in der gewählten Sprache keinen Text gibt, wird für diese Sprache der Standardsatz angezeigt. Wenn beide Felder leer bleiben, bedeutet das „Standardtexte verwenden".

Guided Suggestion Chips#

Das sind antippbare Beispielfragen, die ein Gast auf dem Begrüßungsbildschirm sieht, bevor er etwas eingibt. Eine angetippte Frage wird so gesendet, als hätte der Gast sie getippt, und Mira antwortet.

Wenn das Hinzufügen gelingt, sehen Sie „✓ Suggestion chip added and translated into English/German/Russian." Wenn einige Sprachen fehlgeschlagen sind, sehen Sie „✓ Suggestion chip added, but some translations failed. ..." und der Originaltext des Chips wird in diesen Sprachen angezeigt. Wenn das Limit erreicht ist, ersetzen eine Warnung und ein Link Upgrade to Pro das Eingabefeld („⚠️ On Basic, you can add up to 3 suggestion chips. Upgrade to Pro for more.").

Wenn Sie keine Chips hinzufügen (und Show suggestion chips angehakt ist), wird ein allgemeiner Standardsatz angezeigt: Pet policy, Breakfast, Airport transfer. Chips erscheinen nur auf dem ersten (leeren) Bildschirm des Chats und verschwinden nach der ersten Nachricht.

Direct Booking Banner#

Domain Security#

Der Code, den Sie in Ihre Website einfügen, ist öffentlich: Jemand kann ihn aus dem Quelltext Ihrer Website kopieren, in seine eigene Website einfügen und so Ihre Assistentin (und Ihr monatliches KI-Gesprächskontingent) auf seiner Website nutzen. Diese Box sorgt dafür, dass sich der Chat nur auf den von Ihnen aufgeführten Domains öffnet. Sie ist standardmäßig aus und funktioniert in Basic und Pro gleich.

Wenn Sie das Feld ausfüllen und Save Changes drücken, wird Ihre Eingabe nach diesen Regeln bereinigt und gespeichert. Nach dem Speichern zeigt das Feld die gespeicherte Fassung; ist eine Zeile verschwunden, wurde sie als ungültig gewertet.

Wenn Sie dieselbe Domain zweimal eingeben, wird sie einmal gespeichert.

Wie funktioniert das? Wenn ein Besucher auf Ihrer Website auf die Chat-Blase klickt, öffnet sich der Chat in einem Fenster (iframe), und der Browser übermittelt, welche Website ihn geöffnet hat. Steht diese Website nicht in der Liste, öffnet sich der Chat nicht. Auf einer gesperrten Website sieht der Besucher Folgendes: Blase und Begrüßungsblase erscheinen weiterhin, aber beim Klick auf die Blase zeigt das geöffnete Panel statt des Chats eine dunkle Box mit der Überschrift „Bu site için yetkilendirilmemiş" und dem Satz „Bu AI asistanı bu alan adında kullanıma açık değil." („Für diese Website nicht autorisiert" / „Dieser KI-Assistent ist auf dieser Domain nicht verfügbar"). Diese Meldung wird unabhängig von der Sprache des Besuchers auf Türkisch angezeigt.

Von dieser Einstellung nicht betroffen sind:

• Der Guest Link und die Zimmer-QR-Codes funktionieren immer, wenn sie direkt geöffnet werden, zum Beispiel aus WhatsApp, per SMS, durch Scannen eines QR-Codes oder durch Eintippen der Adresse.
• Die Live Preview auf dieser Seite und die Vorschau über Open in new tab ↗ funktionieren immer (weil sie von Airoomiers eigener Adresse aus geöffnet werden).

Pricing Visibility#

Solange diese Einstellung an ist, enthalten auch Miras Klartext-Antworten keine numerischen Preise; der Preis bleibt verborgen (ein Label „Price hidden"), und das System gibt der KI die Preiswerte erst, wenn eine Nummer angegeben wurde. Nachdem eine Nummer angegeben wurde, erscheinen Preise sowohl auf Karten als auch in schriftlichen Antworten normal.

Airoomier Branding#

Eine reine Informations-Box. Die Zeile „Powered by Airoomier · Verified Business Information" am unteren Rand des Chat-Bildschirms wird derzeit sowohl im Basic- als auch im Pro-Tarif angezeigt und kann nicht entfernt werden.

Preiskalender (Gästeseite)#

Diese Box hat keine Einstellungen; sie dient nur zur Information. Wenn ein Gast im Chat im Formular Wählen Sie Ihren Aufenthalt auf das Anreise- oder Abreisefeld tippt, öffnet sich ein Kalender:

• Unter jedem Tag steht der niedrigste Preis pro Nacht unter den in dieser Nacht verfügbaren Unterkunftstypen (berechnet aus den Preisplänen in Room Types).
• Tage, für die ein Last-Minute- oder Frühbucherrabatt aus den Preisregeln gilt, sind mit einem türkisfarbenen Preis und einem kleinen Punkt markiert.
• Tage, an denen alle Typen ausgebucht sind, sind durchgestrichen und können nicht als Anreisedatum gewählt werden. Das Abreisedatum kann nicht über die erste ausgebuchte Nacht nach der Anreise hinaus gewählt werden.
• Der Gast tippt zuerst auf den Anreisetag, dann auf den Abreisetag; der Kalender schließt sich und die Daten werden in das Formular übernommen.
• Ist Pricing Visibility eingeschaltet und hat der Gast seine Telefonnummer noch nicht geteilt, zeigt der Kalender keine Preise, sondern nur die verfügbaren Tage.
• Der Kalender berücksichtigt die vom Gast gewählte Personenzahl: Typen mit zu geringer Kapazität werden nicht mitgezählt.

Was danach passiert#

• Wenn Sie eine Box speichern, lädt die Seite neu und die Live Preview lädt mit den neuesten Daten neu.
• Im Chat über den Guest Link (Begrüßungsbildschirm, Name/Foto der Assistentin, Chips, Banner, Preissperre) werden Änderungen sofort sichtbar.
• Im Widget auf Ihrer Website erreichen Änderungen an Position, Blase und Assistentensymbol die Besucher nach spätestens etwa 1 Minute. Wenn Ihre Website ein Caching-Plugin/CDN hat, kann sich das so lange verzögern, wie dieses den Code vorhält.
• Änderungen an Domain Security greifen, sobald ein Besucher das nächste Mal das Chat-Panel auf Ihrer Website öffnet; Sie müssen den Code auf Ihrer Website nicht ändern.
• Wenn Sie von Pro zu Basic wechseln, werden die Texte, die Sie in den Pro-Boxen geschrieben haben, nicht gelöscht, aber Gästen nicht angezeigt; stattdessen erscheinen die Standardtexte. Sie kommen zurück, wenn Sie wieder zu Pro wechseln.

Tipps und häufige Fehler#

• Boxen einzeln speichern: Das Speichern einer Box lädt die Seite neu; nicht gespeicherter Text in anderen Boxen geht verloren.
• In Ihrer Inhaltssprache schreiben: Schreiben Sie Begrüßungsnachricht, Blasen- und Chip-Texte in der Content language, die in Business Info eingestellt ist; die anderen Sprachen werden automatisch übersetzt.
• Keine langen Texte schreiben: Wenn die Limits (40, 60, 80, 200, 300 Zeichen) überschritten werden, wird der Überschuss stillschweigend abgeschnitten.
• Blase und Assistentenfoto erscheinen nicht auf Ihrer Website? Sie brauchen den Pro-Tarif, gespeicherte Inhalte und kein data-position im Code auf Ihrer Website. Siehe Installation auf Ihrer Website und Guest Link.
• Chat öffnet sich nach dem Einschalten von Domain Security nicht auf Ihrer Website? Prüfen Sie, ob die Domain Ihrer Website in der Liste steht und richtig geschrieben ist (sehen Sie sich die gespeicherte Fassung an). Wenn Sie Ihre Website auch unter einer anderen Adresse veröffentlichen (zum Beispiel einer separaten Buchungsdomain oder einer temporären Testadresse), fügen Sie auch diese Domain hinzu. Einzelheiten: Installation auf Ihrer Website und Guest Link.
• Chip-Limit erreicht? Sie können einen alten löschen und einen neuen hinzufügen oder auf Pro upgraden.
• Nutzung im Zimmer: Um den Chat eines Gastes mit einem bestimmten Zimmer zu verknüpfen, verwenden Sie den Zimmer-QR; siehe Room Types und Guest Requests.