Es kann passieren, dass die Anbindung an CleverReach nicht so will, wie man es gerne hätte. Hier gibt es zwei typische Fehler, die du schnell beheben kannst:

• Der Token (die Authentifizierung gegenüber CleverReach) ist ausgelaufen
  

  Exkurs Token: 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 (Berechtigungen) sind nicht richtig eingestellt.
  

  Exkurs Scopes: 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. D.h. wenn ChurchTools auf CleverReach zugreift, überprüft CleverReach anhand der gesetzen Scopes, ob diese Aktion erlaubt ist.

Test #

In den System-Einstellungen unter Integration gibt es für dich eine einfache Möglichkeit, die Verbindung zu CleverReach zu testen. Klicke dafür auf den Button „Verbindung testen“ und ChurchTools führt einige Tests durch. 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 diesen Fehler mit einem entsprechenden Hinweis an.

1. Token abgelaufen #

Es kann ggf. vorkommen, dass der Token nicht mehr verwendbar ist. Dann wird dir folgende Fehlermeldung angezeigt:

 Lösung: In diesem Fall musst du dein CleverReach-Konto neu mit ChurchTools verbinden. Dazu klickst du einfach auf den Button „Neu verbinden“. Du wirst zu CleverReach weitergeleitet, musst dort deinen Benutzernamen und dein Passwort deines CleverReachs Accounts eintragen und dich einloggen. Danach wirst du automatisch zurück zu ChurchTools geleitet.

2. Scopes (Berechtigungen) einstellen #

Wenn die Scopes für die Funktionen, die ChurchTools benötigt, nicht stimmen, erscheint beim Test in den System-Einstellungen folgende Fehlermeldung:

Lösung: In CleverReach müssen die Scopes richtig gesetzt werden. Das kannst du folgendermaßen tun:

1) Logge dich in CleverReach ein.

2) Rufe Mein Account > Extras > REST API auf.

3) Wähle die OAuth App aus, die für ChurchTools erstellt wurde.

4) Vergebe alle Scopes und speichere die neuen Einstellungen.

Nun funktioniert die Verbindung von ChurchTools zu CleverReach wieder. Das kannst du durch einen erneuten Test in den System-Einstellungen prüfen.