Integration mit IdoBooking

Verbinden Sie Ihren ChatLab-Chatbot mit Ihrem IdoBooking-Reservierungssystem, um Ihren Website-Besuchern Verfügbarkeitsauskünfte in Echtzeit und Unterstützung bei der Buchung zu bieten.

Beispielunterhaltung

Das Beispiel veranschaulicht das Kundenerlebnis. Die verfügbaren Aktionen und zurückgegebenen Informationen hängen von dieser Integration und Ihrer Konfiguration ab.

Bevor Sie beginnen

Erstellen oder wählen Sie zuerst einen Chatbot aus. Sie benötigen die Berechtigung zur Verwaltung seiner Integrationen sowie Zugriff auf die Verbindungseinstellungen des externen Kontos. Wenn die Connect-Kachel einen Hinweis auf ein Upgrade oder eine Kontaktaufnahme anzeigt, prüfen Sie, ob Ihr Abonnement diese Integration enthält. Halten Sie API-Zugangsdaten geheim; fügen Sie sie niemals in den Website-Embed-Code ein.

Was die Integration bietet

Mit aktivierter IdoBooking-Integration kann Ihr Chatbot:

• Verfügbare Apartments und Unterkünfte mit Beschreibungen und Fotos auflisten
• Die Verfügbarkeit für bestimmte Daten prüfen
• Freie Apartments für einen bestimmten Datumsbereich samt Preisen finden
• Bestehende Reservierungen nach ID, Status oder Datumsbereich abrufen
• Neue Reservierungen mit Gastdaten erstellen

Es gibt zwei Wege, diese Integration einzurichten - über den IdoBooking Marketplace (empfohlen) oder manuell über das ChatLab-Admin-Panel.

---

Option A: Einrichtung über den IdoBooking Marketplace (Empfohlen)

Der schnellste Weg, ChatLab mit IdoBooking zu verbinden, führt über den IdoBooking Marketplace. Diese Methode verarbeitet API-Zugangsdaten automatisch und aktiviert die Lese-Aktionen für Ihren Chatbot.

Schritt 1: ChatLab aus dem IdoBooking Marketplace installieren

1. Melden Sie sich in Ihrem IdoBooking-Administrationspanel an
2. Wechseln Sie in den Bereich Marketplace
3. Suchen Sie nach ChatLab und klicken Sie auf Install (Installieren)

IdoBooking übermittelt Ihre API-Zugangsdaten automatisch an ChatLab - Sie müssen keinen separaten API-Benutzer anlegen oder Zugangsdaten manuell kopieren.

Schritt 2: Ihr ChatLab-Konto erstellen oder anmelden

Nach der Aktivierung von ChatLab im Marketplace werden Sie zu einem Einrichtungsassistenten weitergeleitet. Wenn Sie bereits ein ChatLab-Konto besitzen, melden Sie sich an. Andernfalls erstellen Sie ein neues Konto.

Schritt 3: Wählen Sie einen Abonnement-Plan

Wählen Sie einen Plan, der zu Ihren Anforderungen passt. Die IdoBooking-Buchungsfunktionen (Apartmentsuche, Verfügbarkeitsprüfung, Reservierungen) setzen die IdoBooking-Integrationsfunktion voraus. Wenn Ihr Plan diese nicht enthält, folgen Sie den Hinweisen zum Upgrade oder zur Kontaktaufnahme.

Schritt 4: Chatbot auswählen

Wählen Sie einen bestehenden Chatbot für die Verbindung mit IdoBooking aus oder erstellen Sie einen neuen. Der Assistent kann automatisch einen neuen Bot für Sie anlegen.

Schritt 5: Einrichtung abschließen

Der Assistent führt Folgendes automatisch aus:

• Verbindet Ihre IdoBooking-Zugangsdaten mit dem ausgewählten Chatbot
• Aktiviert die Apartmentsuche, Verfügbarkeitsprüfungen und das Abrufen von Reservierungen. Das Erstellen von Reservierungen wird nicht automatisch aktiviert.
• Leitet Sie zurück zu IdoBooking oder in das ChatLab-Admin-Panel

Nach Abschluss des Assistenten ist Ihr Chatbot bereit für Buchungsanfragen. Sie können einzelne KI-Aktionen unter Settings > Actions (Einstellungen > Aktionen) feinabstimmen.

---

Option B: Manuelle Einrichtung

Wenn Sie die Integration lieber manuell konfigurieren möchten, folgen Sie diesen Schritten.

Teil 1: Einen API-Benutzer in IdoBooking erstellen

Bevor Sie ChatLab mit Ihrem IdoBooking-System verbinden, müssen Sie in Ihrem IdoBooking-Panel einen dedizierten Benutzer mit API-Zugriff anlegen.

