Die Verknüpfung beider Systeme ist einfach möglich.
Verknüpfung & Aktivierung
Um dein twingle-Konto mit deinem Brevo Account zu verknüpfen, musst du im twingleMANAGER unter "Einstellungen" deinen API-Schlüssel von Brevo hinterlegen. Du findest den API-Schlüssel bei Brevo unter "SMTP & API".
Kopiere den Schlüssel komplett und füge ihn im twingleMANAGER unter Einstellungen / Allgemein ein:
Anschließend musst du in allen Projekten, aus denen heraus du Daten an Brevo übermitteln willst, den Versand ebenfalls aktivieren. Dazu findest du unter Kontaktdaten & Einbindung die nötigen Einstellungen und hast folgende Einstellungsmöglichkeiten:
Die E-Mail-Adressen aller Spender:innen, die sich im Spendenprozess für den Newsletter angemeldet haben, werden in der "Empfängerliste für Newsletter Anmeldungen" eingetragen. Optional können auch die E-Mail-Adressen an Brevo übergeben werden, die sich nicht für den Newsletter registriert haben. So kann die weitere E-Mail-Kommunikation auch über Brevo erfolgen. Die entsprechende Liste kannst du hier ebenfalls auswählen.
Für den Versand der Double-Opt-In-E-Mail (DOI) muss zusätzlich eine (aktive) E-Mail-Vorlage und eine URL für die Weiterleitung nach erfolgtem DOI angegeben werden.
Sobald in einem Projekt eine Kontaktliste für Newsletter-Anmeldungen ausgewählt ist, verschickt Brevo die Double-Opt-In-Mail. Die twingle-Option "twingle Double-Opt-In per E-Mail" ist dann deaktiviert. Brevo verschickt die Double-Opt-In-Mail nur für neue Kontakte: Existiert die E-Mail-Adresse in Brevo bereits, aktualisiert twingle den Kontakt und ordnet ihn der Liste zu, es wird aber keine neue Double-Opt-In-Mail versendet.
Voraussetzungen: Brevo
Für die Nutzung zwischen twingle und Brevo müssen folgende Voraussetzungen erfüllt sein:
- Mindestens eine aktive Kontaktliste muss vorhanden sein
- Mindestens eine aktive E-Mail-Vorlage muss vorhanden sein und diese muss das Tag "optin" gesetzt haben
- Um weitere Spenden-Daten aus twingle in Brevo übernehmen zu können (z.B. Name, Anschrift, oder Spendenbetrag), müssen die unten genannten Attribute in Brevo angelegt werden
Bekannte Fehler
Bei der Datenübertragung zu Brevo kann es zu Fehlern kommen. Hier sind die häufigsten genannt.
An active DOI template does not exist
Die eingestellte E-Mail-Vorlage für die DOI-Mail hat nicht das Tag optin. Logge dich bei Brevo ein, öffne die Mailvorlage und setze das Tag. Die Meldung erscheint auch, wenn im twingleMANAGER keine E-Mail-Vorlage für das Double-Opt-In ausgewählt ist. Logge dich im twingleMANAGER ein, öffne Projekteinstellungen / Kontaktdaten & Einbindung und wähle im Feld "E-Mail-Vorlage für Double-Opt-In" eine aktive Vorlage aus, die das Tag optin trägt.
We have detected you are using an unrecognised IP address ...
Die IP-Adresse der twingle-Server wurde von Brevo geblockt und muss von dir freigegeben werden. Laut Brevo Dokumentation bekommst du dazu eine Info-Mail und kannst dort die Freigabe geben.
Bei der Kommunikation mit der Brevo / Sendinblue API ist ein Fehler aufgetreten
Diese Meldung erscheint im twingleMANAGER, wenn die Zugangsdaten nicht stimmen. Prüfe den API-Schlüssel bei Brevo unter "SMTP & API" und füge ihn im twingleMANAGER unter Einstellungen / Allgemein erneut ein.
Datenübertragung
twingle überträgt eine Person (E-Mail-Adresse) einmal an Brevo, bei der ersten Zahlung, die übermittelt wird. Spätere Zahlungen derselben Person aktualisieren den Kontakt in Brevo nicht erneut. twingle überträgt dabei alle eingegebenen Kontaktdaten an Brevo in Attributen. Diese Attribute müssen in Brevo unter den genannten Namen angelegt sein. Sollte ein Attribut nicht angelegt sein, wird es nicht übernommen. Die Attribute können in Brevo unter Kontakte / Einstellungen / Kontaktattribute und CRM eingerichtet werden.
Beispielkonfiguration:
Folgende Attribute werden übertragen. Der Spendenzweck gehört nicht zu den übertragenen Attributen.
- FIRSTNAME
- VORNAME
- NACHNAME
- LASTNAME
- SALUTATION (male, female, divers)
- TITLE (derzeit noch ohne Inhalt, Platzhalter für zukünftige Titel-Angaben)
- ADDRESS
- ZIP
- CITY
- COUNTRY (Länderkürzel, z.B. "DE")
- BIRTHDAY (kann als Textfeld oder als Datumsfeld angelegt sein)
- COMPANY
- TELEPHONE
- EXTRA (Zusätzliche Kontaktdaten, wenn aktiviert)
- TWPROJECT (Projekt-ID wie im twingleMANAGER sichtbar)
- TWRHYTHM (Zahlungsrhythmus: one_time, monthly, quarterly, halfyearly, yearly)
- TWNEWSLETTER (Anmeldung zum Newsletter: true, false)
- TWPOSTINFO (Infos per Post bestellt: true, false)
- TWRECEIPT (Spendenquittung: true, false)
- TWAMOUNT (Betrag der Spende)
- TWDATE (Datumsfeld - aktuelles Datum der Übertragung, damit können Automatisierungen gestartet werden)