Lösungsstartseite Externe Services & Schnittstellen Brevo-Schnittstelle

Brevo Connector: FundraisingBox-Kontaktdaten in einen Brevo-Account übertragen

Geändert am: Mi, 20 Mai, 2026 um 2:44 NACHMITTAGS

INHALTSVERZEICHNIS

In diesem Artikel erfahren Sie, wie die Kontaktdaten automatisiert in Ihren Brevo-Account übertragen werden können, die in Ihrer FundraisingBox-Instanz angelegt werden, wenn über eines Ihrer FundraisingBox-Spendenformulare von Spender*innen eine Transaktion getätigt wird.

Hinweis: Bei konkrekten Fragen, die sich ausschließlich auf Brevo selbst beziehen, sind das Brevo-Lösungsportal und das Brevo-Support-Team Ihre primären Informationsquellen.

Gut zu wissen

  • Die Einrichtung für den Brevo Connector ist einmalig kostenpflichtig, siehe Hinweis im Store.
  • Der Brevo Connector als Schnittstelle zu Ihrem Brevo-Account ist vollständing automatisiert; es ist nicht nötig und auch nicht möglich, den Prozess für die Datenübertragung manuell anzustoßen, anders als bei unserer CleverReach-Schnittstelle.
  • Die FundraisingBox-Schnittstelle zu Ihrem Brevo-Account wird von uns einmalig für Sie eingerichtet und arbeitet von da an automatisch, sofern es von Ihrer Seite aus keine Änderungsanforderungen gibt; wenn Sie Interesse an der Nutzung der Schnittstelle haben, dann wenden Sie sich bitte über den "Jetzt mehr erfahren"-Knopf unter FundraisingBox > Store > Integrations > Marketing-Automation via Brevo an uns.
  • Die FundraisingBox-Schnittstelle zu Ihrem Brevo-Account arbeitet unidirektional; es werden nur Daten von Ihrer FundraisingBox-Instanz an Ihren Brevo-Account übermittelt, aber es können keine Daten von Brevo in Ihre FundraisingBox-Instanz übertragen werden.
    • Voraussetzung ist, dass bei der Spende im Formular die Checkbox für das Formular-Feld "Informationswunsch" angeklickt wurde.
  • Die FundraisingBox-Schnittstelle überträgt ab dem Zeitpunkt ihrer Aktivierung Daten an Ihren Brevo-Account; falls Sie historische Daten aus Ihrer FundraisingBox-Instanz oder einem anderen externen System in Ihren Brevo-Account importieren möchten, dann müssen Sie diese Daten zuerst im Quell-System exportieren.

Voraussetzungen für die Nutzung der FundraisingBox-Schnittstelle zu Ihrem Brevo-Account

  • FundraisingBox:
  • Brevo:
    • Brevo-Account erfolgreich registriert (kostenlose Brevo-Variante reicht gemäß des Stands von 09/2024 aus)
    • Mindestens eine Kontakt-Liste in Brevo angelegt
    • API-Key in Brevo erzeugt
    • Listen-ID und API-Key sicher an uns übermittelt (bitte beides in einer Plain-Text-Datei speichern und diese Datei unter FundraisingBox > Account > Dateien als "Sonstiges" abgesichert hochladen)
    • Im Brevo-Account müssen bei den Einstellungen zu den Kontakten folgende Kontaktattribute als Attributfelder exakt so benannt und konfiguriert angelegt werden.
      Rufen Sie dafür die Kontaktattribut-Einstellungen auf und hinterlegen Sie die folgenden Felder inkl. Art:
  • Die Attribut Anrede muss eine bestimmte Reihenfolge haben (die IDs sind entscheidend), es muss exakt so angelegt werden und die Reihenfolge darf nicht verändert werden:

  • Die Einrichtung der Schnittstelle wurde von uns bestätigt.

FundraisingBox IP-Range als erlaubt in Brevo hinterlegen

Damit die FundraisingBox Brevo-Schnittstelle zu jederzeit Daten an Ihren Brevo-Account übertragen kann und in keine IP Blocks (die standardmäßig aktiv sind) hineinläuft, ist es wichtig, dass Sie im Brevo-Account die FundraisingBox IP-Adressen manuell als "erlaubt" hinterlegen - so verhindern Sie zukünftig in Fehler hineinzulaufen, das ist schnell erledigt:

  • im Brevo-Account unter Einstellungen > Sicherheit > Zugelassene IPs aufrufen

  • die FundraisingBox IP-Adressen als komplette Range (das klappt bei Brevo) manuell hinzu über den Button "Autorisierte IP-Adresse hinzufügen", wobei Sie "IPv4 Range (CIDR format)" auswählen und dann:

    • 52.29.0.0/16 als IP Adresse eintragen

    • über den Button "Authorize IP address" speichern

