Über diesen Workflow
Abmeldungen von Mautic-Kontakten aus automatisierten Abmelde-E-Mails – Workflow-Analyse
Diese n8n-Workflow-Vorlage wurde entwickelt, um E-Mail-Abmeldeanfragen automatisch zu verwalten, die über Gmail eingehen, indem sie mit Mautic, einer beliebten Open-Source-Marketing-Automatisierungsplattform, integriert wird. Wenn jemand eine E-Mail mit "unsubscribe" im Betreff oder Text (oder verwandten Feldern) sendet, identifiziert dieser Workflow den Absender, überprüft seinen Kontaktstatus in Mautic und bearbeitet automatisch seine Opt-out-Anfrage, indem er relevante Segmente aktualisiert, ihn optional zu einer Liste von Nicht-Kontaktieren hinzufügt und eine Bestätigungsantwort zurücksendet.
Der gesamte Prozess läuft auf ereignisgesteuerter Automatisierung innerhalb von n8n, wodurch manuelle Eingriffe entfallen und die Einhaltung von Best Practices für E-Mail-Marketing, wie die zeitnahe Bearbeitung von Opt-outs, gewährleistet wird.
Was der Workflow tut
Dieser Workflow überwacht eingehende E-Mails über Gmail, filtert diejenigen heraus, die wie Abmeldeanfragen aussehen, extrahiert die E-Mail-Adresse des Absenders, prüft, ob diese in Ihrem Mautic CRM vorhanden ist, und führt dann mehrere automatisierte Aktionen durch:
- Fügt den Kontakt zu einem Segment "Abgemeldet" hinzu
- Entfernt ihn aus aktiven Marketingsegmenten (z. B. Newsletter)
- Fügt ihn optional zur Liste "Nicht kontaktieren" von Mautic hinzu
- Sendet eine automatische Antwort, die die Abmeldung bestätigt
Er gewährleistet eine schnelle, genaue und skalierbare Verwaltung von Abmeldeanfragen, ohne dass nach der Einrichtung Benutzereingaben erforderlich sind.
Hauptfunktionen und Fähigkeiten
- ✅ Echtzeit-E-Mail-Überwachung: Verwendet den Gmail Trigger-Knoten, um neue Nachrichten jede Minute abzufragen, einschließlich Spam-/Papierkorb-Ordner.
- ✅ Intelligente Filterung: Identifiziert legitime Abmeldeanfragen mithilfe von bedingter Logik basierend auf dem Inhalt des Empfängerfelds ("An").
- ✅ E-Mail-Parsing-Logik: Verarbeitet komplexe "Von"-Feldformate (z. B.
John Doe <[email protected]>) mithilfe von benutzerdefiniertem JavaScript-Code. - ✅ Duplikatvermeidung: Aggregiert eindeutige E-Mail-Adressen, bevor Mautic abgefragt wird, was die Effizienz verbessert und redundante API-Aufrufe vermeidet.
- ✅ CRM-Integration: Interagiert nahtlos mit Mautic, um die Kontaktsegmentierung und Kommunikationspräferenzen zu aktualisieren.
- ✅ Automatisierte Antwort: Sendet eine personalisierte automatische Antwort, die den erfolgreichen Opt-out bestätigt.
- ✅ Konfigurierbare Einstellungen: Die zentrale Konfiguration über den Knoten Edit Fields ermöglicht eine einfache Anpassung der E-Mail-Adresse und der Antwortnachricht.
- ✅ Skalierbar & Zuverlässig: Verarbeitet mehrere Abmeldeanfragen gleichzeitig und behält dabei die Datenintegrität bei.
Hauptknoten und ihre Zwecke
| Knotenname | Typ | Zweck |
|---|---|---|
| Gmail Trigger | Trigger | Überwacht in Echtzeit neue eingehende E-Mails; fragt jede Minute ab und schließt Spam/Papierkorb ein, um alle möglichen Abmeldungsnachrichten zu erfassen. |
| Edit Fields | Set | Speichert konfigurierbare Werte wie die eigene E-Mail-Adresse des Benutzers und die Abmeldeantwortnachricht. Dient als zentraler Konfigurationspunkt. |
| Is automated unsubscribe? | If Condition | Filtert E-Mails, bei denen das Feld "An" "unsubscribe" enthält UND der Absender nicht derselbe ist wie die konfigurierte E-Mail (um eine Selbstauslösung zu vermeiden). |
| Extract Email from 'From' Field | Code (JavaScript) | Parst den rohen "Von"-Header, um die saubere E-Mail-Adresse mithilfe von Regex zu extrahieren, unterstützt sowohl [email protected] als auch "Name <[email protected]>" Formate. |
| Extract Unique Email Addresses | Code (JavaScript) | Dedupliziert extrahierte E-Mails mithilfe eines Sets, um redundante Operationen zu vermeiden, wenn mehrere E-Mails vom selben Absender kommen. |
| Get Mautic Contact ID from Email Address | Mautic | Fragt die Mautic API ab, um Kontaktdetails mithilfe der extrahierten E-Mail-Adresse abzurufen (search=email:...). Gibt nur ein Ergebnis zurück (limit=1). |
| If Contact Exists in Mautic | If Condition | Prüft, ob der abgefragte Kontakt in Mautic existiert (d. h. eine id hat). Bestimmt die nächsten Schritte entsprechend. |
| Add to unsubscribed segment | Mautic | Fügt den identifizierten Kontakt zu einem vordefinierten Mautic-Segment (ID: 3) hinzu, das angibt, dass er sich abgemeldet hat. |
| Remove newsletter segment | Mautic | Entfernt den Kontakt aus einem anderen Segment (ID: 1), das wahrscheinlich für Newsletter oder Kampagnen verwendet wird. |
| Add to Do Not Contact List | Mautic (deaktiviert) | Würde den Kontakt in Mautic als "Nicht kontaktieren" markieren; derzeit deaktiviert, kann aber für strengere Compliance aktiviert werden. |
| Reply Unsubscribe Message | Gmail | Antwortet direkt auf den ursprünglichen E-Mail-Thread mit einer anpassbaren Erfolgsmeldung, die in Edit Fields gespeichert ist. |
| Sticky Notes | Documentation | Bietet Schritt-für-Schritt-Einrichtungsanleitungen und Kontext für Benutzer, die den Workflow konfigurieren. |
Anwendungsfälle und Vorteile
Ideal für:
- Marketingteams, die große Abonnentenlisten über Mautic verwalten
- Unternehmen, die die DSGVO, CAN-SPAM oder andere Datenschutzbestimmungen einhalten müssen
- Agenturen, die Kundenkommunikation automatisieren und manuelle Aufgaben reduzieren
- Jede Organisation, die die E-Mail-Interaktion verbessern und Bounce-/Beschwerderaten reduzieren möchte
Hauptvorteile:
- ⏱️ Spart Zeit: Eliminiert die Notwendigkeit, jede Abmeldeanfrage manuell zu bearbeiten.
- 🛡️ Verbessert die Compliance: Gewährleistet sofortiges Handeln bei Opt-outs und reduziert rechtliche Risiken.
- 🔁 Reduziert menschliche Fehler: Automatisierung verhindert übersehene oder doppelte Einträge.
- 💬 Verbessert die Benutzererfahrung: Sendet sofortige Bestätigungen an Benutzer, die sich abmelden.
- 📈 Pflegt die Listenhygiene: Hält Mautic-Segmente automatisch sauber und aktuell.
Schritt-für-Schritt-Workflow-Logik
So wird der Workflow sequenziell ausgeführt:
-
Trigger: Eingehende E-Mail erkannt
- Der Gmail Trigger-Knoten wird aktiviert, sobald eine neue E-Mail eintrifft (alle Minute geprüft).
- Er erfasst die vollständigen E-Mail-Metadaten, einschließlich
Von,An,Betreffundid.
-
Konfigurationseinrichtung
- Der Edit Fields-Knoten definiert zwei Schlüsselvariablen:
emailAddress: Ihre Geschäfts-E-Mail (z. B. [email protected])unsubscribeMessage: Text der automatischen Antwort, der die Abmeldung bestätigt
- Der Edit Fields-Knoten definiert zwei Schlüsselvariablen:
-
Gültige Abmeldeanfragen filtern
- Die Bedingung Is automated unsubscribe? prüft:
- Ist "unsubscribe" im Feld
Anvorhanden? → Wahrscheinlich eine Opt-out-Anfrage - Ist der Absender NICHT derselbe wie Ihre konfigurierte E-Mail? → Verhindert Rückschleifen/Selbstauslösung
- Ist "unsubscribe" im Feld
- Nur E-Mails, die beide Bedingungen erfüllen, werden weiterverarbeitet.
- Die Bedingung Is automated unsubscribe? prüft:
-
E-Mail-Adresse des Absenders parsen
- Der Knoten Extract Email from 'From' Field verwendet JavaScript, um die tatsächliche E-Mail-Adresse aus verschiedenen Formaten zu extrahieren:
"[email protected]" → [email protected] "Alice Smith <[email protected]>" → [email protected] - Ausgabe:
{ "extractedEmail": "[email protected]" }
- Der Knoten Extract Email from 'From' Field verwendet JavaScript, um die tatsächliche E-Mail-Adresse aus verschiedenen Formaten zu extrahieren:
-
E-Mail-Adressen deduplizieren
- Der Knoten Extract Unique Email Addresses sammelt alle geparsten E-Mails und entfernt Duplikate mithilfe eines JavaScript
Set. - Dies vermeidet unnötige wiederholte API-Aufrufe an Mautic für dieselbe Person.
- Der Knoten Extract Unique Email Addresses sammelt alle geparsten E-Mails und entfernt Duplikate mithilfe eines JavaScript
-
Kontakt in Mautic finden
- Der Knoten Get Mautic Contact ID from Email Address fragt Mautic ab:
search=email:[email protected] - Gibt Kontaktinformationen einschließlich
idzurück, wenn gefunden; andernfalls leere oder minimale Daten.
- Der Knoten Get Mautic Contact ID from Email Address fragt Mautic ab:
-
Prüfen, ob Kontakt existiert
- Die Bedingung If Contact Exists in Mautic wertet aus:
- Existiert
$json["id"]und ist nicht leer?
- Existiert
- Wenn ja → Fortfahren, Mautic-Datensätze zu aktualisieren
- Wenn nein → Überspringen, aber trotzdem Antwort senden (auch wenn nicht im System vorhanden, wird bestätigt)
- Die Bedingung If Contact Exists in Mautic wertet aus:
-
Mautic-Segmente aktualisieren
- Drei parallele Mautic-Aktionen finden statt:
- ✅ Add to unsubscribed segment (Segment-ID: 3)
- ✅ Remove from newsletter segment (Segment-ID: 1)
- ⚠️ Add to Do Not Contact List — Derzeit deaktiviert, aber zur Aktivierung verfügbar
- Drei parallele Mautic-Aktionen finden statt:
-
Bestätigungsantwort senden
- Der Knoten Reply Unsubscribe Message antwortet direkt auf den ursprünglichen E-Mail-Thread über die Gmail API.
- Der Nachrichtentext stammt aus
$node["Edit Fields"].json["unsubscribeMessage"] - Behält den Gesprächsverlauf bei und bietet dem Absender einen Abschluss.
-
Abschluss
- Der Workflow endet ordnungsgemäß, unabhängig davon, ob der Kontakt in Mautic existierte.
- Alle gültigen Abmeldeversuche erhalten eine Antwort und werden systematisch verarbeitet.
Zusammenfassung
Dieser n8n-Workflow bietet eine leistungsstarke Low-Code-Lösung zur Verwaltung von Abmeldeanfragen über Gmail und Mautic. Durch die Kombination von Triggern, Bedingungen, Code-Logik und Integrationen ermöglicht er Unternehmen, konforme, professionelle und effiziente E-Mail-Marketing-Operationen aufrechtzuerhalten – und das alles mit minimalem laufenden Aufwand. Mit klarer Dokumentation durch Sticky Notes und modularem Design ist er zudem hochgradig anpassbar an verschiedene Anwendungsfälle und organisatorische Bedürfnisse.
So geht’s: JSON herunterladen und in n8n „Aus Datei importieren“ wählen.