> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dialogshift.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Protel / Planet Integration

> Wie du Protel/Planet mit DialogShift für Buchungsagenten und Journey Messaging nutzt.

Die Protel/Planet-Integration verbindet DialogShift mit der Protel Cloud API. Chat AI und Phone AI können Verfügbarkeiten und Raten abrufen und Pay-at-Hotel-Buchungen direkt anlegen. Journey Messaging kann zusätzlich PMS-Daten aus Protel/Planet nutzen.

<Note>
  **Closed Beta Rollout:** Diese Integration ist noch nicht allgemein für den produktiven Einsatz freigegeben. Die Aktivierung erfolgt nur abgestimmt mit Customer Success.
</Note>

## Voraussetzungen

* Dein Hotel nutzt Protel/Planet Cloud API.
* API-Key und API-Base-URL sind vorhanden.
* Für Journey Messaging ist zusätzlich der passende PMS-Kontext für dein Hotel bekannt.

## Integration aktivieren

Da es eine Protel/Planet-Integrationsseite in der DialogShift App gibt, kann das Hotel die Zugangsdaten selbst eintragen. Für Journey Messaging stimmt Customer Success zusätzlich den PMS-Kontext ab.

1. Trage API-Key und Base-URL in der DialogShift App ein.
2. Aktiviere die Protel/Planet-Integration.
3. Gib bei Booking-Agent-Nutzung nur Zimmertypen und Raten frei, die ohne Vorauszahlung direkt buchbar sind.
4. Für Journey Messaging richtet Customer Success den PMS-Kontext ein.

## Buchungsagenten

| Thema                                | Verhalten                                                                                            |
| :----------------------------------- | :--------------------------------------------------------------------------------------------------- |
| Company-Code / Coupons / Rabattcodes | Nicht unterstützt.                                                                                   |
| Mindestaufenthalt im Dialog          | Nicht explizit durch DialogShift kommuniziert.                                                       |
| Checkout-Workflow                    | Direkte Buchung in Protel/Planet, ohne DialogShift-Checkout-Link.                                    |
| Payment-Link im Chat                 | Nicht unterstützt.                                                                                   |
| Payment-Link im Phone                | Nicht unterstützt.                                                                                   |
| Stornierung unbezahlter Buchungen    | Nein. Bei technischem Teilfehler während einer Mehrzimmer-Buchung versucht DialogShift ein Rollback. |
| Zahlungsvarianten                    | Nur Pay-at-Hotel/Flexi-Raten. Prepaid-Raten sollten nicht für den Agenten freigegeben werden.        |
| Angebots-/Quote-Funktion             | Nein.                                                                                                |
| Benötigte Gastdaten                  | E-Mail, Vorname und Nachname sind Pflicht. Telefonnummer ist optional.                               |

## Konfiguration Buchungsagenten

**Zimmertypen.** Zimmertypen sind konfigurierbar, damit der Agent nur Kategorien direkt in Protel/Planet bucht, die für den Dialog geeignet sind. Gib nur öffentliche, verfügbare Kategorien frei.

**Raten.** Raten sind konfigurierbar, weil Protel/Planet über DialogShift nur direkte Pay-at-Hotel-Buchungen unterstützt. Gib ausschließlich Flexi- oder Pay-at-Hotel-Raten frei und schließe Prepaid- oder zahlungspflichtige Raten aus.

## Journey Messaging

| Thema          | Verhalten                                                                                                 |
| :------------- | :-------------------------------------------------------------------------------------------------------- |
| Unterstützt    | Beta. Protel/Planet kann Journey Messaging mit Buchungs- und Gästedaten versorgen.                        |
| Datenfluss     | DialogShift liest Reservierungen regelmäßig aus Protel/Planet.                                            |
| Aktualisierung | Polling, ungefähr alle 15 Minuten. Änderungen sind deshalb nicht sofort sichtbar.                         |
| Aktivierung    | Die Zugangsdaten können in der DialogShift App gepflegt werden; Customer Success ergänzt den PMS-Kontext. |

## Konfiguration

Journey-Messaging-Flows und Vorlagen pflegst du separat unter **Journey Messaging**.