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

# CleverReach als externes System verbinden

> Wie du CleverReach V3 als externes System in ROOMS! einrichtest, inklusive Erstellung der OAuth2-App in CleverReach und Hinterlegung der Zugangsdaten.

Das externe System CleverReach V3 speichert die Zugangsdaten für die CleverReach V3 REST API an einem zentralen Ort in ROOMS! (dem zentralen PMS). Komponenten wie NEWSLETTER SYNC! (die Gästelisten-Synchronisierung) greifen auf diese Zugangsdaten zu, um Gästedaten mit CleverReach zu synchronisieren. Dieser Artikel beschreibt, wie du die OAuth2-App in CleverReach erstellst und das externe System in ROOMS! einrichtest.

## Voraussetzungen

* Ein aktives CleverReach-Konto mit Zugriff auf die OAuth2-App-Verwaltung

## Schritte

### OAuth2-App in CleverReach erstellen

1. Öffne die CleverReach-Verwaltung unter `https://eu.cleverreach.com/admin/account_rest.php`.
2. Klicke auf **OAuth2-App anlegen**.
3. Vergib einen Namen für die App (z. B. „Anexis CLOUD!").
4. Wähle im Feld darunter die Option **REST API Version 3 (empfohlen)** aus.
5. Belasse das Feld **Redirect URL** beim Standard-Wert.
6. Aktiviere unter **Scopes** sämtliche Checkboxen.
7. Klicke auf **Jetzt erstellen**, um die OAuth2-App zu erstellen.
8. Wähle in der angezeigten Liste die soeben erstellte OAuth2-App aus.
9. Wechsle zum Reiter **OAuth2 App Daten** und notiere die **Client-ID** und das **Client-Secret**.

### Externes System in ROOMS! einrichten

1. Klicke im Mandant-Dashboard im Bereich **Allgemein** auf **Externe Systeme**.
2. Klicke auf **Neu**, um ein neues externes System zu erstellen.
3. Wähle bei **Typ** den Wert „CleverReach V3" aus.
4. Vergib einen **Namen** für das externe System (z. B. „CleverReach Newsletter").
5. Trage die **Client-ID** aus der OAuth2-App ein.
6. Trage das **Client-Secret** aus der OAuth2-App ein.
7. Klicke auf **Verbindungstest**, um zu prüfen, ob die Zugangsdaten korrekt sind.
8. Setze das Feld **Aktiv** auf „Ja".
9. Klicke auf **Speichern** oder **Speichern und schließen**, um den Eintrag zu bestätigen.

## Tipps

* Falls beim Verbindungstest Fehler auftreten, prüfe zuerst, ob Client-ID und Client-Secret korrekt aus der OAuth2-App übernommen wurden. Falls die Fehler nach erneuter Prüfung bestehen bleiben, wende dich direkt an CleverReach.
* Stelle sicher, dass in der OAuth2-App alle Scopes aktiviert sind. Fehlende Scopes können dazu führen, dass NEWSLETTER SYNC! nicht alle Funktionen nutzen kann.
* Du kannst mehrere externe Systeme vom Typ CleverReach V3 anlegen, falls du unterschiedliche CleverReach-Konten nutzt. Vergib in diesem Fall aussagekräftige Namen, um die Einträge voneinander zu unterscheiden.

## Verwandte Artikel

* [CleverReach Seitenreferenz](./cleverreach-v3) -- alle Felder und Einstellungen im Detail
* [Externe Systeme Seitenreferenz](../external-systems) -- Übersicht aller externen Systeme
* [NEWSLETTER SYNC! einrichten](../components/setup-newsletter-sync) -- Voraussetzungen und Einrichtungsschritte für NEWSLETTER SYNC!