Es kann passieren, dass die Anbindung an CleverReach nicht funktioniert. Meist sind das zwei typische Fehler, die du schnell beheben kannst.
- Der Token ist ausgelaufen.
Der Token ist der Schlüssel zu deinem CleverReach-Account. Diesen verwendet ChurchTools, um sich gegenüber CleverReach zu authentifizieren und in deinem Auftrag zu handeln.
- Die Scopes sind nicht richtig eingestellt.
Damit CleverReach mit ChurchTools verbunden werden kann, wurde im Vorfeld bereits eine OAuth App in CleverReach angelegt. Diese App kann dort mit sogenannte Scopes versehen werden. Scopes sind im Grunde Berechtigungen. Wenn ChurchTools auf CleverReach zugreift, überprüft CleverReach anhand der gesetzen Scopes, ob diese Aktion erlaubt ist.
Verbindung testen #
Um herauszufinden, woran das Verbindungs-Problem liegt, gibt es für dich eine einfache Möglichkeit, die Verbindung zu CleverReach zu testen: In den System-Einstellungen unter Integration und CleverReach klickst du auf den Button Verbindung testen.
Wenn alles in Ordnung ist, zeigt dir ChurchTools eine grüne Informations-Box an, um dies zu kennzeichnen. Sollte ein Fehler auftreten oder etwas nicht stimmen, zeigt dir eine rote Box den entsprechenden Fehler mit einem entsprechenden Hinweis an.
1. Token abgelaufen #
Dir wird folgende Fehlermeldung angezeigt:
In diesem Fall verbindest du über den Button Neu verbinden in der Fehlermeldung dein CleverReach-Konto neu mit ChurchTools. Du wirst zu CleverReach weitergeleitet, trägst dort die Zugangsdaten deines CleverReachs-Accounts ein und loggst dich ein. Danach wirst du automatisch zurück zu ChurchTools geleitet.
2. Scopes einstellen #
Wenn die Scopes für die Funktionen, die ChurchTools benötigt, nicht stimmen, erscheint beim Test folgende Fehlermeldung:
In CleverReach müssen die Scopes richtig gesetzt werden. Das kannst du folgendermaßen tun:
- Logge dich in CleverReach ein.
- Rufe Mein Account > Extras > REST API auf.
- Wähle die OAuth-App aus, die für ChurchTools erstellt wurde.
- Hake alle Checkboxen unter Scopes an und speichere die neuen Einstellungen.
Nun funktioniert die Verbindung von ChurchTools zu CleverReach wieder. Führe zur Prüfung einen erneuten Test in den System-Einstellungen in ChurchTools durch.