Brancheneinstufung2/docs/UNSUBSCRIBE_FEATURE_SUMMARY.md

Abschluss des Features "Unsubscribe-Link"

Zusammenfassung der Implementierung

In dieser Session wurde eine vollständige, sichere Unsubscribe-Funktion für die Marketing-Automation im company-explorer implementiert. Dies umfasst ein Datenbank-Update mit sicheren Tokens, einen öffentlichen API-Endpunkt zur Abmeldung und die Integration in den SuperOffice-Provisionierungsprozess.

Nächste technische Schritte zur Inbetriebnahme

Um das Feature vollständig zu nutzen, sind die folgenden Schritte im connector-superoffice und der Infrastruktur notwendig:

1. Konfiguration der APP_BASE_URL:

   • Was? In der Konfiguration des company-explorer (z.B. in einer .env-Datei oder direkt in der docker-compose.yml) muss die Umgebungsvariable APP_BASE_URL gesetzt werden.
   • Warum? Diese URL ist die öffentliche Basis-Adresse, die für den Bau des Unsubscribe-Links verwendet wird (z.B. APP_BASE_URL="https://www.ihre-domain.de").
   • Beispiel (in docker-compose.yml):

     services:
       company-explorer:
         # ...
         environment:
           - APP_BASE_URL=https://www.robo-planet.de
         # ...
     

2. Anpassung des connector-superoffice Workers:

   • Was? Der Worker-Prozess im connector-superoffice, der die Daten vom company-explorer empfängt, muss angepasst werden. Er muss das neue Feld unsubscribe_link aus der API-Antwort auslesen.
   • Warum? Aktuell kennt der Connector dieses Feld noch nicht und würde es ignorieren.
   • Wo? In der Datei connector-superoffice/worker.py (oder ähnlich), in der Funktion, die die /provision-Antwort verarbeitet.

3. Schreiben des Links in das SuperOffice UDF:

   • Was? Die Logik im connector-superoffice Worker, die Daten nach SuperOffice schreibt, muss erweitert werden. Der ausgelesene unsubscribe_link muss in das von Ihnen angelegte Textfeld mit der ProgID SuperOffice:9 geschrieben werden.
   • Warum? Nur so wird der Link im CRM gespeichert und kann in E-Mail-Vorlagen verwendet werden.
   • Wo? An der Stelle, an der die SuperOfficeAPI.update_person (oder eine ähnliche Funktion) mit den UDF-Daten aufgerufen wird.

Nach diesen drei Schritten ist der gesamte Prozess von der Generierung des Links bis zur Speicherung im CRM und der Nutzung in E-Mails funktionsfähig.