CRM-Integration · Dokumentiert
Salesforce mit Newsletter-Marketing verbinden
Nutzen Sie Salesforce-Kontakte und Kampagnen als Newsletter-Zielgruppen, übertragen Sie mailfino-Formulare in das CRM und dokumentieren Sie Versandereignisse als Aktivitäten am Kontakt.
Datenfluss
Salesforce-Zielgruppen in mailfino nutzen und Reaktionen zurückführen
Die Anbindung verbindet klar definierte Objekte: Contacts und Campaigns liefern Zielgruppen; mailfino übernimmt Formular und Versand; Tasks dokumentieren ausgewählte Ereignisse am Salesforce-Kontakt.
Dokumentierter Funktionsumfang
Kontakte, Kampagnen, Formulare und Aktivitäten
Kontakte importieren
Alle erreichbaren Salesforce Contacts mit verwendbarer E-Mail-Adresse können in eine mailfino-Empfängerliste übernommen werden.
Kampagnen als Quelle nutzen
Salesforce Campaigns können als gezielte Importquelle dienen und unterschiedlichen mailfino-Listen zugeordnet werden.
Contacts pflegen
Formularübermittlungen lassen sich mit definierter Feldzuordnung an Salesforce übergeben und optional einer Kampagne hinzufügen.
Standard- und Custom Fields zuordnen
mailfino lädt beschreibbare Contact-Felder aus der Salesforce-Organisation. Formularspezifische Zuordnungen können globale Vorgaben überschreiben.
Versandereignisse speichern
Zustellungen, Fehler, Abmeldungen und Beschwerden können als Salesforce Task am verknüpften Contact dokumentiert werden.
Kontakte erneut abgleichen
Salesforce Contact-ID und E-Mail-Adresse helfen bei der Zuordnung. Aktivierte Importe werden automatisch synchronisiert und können manuell gestartet werden.
Typische Arbeitsabläufe
Salesforce und mailfino im praktischen Zusammenspiel
Newsletter an Campaign Members
Eine Salesforce-Kampagne bündelt die Zielgruppe. mailfino übernimmt deren Contacts in eine Versandliste und hält die Verknüpfung zum CRM-Kontakt.
Lead- oder Interessenformular
Ein Formular aktualisiert einen bestehenden Contact oder übergibt einen neuen Datensatz. Themen-Checkboxen können zusätzliche Campaign Memberships auslösen.
Newsletter-Aktivität am Kontakt
Ausgewählte Versandresultate erscheinen als Tasks am passenden Contact, damit Vertrieb oder Service den dokumentierten Kommunikationsverlauf einsehen können.
Voraussetzungen und Einrichtung
OAuth-Zugriff über eine externe Salesforce Client-Anwendung
Salesforce benötigt eine externe Client-Anwendung mit API- und Refresh-Token-Zugriff. Der verbundene Benutzer bestimmt, welche Contacts, Campaigns, Felder und Tasks mailfino verwenden darf.
- Externe Client-Anwendung mit Authorization Code und PKCE vorbereiten
- Scopes „api“ sowie „refresh_token/offline_access“ freigeben
- Exakte mailfino-Callback-URL hinterlegen
- Salesforce in mailfino anmelden und Verbindung prüfen
- Importquellen, Feldzuordnung, Formulare und Aktivitäten konfigurieren
Cloud und Self-Hosting
Die Callback-URL folgt Ihrer mailfino-Installation
In der mailfino Cloud wird die dokumentierte Callback-URL von app.mailfino.de verwendet. Bei Self-Hosting muss Salesforce auf die öffentlich erreichbare Adresse Ihrer eigenen Installation zurückleiten können.
- Client-ID und Client-Secret gehören in die geschützte Server-Konfiguration
- Ein Refresh Token ist für den dauerhaften Zugriff erforderlich
- Der Salesforce-Benutzer sollte nur die benötigten Objekte und Aktionen freigeben
- Der Scope „Full access“ ist für die dokumentierte Anbindung nicht erforderlich
Grenzen und Einwilligung
CRM-Aktivitäten dokumentieren, Versandberechtigung separat steuern
Eine Salesforce-Aktivität zeigt ein Versandereignis, ersetzt aber weder die mailfino-Sperrliste noch die fachliche Prüfung einer Einwilligung.
- Es findet keine pauschale Vollsynchronisation sämtlicher Salesforce-Daten statt
- Campaigns benötigen Leserechte; je nach Organisation kann „Marketing User“ erforderlich sein
- Tasks können nur für zuvor verknüpfte Contacts geschrieben werden
- Pflichtfelder, nicht beschreibbare Felder oder gelöschte Kampagnen können Formularübergaben stoppen
- Double Opt-in, Abmeldungen und Versandberechtigungen bleiben im Newsletter-Prozess zu verwalten
FAQ
Fragen zur Salesforce Newsletter-Integration
Kann mailfino alle Salesforce Contacts importieren?
Ja, sofern sie für den verbundenen Benutzer erreichbar sind und eine verwendbare E-Mail-Adresse besitzen. Alternativ kann eine Salesforce Campaign als Quelle dienen.
Kann eine Salesforce Campaign eine Newsletter-Zielgruppe bilden?
Ja. Sichtbare Kampagnen können als Importquelle gewählt und einer mailfino-Empfängerliste zugeordnet werden.
Unterstützt die Feldzuordnung eigene Salesforce-Felder?
mailfino lädt die beschreibbaren Contact-Felder der Organisation. Damit können auch Custom Fields angeboten werden, sofern der verbundene Benutzer sie sehen und schreiben darf.
Wie werden Formulardaten an Salesforce übergeben?
Formularfelder werden Contact-Feldern zugeordnet. Themen-Checkboxen können einen Contact zusätzlich als Campaign Member in ausgewählte Kampagnen aufnehmen.
Welche Versandereignisse können als Aktivitäten erscheinen?
Dokumentiert sind erfolgreiche und fehlgeschlagene Zustellungen, Abmeldungen und Spam-Beschwerden. Die Speicherung erfolgt als Salesforce Task am Contact.
Warum braucht die Integration einen Refresh Token?
Er erlaubt mailfino, den Salesforce-Zugriff nach Ablauf einer Session zu erneuern. Ohne den Scope „refresh_token/offline_access“ ist dafür eine erneute Anmeldung nötig.
Was geschieht bei einer fehlgeschlagenen Formularübergabe?
mailfino zeigt die Übergabe im Bereich „Probleme“. Nach Korrektur von Daten, Feldrechten oder Kampagnenzugriff kann sie erneut verarbeitet werden.
Salesforce-Prozess abstimmen
Welche Contacts, Campaigns und Aktivitäten sollen verbunden werden?
Definieren Sie den benötigten Datenfluss und die minimalen Berechtigungen, bevor die Salesforce-Anbindung produktiv eingesetzt wird.