Schritt 1: Zur Benutzerverwaltung navigieren

1. Melden Sie sich in Ihrem IdoBooking-Administrationspanel an
2. Gehen Sie zu Settings > Users (Einstellungen > Benutzer)
3. Klicken Sie auf Add new user (Neuen Benutzer hinzufügen)

Schritt 2: Benutzerkonto erstellen

1. Geben Sie einen login name (Anmeldenamen) für den neuen Benutzer ein (z. B. "chatlab-api")
2. Tragen Sie die restlichen erforderlichen Angaben ein
3. Legen Sie ein sicheres password (Passwort) für dieses Konto fest

Schritt 3: API-Zugriff konfigurieren

Konfigurieren Sie folgende Zugriffseinstellungen für den neuen Benutzer:

1. Aktivieren Sie "Active API access" - dies ist für die Funktion der Integration erforderlich
2. Deaktivieren Sie "Active panel access" - der Benutzer benötigt keinen Zugriff auf das Admin-Panel

Schritt 4: Benutzerrolle und Berechtigungen festlegen

Sie haben zwei Optionen für die Konfiguration der Benutzerrolle:

Option A: Administrator-Rolle (Einfacher)

• Wählen Sie Administrator als Rolle aus
• Dies gewährt umfassende API-Berechtigungen, auch wenn der Panel-Zugriff deaktiviert ist. Nutzen Sie eine benutzerdefinierte Rolle, wenn die Integration nur ausgewählte Leseoperationen benötigt.

Option B: Benutzerdefinierte Rolle (Detaillierter)

Wenn Sie eine granularere Kontrolle bevorzugen, wählen Sie Custom user (Benutzerdefinierter Benutzer) und konfigurieren Sie folgende Modulberechtigungen:

• Reservations (Reservierungen) - Read-only (Nur Lesezugriff, wenn der Chatbot nur Reservierungsinformationen abrufen soll) oder Full access (Vollzugriff, wenn der Chatbot Reservierungen erstellen soll)
• Customers (Kunden) - Read-only (Nur Lesezugriff)
• Offers (Angebote) - Read-only (Nur Lesezugriff)

Für benutzerdefinierte Benutzer müssen Sie auch die Standortberechtigungen festlegen:

1. Scrollen Sie zum Bereich Location and accommodation permissions (Standort- und Unterkunfts-Berechtigungen)
2. Wählen Sie die Objekte aus, die dieser Chatbot abdecken soll; gewähren Sie Zugriff auf alle nur dann, wenn dies dem beabsichtigten Umfang entspricht.

Schritt 5: Unnötige Benachrichtigungen deaktivieren

Um zu verhindern, dass der API-Benutzer betriebliche Benachrichtigungen erhält, deaktivieren Sie folgende Optionen:

• Notifications for property staff (Benachrichtigungen für das Objektpersonal) - Deaktivieren
• Automatic email notifications (Automatische E-Mail-Benachrichtigungen) - Deaktivieren

Schritt 6: Speichern und Verbindungsdaten notieren

1. Klicken Sie auf Save (Speichern), um das Benutzerkonto anzulegen
2. Notieren Sie sich folgende Informationen - Sie benötigen sie für die Konfiguration in ChatLab:

• Login - Der von Ihnen erstellte Benutzername (z. B. chatlab-api)
• Password - Das von Ihnen festgelegte Passwort
• Subdomain - Ihre IdoBooking-Subdomain (z. B. client3760)

So finden Sie Ihre Subdomain: Sehen Sie sich die URL Ihres IdoBooking-Panels an. Wenn Ihre URL beispielsweise https://client3760.idosell.com lautet, ist Ihre Subdomain client3760.

Teil 2: Einrichten der Integration in ChatLab

Schritt 1: Zum Tab "Connect" navigieren

1. Melden Sie sich in Ihrem ChatLab-Admin-Panel an
2. Wählen Sie den Bot aus, den Sie konfigurieren möchten
3. Gehen Sie auf den Tab Connect (Verbinden)
4. Suchen Sie in der Integrationsliste nach IdoBooking und klicken Sie darauf

Schritt 2: Verbindungsdaten eingeben

Füllen Sie das Verbindungsformular mit den aus IdoBooking notierten Daten aus:

