Was ist Brevo?
Brevo ist eine E-Mail-Marketing- und CRM-Plattform, die früher unter dem Namen Sendinblue bekannt war. Sie bietet neben klassischen Newsletter-Funktionen auch Transaktionsmails, Automatisierungen, SMS-Marketing und ein integriertes CRM. Für WordPress-Projekte, die Kontaktformulare mit einer Mailing-Liste verbinden wollen, ist Brevo eine häufig eingesetzte Lösung. Brevo selbst bietet ein offizielles WordPress Plugin für eine einfache Integration. In diesem Artikel wollen wir uns jedoch im Besonderen die WPForms Brevo WordPress Integration anschauen.
WPForms Brevo WordPress Addon: Die Integration im Überblick
Das Brevo-Addon für WPForms ist ab der Plus-Lizenz verfügbar. Es verbindet WPForms über die Brevo API und ermöglicht es, Formulareinreichungen direkt in Brevo-Listen zu überführen. Die Grundkonfiguration ist unkompliziert: API-Schlüssel in den WPForms-Einstellungen hinterlegen, eine Verbindung im Formular anlegen, die gewünschte Liste auswählen und Felder mappen. Für einfache Anmeldeformulare ohne Double Opt-in funktioniert das zuverlässig.
Die Probleme beginnen, sobald Double Opt-in ins Spiel kommt.
Das Problem: WPForms Brevo WordPress Double Opt-in liefert Error 400
Die WPForms-Dokumentation beschreibt für Double Opt-in den folgenden Weg: Eine E-Mail-Vorlage in Brevo unter Transaktionsmails anlegen, diese mit dem Tag optin versehen, einen Button mit dem Linktyp „Double-Opt-in-Link” einfügen und die Vorlage dann im WPForms-Formularersteller unter der Brevo-Verbindung auswählen.
Dieser Ansatz funktioniert nicht mehr zuverlässig. Wer sich exakt an diese Anleitung hält, erhält in der Bestätigungsmail zwar einen Button, aber ein Klick darauf führt zu einem Error 400 auf Seiten von Brevo. Der Kontakt landet so natürlich auch nicht in der Liste.
Warum der alte Weg nicht mehr funktioniert
Brevo hat die Art, wie Double Opt-in für externe Formulare funktioniert, geändert. Für Formulare, die außerhalb von Brevo erstellt wurden, also auch für WPForms, ist der korrekte Weg nicht mehr die Transaktionsmail mit optin-Tag, sondern ein Automationsflow innerhalb von Brevo. Die WPForms-Dokumentation spiegelt diesen Stand noch nicht wider.
WPForms Brevo WordPress Double Opt-in: Die aktuelle Lösung über den Automationsflow
Brevo unterscheidet heute klar zwischen Formularen, die direkt in Brevo erstellt wurden, und Formularen externer Anbieter. Für externe Formulare muss der Double Opt-in über eine Automation in Brevo abgebildet werden. Der Ablauf sieht so aus:
- Ein Kontakt füllt das WPForms-Formular aus und wird dabei in eine temporäre Liste in Brevo eingetragen.
- Die Automation wird durch das Hinzufügen zur temporären Liste ausgelöst und sendet die Bestätigungsmail.
- Klickt der Kontakt auf den Bestätigungslink, wird er in die finale Liste verschoben.
- Gleichzeitig wird er aus der temporären Liste entfernt.
- Kontakte, die innerhalb des definierten Zeitraums nicht bestätigen, können dann bspw. auf eine Blockliste gesetzt oder gelöscht werden.
Schritt 1: Zwei Listen in Brevo anlegen
Bevor die Automation eingerichtet werden kann, braucht man zwei separate Listen in Brevo. Eine temporäre Liste, zum Beispiel mit dem Namen TEMP_DOI, in die WPForms die Kontakte zunächst einträgt. Und eine finale Liste, die die tatsächlich bestätigten Abonnent:innen enthält.
Die temporäre Liste sollte klar als solche gekennzeichnet sein, und es dürfen keine Kampagnen an die darin gespeicherten Kontakte gesendet werden.
Schritt 2: WPForms mit der temporären Liste verbinden
Im WPForms-Formularersteller wird die Brevo-Verbindung so eingerichtet, dass Kontakte beim Absenden des Formulars in die temporäre Liste eingetragen werden. Die Double-Opt-in-Option in WPForms selbst bleibt dabei deaktiviert, da der Bestätigungsprozess vollständig über den Brevo-Automationsflow läuft.
Schritt 3: Den Automationsflow in Brevo einrichten
Unter Automations > Workflows wird eine neue Automation erstellt. Als Trigger dient der Schritt „Kontakt wurde einer Liste hinzugefügt”, wobei die temporäre Liste ausgewählt wird.
Der Ablauf der Automation:
Trigger: Kontakt wird der temporären Liste hinzugefügt.
- Bestätigungsmail senden: Brevo stellt im Automationseditor keine nativen „Double Opt-in E-Mail” Aktionen bereit. Stattdessen muss man hier ein eigenes Template wählen oder aus dem Automationseditor heraus erstellen und dort einen fest definierten Link als Ziel hinterlegen. Der entscheidende Unterschied zum alten Ansatz ist dieser fest definierte Link statt des nativen Brevo DOI-Links.
- Warten auf Bestätigung: Der Automationsflow wartet, bis der Kontakt auf den Bestätigungslink klickt. Hier lässt sich ein Zeitlimit setzen, in welchem der Kontakt die Interaktion vornehmen muss.
- Ja-Zweig (Kontakt hat bestätigt): Im Ja-Zweig wird der Kontakt der finalen Liste hinzugefügt und anschließend aus der temporären Liste entfernt.
- Nein-Zweig (Kontakt hat nicht bestätigt): Kontakte, die nicht innerhalb des festgelegten Zeitraums bestätigen, sollten entweder aus der temporären Liste entfernt oder gänzlich gelöscht werden.
Schritt 4: Automation aktivieren
Nach dem Einrichten wird die Automation über „Activate automation” gestartet. Die Option „Allow contact re-entry after exit” sollte aktiviert werden, damit Kontakte den Prozess erneut durchlaufen können, falls sie sich nach einer Abmeldung erneut anmelden.
Der Brevo-Hilfsartikel zum aktuellen Vorgehen für externe Formulare ist in der Brevo-Dokumentation zu finden.
Vor- und Nachteile des Automationsflows
Der Automationsflow hat einen entscheidenden Vorteil gegenüber dem alten Ansatz über die Transaktionsmail: Der Bestätigungsprozess liegt vollständig in Brevo, ist dort transparent einsehbar und lässt sich unabhängig von WPForms anpassen. Änderungen an der Bestätigungsmail oder am Timing erfordern keine Änderungen im Formular. Gleichzeitig ist die Logik klar dokumentiert und nachvollziehbar.
Allerdings wird hier die Verantwortung des Double Opt-in ganz klar von der Newsletter-Plattform auf den Newsletter-Versendenden verlagert. Durch das hinzufügen auf die temporäre Liste besteht somit die Gefahr, versehentlich auch an die dort gelisteten Kontakte unerlaubterweise E-Mails zu versenden.
Fazit
Die WPForms Brevo WordPress-Integration funktioniert ohne Double Opt-in ohne weiteres. Wer Double Opt-in benötigt, muss jedoch wissen, dass die WPForms-Dokumentation einen veralteten Stand beschreibt. Der korrekte Weg führt heute über einen Automationsflow in Brevo, der die Bestätigung komplett eigenständig abwickelt. Wer das einmalig sauber einrichtet, hat eine DSGVO-konforme Lösung, die ohne weitere Abhängigkeiten läuft.
Wenn du Fragen zur Integration von WPForms mit Brevo oder anderen Drittanbieter-Systemen hast, kannst du dich gerne bei mir melden.