So können zukünftig keine automatischen IP Blockaden durch Brevo entstehen für unsere IP-Adressen.

Funktionsumfang der FundraisingBox-Brevo-Schnittstelle

  • Eine Transaktion wird über eines Ihrer FundraisingBox-Spendenformulare ausgelöst. Sie wird nur dann zu Brevo übertragen, wenn:
    • dabei im Formular (1) die Checkbox für den Informationswunsch aktiviert wurde (oft als Newsletter-Anmeldung in den Formular-Wordings angepasst) und (2) eine E-Mailadresse angegeben wurde, dann werden gewisse Daten der Transaktion an Ihren Brevo-Account übermittelt.
    • Zur Kenntnis: Die Transaktion hat ggf. weitere Datenpunkte in der FundraisingBox, die Sie auch in den Transaktions-Details sehen können, wenn Sie diese im Transaktionen-Bereich öffnen.
  • In Brevo wird entweder ein neuer Kontakt mit den Datenpunkten der Transaktion angelegt oder ein bereits bestehender Kontakt entsprechend aktualisiert
  • Konkret übertragen werden pro Transaktion die Datenpunkte aus der Liste oben (Kontaktattribute) der spendenden Person.
  • Wichtig: Die Datenpunkte Spendenbetrag, Rhythmus, Spendendatum, Quelle, Projekt und Einzelspende beziehen sich immer auf die zuletzt von dieser Person getätigte FundraisingBox-Transaktion! Diese Datenpunkte werden also bei einer neuen Transaktion beim Brevo-Kontakt immer wieder überschrieben. Der Datenpunkt Anzahl_Spenden ist jedoch kumulativ und gibt beim Brevo-Kontakt die Spenden-Transaktionsanzahl wieder, die Sie entsprechend so auch in Ihrer FundraisingBox-Instanz finden würden.
  • Die Datenpunkte für Anrede und Rhythmus werden als numerische FundraisingBox-ID übermittelt:
    • Anrede: 1 == "Herr", 2 == "Frau", 3 == "Divers", 4 == "Ehepaar" und 5 == "Familie"

    • Rhythmus: 0 == "einmalig", 1 == "monatlich", 3 == "vierteljährlich", 6 == "halbjährlich" und 12 == "jährlich"

Beispiel Kontakt

In Brevo könnte ein fiktiver Kontakt so aussehen:

Double-Opt-In-Abfrage via FundraisingBox und Brevo

  • Standardmäßig wird über Brevo auch mit der FundraisingBox-Schnittstelle kein Double-Opt-In von Kontakten abgefragt.
  • Auch wenn Sie bereits mit Ihrer FundraisingBox-Instanz über Ihre FundraisingBox-Spendenformulare mit Double-Opt-In-E-Mails die Zustimmung Ihrer Kontakte abfragen, wird dieser Datenpunkt nicht an Ihren Brevo-Account übermittelt! Der Grund dafür ist, dass der Datenpunkt für Double-Opt-In immer an einer einzelnen E-Mail-Adresse hängt, aber nicht an einem Kontakt oder einer Transaktion.
  • Wenn Sie Double-Opt-In-Abfragen über Brevo für Kontakte auslösen wollen, die in Ihrem Brevo-Account aus Ihrer FundraisingBox-Instanz heraus angelegt wurden, dann müssen Sie uns dies entsprechend mitteilen, da wir dies dann im Hintergrund für Sie entsprechend konfigurieren müssen!

Anpassungen der FundraisingBox-Brevo-Schnittstelle

  • Geringfügige Anpassungen der übermittelten Datenfelder können wir unter Umständen je nach Ressourcenlage auf Anfrage für Sie umsetzen.
  • Bei umfangreichen Anpassungen bieten wir an, Sie mit unserem Partner Qmart in Verbindung zu setzen, der Sie hier unterstützen kann; erstellen Sie dafür bitte ein Support-Ticket.
  • Bei strategischen Fragen zur Verwendung von Brevo wäre ebenfalls Qmart der Ansprechpartner, denen wir Ihnen empfehlen würden.


War diese Antwort hilfreich? Ja Nein

Lassen Sie uns bitte wissen, wie wir diesen Beitrag verbessern können.