CleverReach Anbindung für Newsletter-Anmeldungen

Mit der Newsletters Erweiterung wird das Sammeln und Nutzen von E-Mail-Adressen so einfach wie noch nie! Die Erweiterung sorgt dafür, dass die E-Mail-Adressen deiner Benutzer via Rest-API in CleverReach übertragen werden können. Wie? Ganz einfach: Öffne die Synchronisations-Ansicht im Newsletters-Backendmodul (Pro-Version) und gleiche Deine Daten ab.

Das Besondere: Über sogenannte Connection-Datensätze kannst du verschiedene Empfängerlisten anlegen und diese direkt mit deinen Datensatz-Containern verknüpfen. So landen die gesammelten Daten automatisch dort, wo sie hingehören – bereit für dein nächstes E-Mail-Marketing-Mailing.

Warum das cool ist? Du sparst Zeit, automatisierst deine Prozesse und kannst dich voll auf dein Marketing konzentrieren.

Vorbereitung der CleverReach Rest-Schnittstelle

Um die Newsletters Erweiterung mit CleverReach nutzen zu können, müssen wir eine OAuth-Verbindung herstellen. Dafür gehe wie folgt vor:

1. Logge Dich bei CleverReach ein
2. Klicke oben rechts auf dein Avatar und auf Mein Account
3. Hier klicke dann auf dem Tab Schnittstellen auf den Punkt REST-API
4. Klicke oben rechts auf OAuth2-App anlegen um die Schnittstelle zu definieren
5. Vergebe einen Namen für die App und wähle REST API Version 3 aus
6. Definiere in welchem Scope die App Daten verwalten darf. Wähle hier Empfänger aus

Erstellung eines Connection-Datensatzes

Der Connection-Datensatz stellt die Verbindung zwischen deine Newsletter-Themen (Topic-Datensätze) und den CleverReach Empfängerlisten her. Du kannst also für jede Deiner Datensatz-Container eine Connection anlegen, und dann bei der Zuweisung in den Topics genau entscheiden, wohin die E-Mailadresse synchronisiert werden

1. Erstelle einen Datensatz vom Typ Connection
2. Wähle beim Typ den Eintrag CleverReach aus und speichere den Datensatz
3. Gebe der neuen Connection einen aussagekräftigen Titel, so dass deine Redakteure später genau wissen, dass die Daten zu CleverReach gepusht werden und in welcher Empfänger-Liste diese landen
4. Gebe die Client-ID und das Client-Secret ein, welches Du im CleverReach Login generiert hast
5. Die Autorize-URL und Token-URL sollte wie voreingetragen bereits passen
6. Die Redirect-URI ist eine beliebige URL von deinem Frontend
7. Sobald Du nun speicherst, erhältst du eine neue Info-Anzeige in deinem Datensatz - hier kannst du mit einem Klick auf CleverReach authorization die OAuth-Autorisation abschließen
8. Nach dem Klick öffnet sich eine CleverReach Seite (lasse Dich nicht von der roten Meldung verunsichern - es beutet lediglich, das CleverReach diese Extension noch nicht verifiziert hat) auf der Du mit einem Klick auf verbinden nur noch deine Zugangsdaten eingeben musst
9. Abschließend wirst Du auf deine eigene Webseite weitergeleitet, wo jetzt durch Authorization successful angezeigt wird, dass die Verbindung hergestellt wurde
10. Als letztes musst du nur noch im Connection-Datensatz angeben, in welche Empfänger-Liste deine E-Mailadressen eingetragen werden sollen.

Achtung:

Manchmal kann es einen Moment dauern, bis ein neu übertragener Empfänger bei CleverReach sichtbar wird! Es kann auch mal passieren, dass ein Empfänger dann angezeigt wird, seine Felder aber noch leer sind und die Feldinhalte etwas später erscheinen!

Problembehandlung

Der Aufruf der CleverReach Autorisierung endet mit einem 404-Fehler

Der Aufruf der Autorisierung ergibt ein:

Page Not Found
Reason: Request parameters could not be validated (&cHash empty)

Lösung 1.:

Öffne das Installtool und deaktiviere die Einstellung pageNotFoundOnCHashError: [FE][pageNotFoundOnCHashError] = false

$GLOBALS['TYPO3_CONF_VARS']['FE']['pageNotFoundOnCHashError'] = false;

Lösung 2.

Entferne die Parameter des Requests aus der cHash Berechnung (LocalConfigration/settings.php):

$GLOBALS['TYPO3_CONF_VARS'] = array_replace_recursive(
    $GLOBALS['TYPO3_CONF_VARS'],
    [
        'FE' => [
            'cacheHash' => [
                'enforceValidation' => true,
                'excludedParameters' => [
                    'connection',
                    'code',
                ],
            ],
        ],
    ]
);

Fehler: No page configured

Sollte bei der Autorisierung die Fehlermeldung "No page configured for type=1766752431." erscheinen, stelle sicher dass das statische TypoScript-Template auf der Root-Seite vorhanden ist.

Permission denied!

Manchmal kommt es vor, dass die Autorisierung beim Reirect auf deine Seite erst "Permission denied!" anzeigt. Versuche einmal den Cursur in die Adressleiste des Browsers zu setzen und die Seite neu zu laden – das könnte das Problem beheben.

Nach der Auorisierung kommt nur deine Website?

Öffne die Netzwerk-Console in deinen Developer-Tools im Browser und inspiziere die Anfragen.

In diesem Fall ist das Problem, dass eine Weiterleitung auf Basis des Benutzer-Agents stattfindet um direkt die richtige Sprache anzuzeigen. D.h. bei der Redirect-URI im Connection-Datensatz muss nicht https://www.coding.ms/ eingetragen werden, sondern die Adresse welche aus dem Sprach-Redirect entsteht - also https://www.coding.ms/de/.