• Client Subdomain - Geben Sie Ihre IdoBooking-Subdomain ein (ohne die vollständige URL). Beispiel: client3760 (nicht https://client3760.idosell.com)
• System Login - Geben Sie den Benutzernamen des in IdoBooking erstellten API-Benutzers ein
• System Password - Geben Sie das Passwort für den API-Benutzer ein
• Default Currency - Wählen Sie die Währung für Preisangaben aus
• Default Language - Wählen Sie die Sprache für Objektbeschreibungen aus

Schritt 3: Verbinden

1. Nach dem Ausfüllen aller Pflichtfelder wird die Schaltfläche Connect aktiv
2. Klicken Sie auf Connect, um die Verbindung herzustellen
3. Warten Sie auf die Bestätigungsnachricht
4. Sobald die Verbindung steht, sehen Sie eine Erfolgsbenachrichtigung

Nach erfolgreicher Verbindung ändert sich die Schaltfläche von "Connect" zu "Update Chatbot", und eine Schaltfläche "Disconnect" erscheint, falls Sie die Integration später trennen müssen.

---

KI-Aktionen konfigurieren

Sobald Ihre IdoBooking-Integration verbunden ist (über eine der beiden Methoden), können Sie festlegen, welche KI-Aktionen Ihr Chatbot ausführen darf. Prüfen Sie die aktiven Aktionen nach beiden Einrichtungsmethoden. Das Erstellen von Reservierungen ist nicht automatisch aktiviert.

Verfügbare KI-Aktionen

• Get Apartments - Listet verfügbare Apartments und Unterkünfte mit Beschreibungen, Bettenkonfigurationen und Fotos auf
• Find Available Apartments - Sucht nach verfügbaren Apartments für einen bestimmten Datumsbereich inklusive Preisangaben
• Check Apartment Availability - Prüft die Verfügbarkeit für ein bestimmtes Apartment und einen festgelegten Zeitraum
• Get Reservations - Ruft bestehende Reservierungen nach ID, Status oder Datumsbereich ab
• Create Reservation - Erstellt neue Reservierungen mit Gastdaten und Buchungsdetails
• AI room search - Gleicht die Beschreibung der Gastwünsche mit Ihren Zimmerbeschreibungen ab, anstatt Reisedaten zu prüfen

AI room search und Get Apartments sind Alternativen, keine Ergänzungen. Wenn AI room search aktiv ist, ersetzt es das einfache Auflistungs-Tool und Get Apartments wird für den Chatbot deaktiviert, sodass immer nur ein Tool zur Zimmerauflistung aktiv ist. Die datumsbasierten Aktionen bleiben davon unberührt.

Aktionen aktivieren und anpassen

1. Nach dem Verbinden klicken Sie im Erfolgsdialog auf Configure AI Actions (KI-Aktionen konfigurieren) oder navigieren Sie zu Settings > Actions und suchen Sie die Kategorie IdoBooking
2. Schalten Sie die Aktionen um, die Sie aktivieren möchten
3. Passen Sie bei Bedarf die Aktionsbezeichnung (den Text, der Benutzern angezeigt wird, während die Aktion ausgeführt wird) und die Anweisungen an
4. Klicken Sie im Aktionsdialog bei einer neuen Aktion auf Enable (Aktivieren) oder bei einer bestehenden Aktion auf Update (Aktualisieren).

Konfigurieren von "Find available apartments"

Die Aktion Find available apartments verfügt über zwei zusätzliche Optionen, die bestimmen, wie viele Apartments der Chatbot anzeigt, wenn ein Gast nach der Verfügbarkeit fragt, und welche Apartments in die Auswahl aufgenommen werden. Öffnen Sie die Aktion unter Settings > Actions > IdoBooking - find available apartments, um darauf zuzugreifen.

Number of offers to show (Anzahl der anzuzeigenden Angebote)

Ein Schieberegler im Bereich von 3 bis 10 (Standardwert 6). Er steuert, wie viele Apartments der Chatbot dem Benutzer in einer einzelnen Antwort zurückgibt.

• Niedrigere Werte (3-4) halten die Antwort kurz und fokussiert, was praktisch ist, wenn die meisten Gäste sich nur zwischen wenigen Favoriten entscheiden.
• Höhere Werte (8-10) bieten Gästen mehr Auswahl zum Vergleichen, ideal für Unterkünfte mit einem größeren Katalog.

Offer selection strategy (Strategie zur Angebotsauswahl)

Ein Dropdown-Menü, das festlegt, welche Apartments aus der vollständigen Liste der verfügbaren Ergebnisse ausgewählt werden, nachdem nach Datum und Gästeanzahl gefiltert wurde. Vier Optionen stehen zur Verfügung:

• Cheapest offers (Günstigste Angebote, Standard) - gibt die Apartments mit dem niedrigsten Mindestpreis zurück, sortiert vom günstigsten zum teuersten. Geeignet, wenn Gäste preisbewusst sind oder Sie mit den zugänglichsten Optionen beginnen möchten.
• Evenly distributed by price (Gleichmäßig nach Preis verteilt) - wählt Apartments aus, die gleichmäßig über die Preisspanne verteilt sind. Bei 9 Angeboten erhalten Sie so beispielsweise etwa 3 günstige, 3 mittelpreisige und 3 exklusivere. Nützlich, wenn Gäste die gesamte verfügbare Bandbreite sehen sollen statt nur das Budget-Segment.
• Most expensive offers (Teuerste Angebote) - gibt die hochpreisigsten Apartments zurück, sortiert vom teuersten zum günstigsten. Ideal für Premium-Unterkünfte oder wenn Sie Ihr gehobenes Portfolio in den Vordergrund stellen möchten.
• Random selection (Zufällige Auswahl) - wählt nach dem Zufallsprinzip Apartments aus den gefilterten Ergebnissen aus. Nützlich, wenn Sie die hervorgehobenen Apartments zwischen verschiedenen Unterhaltungen variieren und vermeiden möchten, dass immer dieselben empfohlen werden.

Beide Einstellungen werden pro Bot gespeichert, zusammen mit dem bestehenden benutzerdefinierten Prompt und der Aktionsbezeichnung.

---

Die fertige Einrichtung testen

Öffnen Sie Overview (Übersicht) und starten Sie eine neue Testunterhaltung. Fragen Sie nach Zimmern für einen zukünftigen Datumsbereich und eine bestimmte Gästeanzahl, öffnen Sie anschließend den zurückgegebenen Buchungslink und vergleichen Sie Reisedaten, Währung und Preis mit IdoBooking. Testen Sie das Abrufen von Reservierungen mit einer Buchung, zu deren Einsicht Sie autorisiert sind. Aktivieren und testen Sie Create Reservation nur dann, wenn Sie eine echte Buchung anlegen möchten; ein Chottest kann Schreibvorgänge in Ihrem Buchungssystem auslösen.

Best Practices

Sicherheitsempfehlungen (Manuelle Einrichtung)

• Dedizierten API-Benutzer verwenden - Erstellen Sie einen separaten Benutzer speziell für die ChatLab-Integration, anstatt Ihr persönliches Administratorkonto zu nutzen
• Minimale Berechtigungen vergeben - Weisen Sie nur die für Ihren Anwendungsfall notwendigen Rechte zu. Nutzen Sie den Nur-Lese-Zugriff, wenn der Chatbot lediglich Informationen abrufen soll
• Regelmäßiger Wechsel der Zugangsdaten - Aktualisieren Sie in regelmäßigen Abständen das Passwort des API-Benutzers und hinterlegen Sie die neuen Daten anschließend in ChatLab

Antworten des Chatbots optimieren

• Trainieren Sie Ihren Bot mit Unterkunftsdaten - Fügen Sie der Wissensdatenbank Beschreibungen Ihrer Unterkünfte hinzu, einschließlich Ausstattungsmerkmalen, Zimmerbesonderheiten und Lageangaben
• Klare Gesprächsabläufe definieren - Richten Sie Willkommensnachrichten ein, die Benutzer zur Verfügbarkeitsabfrage leiten, und nutzen Sie vorgeschlagene Fragen wie "Verfügbarkeit prüfen" oder "Zimmer ansehen"

---

Fehlerbehebung

• Verbindung schlägt fehl - Prüfen Sie, ob "Active API access" für den Benutzer in IdoBooking aktiviert ist
• Fehlermeldungen wie "Access denied" - Überprüfen Sie, ob der Benutzer über die korrekten Modulberechtigungen verfügt
• Keine Daten zurückgegeben - Stellen Sie sicher, dass der Benutzer Zugriff auf die relevanten Standorte und Unterkünfte hat
• Falsche Subdomain - Prüfen Sie Ihre IdoBooking-URL und extrahieren Sie ausschließlich den Subdomain-Teil (z. B. client3760 aus https://client3760.idosell.com)

---

Zimmerkatalog und Hotelübersicht

Wenn Ihr Konto den Tab Hotel anzeigt, verwenden Sie Hotel > Rooms (Hotel > Zimmer), um den Zimmerkatalog und den Trainingsstatus zu prüfen. AI room search ist von datumsbasierten Verfügbarkeitsprüfungen getrennt: Es gleicht Zimmerbeschreibungen ab, während Verfügbarkeitsaktionen einen angefragten Aufenthalt prüfen. Die automatische Zimmerindizierung hängt von der automatischen Katalogindizierung und der zugewiesenen Zimmerkapazität ab; andernfalls nutzen Sie Train rooms (Zimmer trainieren), sofern verfügbar. Überprüfen Sie die aktivierten Aktionen und warten Sie das Ende des Trainings ab, bevor Sie sich auf AI room search verlassen.

Verwandte Artikel

• Chatbot zu Ihrer Website hinzufügen
• Ihren Chatbot trainieren
• Einen Link zu Ihrem Chatbot senden