Files

Floke 7c82e4b5d7 feat: Implement unsubscribe link for marketing automation [31188f42]

This commit introduces a new unsubscribe feature to allow contacts to opt-out
from marketing automation.

Key changes include:
- Database schema migration: Added  (UUID) to the  model.
- Data population: Implemented a script to assign unique tokens to existing contacts.
- API endpoint: Created a public GET  endpoint to handle opt-out requests.
- Automation: New contacts automatically receive an unsubscribe token upon creation.
- Integration: The full unsubscribe link is now returned via the provisioning API
  for storage in SuperOffice UDFs (ProgID: SuperOffice:9).
- Documentation: Updated  and
  to reflect the new feature and its integration requirements.
- Added  for quick overview and next steps.

2026-02-24 12:18:13 +00:00

2.4 KiB

Raw Blame History

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:

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
    # ...
```
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.
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.

2.4 KiB Raw Blame History

Abschluss des Features "Unsubscribe-Link"

Zusammenfassung der Implementierung

Nächste technische Schritte zur Inbetriebnahme

2.4 KiB

Raw Blame History