{"id":35612,"date":"2023-03-24T18:44:44","date_gmt":"2023-03-24T17:44:44","guid":{"rendered":"https:\/\/leogeracademy.hestia.wpspace.me\/help\/non-knowledgebase\/uncategorized\/cleverreach-integration\/"},"modified":"2025-05-19T08:50:59","modified_gmt":"2025-05-19T07:50:59","password":"","slug":"cleverreach-integration","status":"publish","type":"docs","link":"https:\/\/staging.churchtools.academy\/en\/help\/system-settings\/e-mail-en\/cleverreach-integration\/","title":{"rendered":"CleverReach integration"},"content":{"rendered":"\n<p>Es kann passieren, dass die Anbindung an CleverReach nicht so will, wie man es gerne h\u00e4tte. Hier gibt es zwei typische Fehler, die du schnell beheben kannst:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Der Token (die Authentifizierung gegen\u00fcber CleverReach) ist ausgelaufen<br><table style=\"width: 97.1244%; border-width: 3px; border-color: #2dc26b;\" border=\"1\"><tbody><tr><td style=\"width: 99.889%; border-width: 3px; padding: 3px; border-color: #2dc26b;\"><strong>Exkurs Token: <\/strong>Der Token ist der Schl\u00fcssel zu deinem CleverReach Account. Diesen verwendet ChurchTools, um sich gegen\u00fcber CleverReach zu authentifizieren und in deinem Auftrag zu handeln.<\/td><\/tr><\/tbody><\/table><\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Die Scopes (Berechtigungen) sind nicht richtig eingestellt.<br><table style=\"width: 97.1244%; border-width: 3px; border-color: #2dc26b;\" border=\"1\"><tbody><tr><td style=\"width: 99.8577%; border-width: 3px; padding: 3px; border-color: #2dc26b;\"><p><strong>Exkurs Scopes:<\/strong> Damit CleverReach mit ChurchTools verbunden werden kann, wurde im Vorfeld bereits eine OAuth App in CleverReach angelegt. Diese App kann dort mit sogenannte <em>Scopes<\/em> versehen werden. Scopes sind im Grunde Berechtigungen. D.h. wenn ChurchTools auf CleverReach zugreift, \u00fcberpr\u00fcft CleverReach anhand der gesetzen Scopes, ob diese Aktion erlaubt ist.<\/p><\/td><\/tr><\/tbody><\/table><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Test<\/h2>\n\n\n\n<p>In den <em>System-Einstellungen<\/em> unter <em>Integration<\/em> gibt es f\u00fcr dich eine einfache M\u00f6glichkeit, die Verbindung zu CleverReach zu testen. Klicke daf\u00fcr auf den Button &#8220;Verbindung testen&#8221; und ChurchTools f\u00fchrt einige Tests durch. Wenn alles in Ordnung ist, zeigt dir ChurchTools eine gr\u00fcne 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.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">1. Token abgelaufen<\/h2>\n\n\n\n<p>Es kann ggf. vorkommen, dass der Token nicht mehr verwendbar ist. Dann wird dir folgende Fehlermeldung angezeigt:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-4.png\"><img fetchpriority=\"high\" decoding=\"async\" width=\"795\" height=\"136\" src=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-4.png\" alt=\"\" class=\"wp-image-17311\" srcset=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-4.png 795w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-4-300x51.png 300w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-4-768x131.png 768w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-4-360x62.png 360w\" sizes=\"(max-width: 795px) 100vw, 795px\" \/><\/a><\/figure>\n\n\n\n<p>&nbsp;<strong>L\u00f6sung:<\/strong> In diesem Fall musst du dein CleverReach-Konto neu mit ChurchTools verbinden. Dazu klickst du einfach auf den Button &#8220;Neu verbinden&#8221;. Du wirst zu CleverReach weitergeleitet, musst dort deinen Benutzernamen und dein Passwort deines CleverReachs Accounts eintragen und dich einloggen. Danach wirst du automatisch zur\u00fcck zu ChurchTools geleitet.<\/p>\n\n\n\n<aside class=\"wp-block-group ct-box ct-box-blue has-background is-vertical is-layout-flex wp-container-core-group-is-layout-002f1c27 wp-block-group-is-layout-flex\" style=\"border-radius:8px;border-left-color:#ef4444;border-left-width:0.5rem;background-color:#fee2e2;margin-top:var(--wp--preset--spacing--60);margin-bottom:var(--wp--preset--spacing--60)\">\n<p style=\"margin-top:0.5rem;margin-right:0.5rem;margin-bottom:0rem;margin-left:0.5rem\"><strong>Achtung<\/strong><\/p>\n\n\n\n<p style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">Verwende wirklich den &#8220;Neu verbinden&#8221; Button! Du solltest die Verbindung\u00a0<em>nicht<\/em> trennen. Denn beim Trennen der Verbindung verlierst Du alle Informationen in ChurchTools dazu, welche Personen schon synchronisiert wurden.<\/p>\n<\/aside>\n\n\n\n<h2 class=\"wp-block-heading\">2. Scopes (Berechtigungen) einstellen<\/h2>\n\n\n\n<p>Wenn die Scopes f\u00fcr die Funktionen, die ChurchTools ben\u00f6tigt, nicht stimmen, erscheint beim Test in den System-Einstellungen folgende Fehlermeldung:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-5.png\"><img decoding=\"async\" width=\"506\" height=\"135\" src=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-5.png\" alt=\"\" class=\"wp-image-17313\" srcset=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-5.png 506w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-5-300x80.png 300w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-5-360x96.png 360w\" sizes=\"(max-width: 506px) 100vw, 506px\" \/><\/a><\/figure>\n\n\n\n<p><strong>L\u00f6sung:<\/strong> In CleverReach m\u00fcssen die Scopes richtig gesetzt werden. Das kannst du folgenderma\u00dfen tun:<\/p>\n\n\n\n<p>1) Logge dich in CleverReach ein.<\/p>\n\n\n\n<p>2) Rufe <em>Mein Account &gt; Extras &gt; REST API<\/em> auf.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-6.png\"><img decoding=\"async\" width=\"1024\" height=\"509\" src=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-6-1024x509.png\" alt=\"\" class=\"wp-image-17315\" srcset=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-6-1024x509.png 1024w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-6-300x149.png 300w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-6-768x382.png 768w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-6-360x179.png 360w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-6.png 1215w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<p>3) W\u00e4hle die OAuth App aus, die f\u00fcr ChurchTools erstellt wurde.<\/p>\n\n\n\n<p>4) Vergebe alle Scopes und speichere die neuen Einstellungen.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-7.png\"><img loading=\"lazy\" decoding=\"async\" width=\"666\" height=\"676\" src=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-7.png\" alt=\"\" class=\"wp-image-17317\" srcset=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-7.png 666w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-7-296x300.png 296w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2023\/03\/image-7-360x365.png 360w\" sizes=\"(max-width: 666px) 100vw, 666px\" \/><\/a><\/figure>\n\n\n\n<p>Nun funktioniert die Verbindung von ChurchTools zu CleverReach wieder. Das kannst du durch einen erneuten Test in den System-Einstellungen pr\u00fcfen.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Es kann passieren, dass die Anbindung an CleverReach nicht so will, wie man es gerne h\u00e4tte. Hier gibt es zwei typische Fehler, die du schnell beheben kannst: Test In den System-Einstellungen unter Integration gibt es f\u00fcr dich eine einfache M\u00f6glichkeit, die Verbindung zu CleverReach zu testen. Klicke daf\u00fcr auf den Button &#8220;Verbindung testen&#8221; und ChurchTools [&hellip;]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[466],"doc_tag":[653],"knowledge_base":[425],"class_list":["post-35612","docs","type-docs","status-publish","hentry","doc_category-e-mail-en","doc_tag-content-outdated-en","knowledge_base-system-settings"],"acf":[],"year_month":"2026-05","word_count":362,"total_views":"105","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Victoria Weidemann","author_nicename":"vweidemann","author_url":"https:\/\/staging.churchtools.academy\/en\/author\/vweidemann\/"},"doc_category_info":[{"term_name":"E-Mail","term_url":"https:\/\/staging.churchtools.academy\/en\/help\/system-settings\/e-mail-en\/"}],"doc_tag_info":[{"term_name":"Content outdated","term_url":"https:\/\/staging.churchtools.academy\/en\/docs-tag\/content-outdated-en\/"}],"knowledge_base_info":[{"term_name":"System Settings","term_url":"https:\/\/staging.churchtools.academy\/en\/help\/system-settings\/","term_slug":"system-settings"}],"knowledge_base_slug":["system-settings"],"_links":{"self":[{"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/35612","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/comments?post=35612"}],"version-history":[{"count":1,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/35612\/revisions"}],"predecessor-version":[{"id":35613,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/35612\/revisions\/35613"}],"wp:attachment":[{"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/media?parent=35612"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/doc_category?post=35612"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/doc_tag?post=35612"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/knowledge_base?post=35612"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}