CRM-Integration · Beta
BetaEspoCRM mit Newsletter-Marketing verbinden
Importieren Sie EspoCRM Contacts oder einzelne Target Lists, übertragen Sie mailfino-Formulare in das CRM und dokumentieren Sie Versandereignisse im Contact Stream. Die REST-API-Anbindung ist als Beta verfügbar.
Datenfluss der Beta-Anbindung
Contacts und Target Lists mit mailfino verbinden
EspoCRM liefert alle erreichbaren Contacts oder eine ausgewählte Target List. mailfino übernimmt Formulare und Newsletter; aktivierte Reaktionen werden als Beiträge im Stream des verknüpften Contacts festgehalten.
Dokumentierter Beta-Umfang
Was die EspoCRM Newsletter-Integration heute kann
Alle Kontakte importieren
Alle für den API-Benutzer erreichbaren Contacts können in eine definierte mailfino-Empfängerliste übernommen werden.
Listen als Quelle verwenden
Eine sichtbare EspoCRM Target List kann als eingegrenzte Importquelle und als Ziel für Formularübermittlungen dienen.
Kontakte stabil verknüpfen
mailfino speichert die EspoCRM Contact-ID als Remote-Key. Ein Reimport aktualisiert denselben lokalen Datensatz für dieselbe CRM-ID.
Contacts pflegen
Ein exakter E-Mail-Treffer wird aktualisiert, kein Treffer legt einen neuen Contact an und mehrere Treffer erfordern eine Prüfung.
Schreibbare Felder zuordnen
Formularfelder werden beschreibbaren Contact-Feldern zugewiesen; interne oder nicht beschreibbare Felder erscheinen absichtlich nicht als Ziel.
Versandereignisse dokumentieren
Zustellungen, Fehler, Abmeldungen und Beschwerden können als Beiträge im Contact Stream gespeichert werden.
Typische Arbeitsabläufe
EspoCRM und mailfino im praktischen Einsatz
Newsletter an eine Target List
Sie organisieren die gewünschte Zielgruppe in EspoCRM und übernehmen die sichtbare Target List in eine mailfino-Empfängerliste.
Formular aktualisiert Contacts
Ein mailfino-Formular schreibt ausgewählte Felder an einen eindeutig gefundenen Contact oder legt einen neuen Datensatz an.
Versandverlauf im Contact Stream
Aktivierte Ereignisse erscheinen als Stream-Beitrag am verknüpften Contact und ergänzen die dort sichtbare Kommunikationshistorie.
Voraussetzungen und Einrichtung
Dedizierter API-Benutzer mit eigener EspoCRM-Rolle
Die Anbindung benötigt eine erreichbare EspoCRM REST API und den API-Key eines aktiven API Users. Eine eigene Rolle begrenzt den Zugriff auf Contacts, Target Lists und Stream-Beiträge.
- Eigene Rolle für mailfino in EspoCRM anlegen
- API User erstellen, Rolle zuweisen und API-Key sicher übernehmen
- Basis-URL und API-Key im mailfino-Anbindungsmanager eintragen
- Verbindung und Zugriff auf Contacts sowie Feldmetadaten prüfen
- Importquelle, Zielliste, Felder, Formulare und Stream-Touchpoints konfigurieren
Berechtigungen
Lesen, Schreiben und Stream-Zugriff getrennt freigeben
Für reinen Import reichen Leserechte auf Contacts, Target Lists und Contact-Metadaten. Formular-Sync und Touchpoints benötigen zusätzliche Schreibrechte.
- Contact: Lesen; für Formular-Sync zusätzlich Erstellen und Bearbeiten
- Target List: Lesen; für Formularzuordnung zusätzlich Bearbeiten
- Stream-Beiträge: Schreiben für dokumentierte Versandereignisse
- Webhook-Rechte sind für den dokumentierten Beta-Umfang nicht erforderlich
- API-Key geschützt speichern; mailfino gibt ihn nach dem Speichern nicht wieder aus
Beta-Grenzen und Einwilligung
Gezielter Datenaustausch ohne automatische Vollsynchronisation
Die Beta bildet definierte Contact-, Target-List-, Formular- und Stream-Abläufe ab. mailfino bleibt für Newsletter-Einwilligungen, Sperren und Abmeldungen führend.
- Entfernte EspoCRM Contacts werden in der Beta nicht automatisch aus mailfino gelöscht
- Mehrere Contacts mit derselben E-Mail-Adresse werden durch Formulare nicht automatisch verändert
- Interne oder nicht beschreibbare Contact-Felder stehen nicht als Formularziel bereit
- Webhooks werden in dieser Beta noch nicht empfangen; Änderungen kommen über Import oder Reimport
- Stream-Beiträge dokumentieren Ereignisse, ersetzen aber keine Versandberechtigung
- Sperren, Abmeldungen und Beschwerden bleiben in mailfino führend
FAQ zur Beta
Fragen zur EspoCRM Newsletter-Integration
Ist die EspoCRM-Integration bereits produktiver Standard?
Nein. Die REST-API-Anbindung ist als Beta dokumentiert. Rolle, Datenqualität und gewünschte Abläufe sollten vor dem produktiven Einsatz geprüft werden.
Welche Contacts lassen sich importieren?
Als Quelle stehen alle erreichbaren Contacts oder eine einzelne, für den API-Benutzer sichtbare Target List zur Verfügung.
Wie werden Kontakte bei einem Reimport zugeordnet?
mailfino speichert die EspoCRM Contact-ID als stabilen Remote-Key. Derselbe Contact wird bei einem Reimport aktualisiert, statt für dieselbe ID neu angelegt zu werden.
Was geschieht bei einer Formularübermittlung?
Ein exakter E-Mail-Treffer wird aktualisiert, kein Treffer erzeugt einen neuen Contact und mehrere Treffer werden zur Prüfung gemeldet.
Kann ein Formular einen Contact einer Target List hinzufügen?
Ja. Eine Target List kann als Ziel gewählt werden. Bestehende Beziehungen werden nicht doppelt angelegt.
Welche Ereignisse können im Contact Stream erscheinen?
Unterstützt werden erfolgreiche und fehlgeschlagene Zustellungen, Abmeldungen und Beschwerden. Ein stabiler Marker verhindert doppelte Beiträge bei einer Wiederholung.
Werden EspoCRM-Webhooks genutzt?
Nein. Der Webhook-Empfang ist in dieser Beta noch nicht aktiviert. Änderungen werden über Import oder Reimport übernommen.
EspoCRM-Beta prüfen
Welche Contacts, Target Lists und Stream-Ereignisse brauchen Sie?
Stimmen Sie API-Rolle, Datenqualität und gewünschte Rückschreibungen vor dem produktiven Einsatz ab.