> ## 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.

# MEWS Integration

> Wie du MEWS mit DialogShift für Buchungsagenten und Journey Messaging nutzt.

Die MEWS-Integration verbindet DialogShift mit deinem MEWS-Property. Sie kann Buchungsagenten in Chat und Telefon mit Verfügbarkeiten, Raten und Buchungsmöglichkeiten versorgen und zugleich Journey Messaging mit Buchungs- und Gästedaten speisen.

## Voraussetzungen

* Dein MEWS-Property ist über die [DialogShift-Chatbots-Integration im MEWS Marketplace](https://www.mews.com/en/products/marketplace/dialogshift-chatbots) mit DialogShift verbunden.
* Die Anbindung ist eingerichtet; das dauert in der Regel 12 bis 48 Stunden.
* Terminologie: Was im Hotelalltag „Zimmertyp" heißt, ist in Mews eine **Space category**; ein einzelnes Zimmer ist ein **Space**.

## Integration aktivieren

Die MEWS-Verbindung wird über den MEWS Marketplace gestartet. Da es zusätzlich eine MEWS-Integrationsseite in der DialogShift App gibt, kann das Hotel die Booking-Agent-Konfiguration dort selbst pflegen.

1. Starte die DialogShift-Chatbots-Integration im MEWS Marketplace.
2. Warte, bis die MEWS-Verbindung eingerichtet ist.
3. Pflege die Booking-Agent-Konfiguration in der DialogShift App unter **Integrationen → MEWS**.
4. Prüfe die freigegebenen Kategorien, Raten und Inhalte im DialogShift Availability Analyzer.

## Buchungsagenten

| Thema                                | Verhalten                                                                                                                      |
| :----------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- |
| Company-Code / Coupons / Rabattcodes | Nicht unterstützt. Gib keine Firmen-, Gruppen- oder Personalraten für den Agenten frei.                                        |
| Mindestaufenthalt im Dialog          | Ja. Wenn MEWS nur Mindestaufenthalte meldet, kommuniziert der Agent die Mindestnächte.                                         |
| Checkout-Workflow                    | Direkte Einbuchung in MEWS. Je nach Ratenkonfiguration erstellt DialogShift danach eine MEWS-Zahlungsanforderung.              |
| Payment-Link im Chat                 | Je nach Einstellung gibt DialogShift den MEWS-Zahlungslink im Chat aus oder MEWS verschickt die Zahlungs-E-Mail selbst.        |
| Payment-Link im Phone                | Je nach Einstellung sendet DialogShift den MEWS-Zahlungslink per SMS/WhatsApp oder MEWS verschickt die Zahlungs-E-Mail selbst. |
| Stornierung unbezahlter Buchungen    | Ja. Unbezahlte Zahlungslink-Buchungen können nach Ablauf der konfigurierten Zahlungsfrist automatisch storniert werden.        |
| Zahlungsvarianten                    | Zahlung beim Check-in, Vorauszahlung (`Payment`) und Kreditkarten-Garantie (`Preauthorization`).                               |
| Angebots-/Quote-Funktion             | Nein.                                                                                                                          |
| Benötigte Gastdaten                  | Vorname, Nachname und eine erreichbare Kontaktangabe. MEWS akzeptiert Buchungen auch mit Mobilnummer statt E-Mail-Adresse.     |

## Zahlungslinks und Gästekontakt

Für Raten mit Vorauszahlung oder Kreditkarten-Garantie erstellt DialogShift nach der Buchung eine MEWS-Zahlungsanforderung. Auf der MEWS-Integrationsseite steuerst du:

* **Zahlungsfrist (Stunden):** wie lange der Gast Zeit hat, die Zahlung oder Kartenprüfung abzuschließen.
* **Zahlungslink-Zustellung:** ob DialogShift den MEWS-Zahlungslink an den Gast weitergibt oder MEWS die Zahlungs-E-Mail selbst verschickt.
* **MEWS-Buchungsbestätigung unterdrücken:** ob MEWS keine eigene Buchungsbestätigungs-E-Mail senden soll.
* **Phone AI Gästekontakt:** ob die Phone AI E-Mail-Adresse oder Mobilnummer abfragt.
* **Sicherstellen, dass jede Buchung eine E-Mail-Adresse hat:** wenn die Phone AI keine E-Mail-Adresse abfragt, kann DialogShift zusätzlich eine Relay-E-Mail-Adresse für die Buchung erstellen.

Direkt bestätigte Buchungen ohne Zahlungslink erhalten ihre Buchungsbestätigung von MEWS per E-Mail, sofern diese nicht unterdrückt wurde.

Wenn die Phone AI nur eine Mobilnummer abfragt und keine Relay-E-Mail-Adresse erstellt wird, muss DialogShift den Zahlungslink zustellen. MEWS kann in diesem Fall keine Zahlungs-E-Mail an den Gast senden.

## Konfiguration Buchungsagenten

### Schritt 1 — Zimmerkategorien für den Agenten freigeben

**Warum.** Der Agent verkauft nur Zimmer, die du freigegeben hast. Bleibt die Liste leer, gelten alle in MEWS angelegten Space categories als verkäuflich – auch Personalzimmer, Long-Stay-Kategorien oder Veranstaltungsflächen.

**Wo.** DialogShift: **Integrationen → MEWS → Zimmerkategorien**. Setze bei jeder Kategorie ein Häkchen, die der Agent verkaufen darf.

**Prüfen.** Die Liste wird live aus MEWS geladen. Fehlt eine Kategorie, lege sie in MEWS an und lade die Seite neu.

### Schritt 2 — Raten für den Agenten freigeben

**Warum.** Wie Schritt 1, nur für Raten. Bleibt die Liste leer, sind alle aktiven Raten freigeschaltet. Gib nur deine öffentlichen Raten frei (keine Firmen-, Gruppen- oder Personalraten).

**Wo.** DialogShift: **Integrationen → MEWS → Raten**. Wähle die freizugebenden Raten aus.

**Prüfen.** Auch die Raten werden live aus MEWS geladen; private und inaktive Raten werden gekennzeichnet angezeigt.

### Schritt 3 — Verfügbarkeiten und Aufenthaltsregeln in MEWS öffnen

**Warum.** Der Agent kann nur verkaufen, was MEWS als verfügbar zurückmeldet. Geblockte Zeiträume, Mindestaufenthaltsregeln oder „Closed to arrival" führen korrekt zu „keine Zimmer verfügbar".

**Wo (Mews Operations).**

* Restriktionen (Mindest-/Höchstaufenthalt, Anreisesperren): **Settings → Services → \[dein buchbarer Service] → Restrictions**.
* Tagesgenaue Verfügbarkeit: **Reports → Availability & occupancy report → Adjust**.

**Prüfen.** Wähle einige repräsentative Termine in den nächsten 6 bis 12 Monaten und stelle sicher, dass die freigegebenen Kategorien und Raten offen und buchbar sind. Die End-to-End-Prüfung folgt in Schritt 7.

### Schritt 4 — Beschreibung für jede Space category in jeder Gastsprache hinterlegen

**Warum.** Der Agent liest das Feld **Description** der Space category aus MEWS. Nur englische Beschreibungen werden live übersetzt; pflegst du jede Sprache selbst, behältst du die Kontrolle über die Begriffe. Mews übersetzt diese Felder nicht automatisch.

**Wo (Mews Operations).** **Settings → Services → \[buchbarer Service] → Space categories → \[Kategorie]**. Über **Add translation** eine Sprache hinzufügen, **Name**, **Short name** und **Description** ausfüllen, speichern.

**Was hinein gehört (4–8 Sätze):** eine kurze Einleitung, dann die harten Fakten – maximale Belegung, Bettenkonfiguration, Zimmergröße, Aussicht, Etage/Lage, Bad, Außenbereich, wesentliche Ausstattung, Barrierefreiheit.

**Prüfen.** Schritt 7.

### Schritt 5 — Beschreibung für jede Rate in jeder Gastsprache hinterlegen

**Warum.** Der Agent erläutert über die **Description** der Rate, was enthalten ist, wie die Stornobedingungen lauten und ob eine Anzahlung fällig wird. Pflegst du jede Sprache selbst, behältst du die Kontrolle über die Begriffe.

**Wo (Mews Operations).** **Settings → Services → \[buchbarer Service] → Rates → \[Rate] → Edit**. Über **Add translation** eine Sprache hinzufügen und die **Description** eintragen.

**Was hinein gehört (jeden Punkt ausdrücklich nennen, auch wenn die Antwort „nein" lautet):** Verpflegung, Stornobedingungen (Frist und Gebühren), Anzahlung/Vorauszahlung bei Buchung.

**Prüfen.** Schritt 7.

### Schritt 6 — Bilder für jede Space category hochladen

**Warum.** Der Chat-Agent zeigt ein Karussell mit Zimmerbildern. Eine Space category ohne Bilder erscheint ohne Foto, was die Conversion senkt.

**Wo (Mews Operations).** Derselbe Bildschirm wie in Schritt 4 (**Space categories → \[Kategorie]**), Bereich Bild-Upload.

**Vorgaben:** 4–6 Bilder pro Kategorie, Querformat, mindestens **1920 × 1080 Pixel**, Hauptmotiv mittig. Das **zuerst** hochgeladene Bild wird zum Titelbild im Chat-Karussell.

**Prüfen.** Schritt 7.

### Schritt 7 — Alles im DialogShift Availability Analyzer prüfen

**Warum.** Dies ist dein Probelauf. Der Availability Analyzer fragt MEWS exakt so ab wie die Buchungsagenten und zeigt dir pro Sprache die Daten, mit denen sie arbeiten.

**Wo.** DialogShift: **Integrationen → Availability Analyzer**.

**Wie.** Wähle ein Anreise- und Abreisedatum, trage Erwachsene und Kinder ein, schalte über die Sprachauswahl jede Gastsprache durch und klicke auf **Query Availability**.

**Pro Sprache prüfen.**

* Pro Zimmer: Name liest sich natürlich, Beschreibung nutzt deine Begriffe, das erste Bild ist hinterlegt (DialogShift nutzt nur dieses), und verfügbare Einheiten, Größe und Bettenkonfiguration stimmen.
* Pro Rate: Name liest sich natürlich; Beschreibung deckt Verpflegung, Storno und ggf. Anzahlung ab.

Stimmt etwas nicht: Text- oder Bildproblem → in MEWS korrigieren (Schritte 4–6); falsches Zimmer oder falsche Rate → Freigabeliste anpassen (Schritte 1–2); keine Zimmer an Tagen, an denen du verkaufen willst → Restriktionen prüfen (Schritt 3). Wiederhole, bis jede Sprache korrekt ist.

### Schritt 8 — DialogShift Bescheid geben

Sobald Schritt 7 in jeder Gastsprache einwandfrei ist, gib deinem DialogShift-Ansprechpartner Bescheid: „Hotel \[Name] ist bereit für die Buchungsagenten in Chat und Telefon." Die Agenten werden anschließend freigeschaltet.

## Journey Messaging

| Thema          | Verhalten                                                                                                      |
| :------------- | :------------------------------------------------------------------------------------------------------------- |
| Unterstützt    | Ja. Dieselbe MEWS-Verbindung speist Journey Messaging.                                                         |
| Datenfluss     | MEWS sendet Buchungs- und Gästedaten per Webhook an DialogShift.                                               |
| Aktualisierung | Webhook-basiert; Änderungen werden meist kurz nach dem PMS-Update verarbeitet.                                 |
| Aktivierung    | Die MEWS-Verbindung ist gemeinsam. Für Journey Messaging ist kein zusätzlicher MEWS-Aktivierungsschritt nötig. |

## Konfiguration

Booking-Agent-Kategorien, Raten und Bilder pflegst du in der DialogShift App unter **Integrationen → MEWS**. Journey-Messaging-Flows und Vorlagen pflegst du separat unter **Journey Messaging**.
