CRM-Integration · Beta
BetaSuiteCRM mit Newsletter-Marketing verbinden
Importieren Sie SuiteCRM Contacts oder einzelne Target Lists in mailfino, übergeben Sie Formulardaten an Contacts und dokumentieren Sie Versandereignisse als Notes. Die API-V8-Anbindung ist als Beta verfügbar.
Datenfluss der Beta-Anbindung
Contacts und Target Lists für Newsletter nutzen
SuiteCRM liefert alle erreichbaren Contacts oder eine ausgewählte Target List. mailfino verarbeitet Formulare und Versand; aktivierte Ereignisse werden als Notes am verknüpften Contact dokumentiert.
Dokumentierter Beta-Umfang
Was die SuiteCRM Newsletter-Integration abbildet
Alle Kontakte importieren
Alle für den Integrationsbenutzer erreichbaren SuiteCRM Contacts können in eine mailfino-Empfängerliste übernommen werden.
Eine Liste als Quelle wählen
Eine sichtbare Target List kann als eingegrenzte Importquelle und als Ziel für Formularübermittlungen dienen.
Contacts stabil zuordnen
mailfino speichert die SuiteCRM Contact-ID als Remote-Bezug. Reimporte aktualisieren denselben lokalen Kontakt für dieselbe CRM-ID.
Contacts anlegen oder aktualisieren
Ein exakter E-Mail-Treffer wird aktualisiert, kein Treffer erzeugt einen neuen Contact und mehrere Treffer werden zur Prüfung gemeldet.
Contact-Felder zuordnen
E-Mail, Name, Telefon, Position und primäre Adressfelder können vorgeschlagen und beschreibbaren SuiteCRM-Feldern zugeordnet werden.
Versandereignisse festhalten
Zustellungen, Fehler, Abmeldungen und Beschwerden können als Notes mit technischem Marker am Contact gespeichert werden.
Typische Arbeitsabläufe
SuiteCRM und mailfino in klar getrennten Rollen
Newsletter an eine Target List
Sie pflegen die Zielgruppe in SuiteCRM, wählen die Target List als Importquelle und versenden den Newsletter aus mailfino.
Formular erweitert den CRM-Bestand
Ein mailfino-Formular aktualisiert einen eindeutigen Contact oder legt einen neuen an. Optional wird er einer Target List hinzugefügt.
Newsletter-Reaktionen als Notes
Ausgewählte Versandereignisse erscheinen als Note am verknüpften Contact, während Sperren und Abmeldungen weiterhin in mailfino gesteuert werden.
Voraussetzungen und Einrichtung
SuiteCRM API V8 mit OAuth2 Client Credentials
Benötigt werden eine erreichbare API V8, ein aktiver SuiteCRM-Benutzer und ein vertraulicher OAuth2-Client vom Typ Client Credentials. Seine Rechte begrenzen den Datenzugriff von mailfino.
- Eigenen SuiteCRM-Benutzer mit minimalen Rechten vorbereiten
- Vertraulichen OAuth2-Client „Client Credentials“ anlegen
- Basis-URL, Client-ID und Client-Secret in mailfino eintragen
- Verbindung und Zugriff auf Contacts sowie Feldmetadaten prüfen
- Importquelle, Feldmapping, Formulare, Target Lists und Notes konfigurieren
Berechtigungen
Nur die für den Datenfluss nötigen Module freigeben
Der Integrationsbenutzer benötigt Leserechte auf Contacts, Target Lists und Feldmetadaten. Schreibrechte hängen davon ab, ob Formulare und Touchpoints genutzt werden.
- Formular-Sync: Contacts und Target-List-Beziehungen schreiben
- Touchpoints: Notes am Contact schreiben
- Target Lists werden nur angezeigt, wenn der Benutzer ProspectLists lesen darf
- Self-Hosted SuiteCRM benötigt ein funktionierendes API-V8-OAuth-Keypair und passende Dateirechte
- Client-Secret geschützt speichern; mailfino gibt es später nicht wieder aus
Beta-Grenzen und Einwilligung
Transparenter Umfang statt Vollsynchronisation
Die Beta verbindet ausgewählte Contacts-, Target-List-, Formular- und Notes-Abläufe. Sie ersetzt weder die CRM-Datenpflege noch die mailfino-Logik für Einwilligungen und Sperren.
- Entfernte oder nicht mehr erreichbare SuiteCRM Contacts werden in V1 nicht automatisch aus mailfino gelöscht
- Doppelte E-Mail-Adressen verhindern eine automatische Aktualisierung durch Formulare
- Eine automatische Account-Anlage oder Account-Verknüpfung gehört noch nicht zum Beta-Schreibpfad
- SuiteCRM Suppression Lists verändern nicht automatisch die mailfino-Versandberechtigung
- Webhooks sind in dieser Beta nicht aktiviert; Änderungen kommen über Import oder Reimport
- Abmeldungen, Beschwerden und Sperren bleiben in mailfino führend
FAQ zur Beta
Fragen zur SuiteCRM Newsletter-Integration
Ist die SuiteCRM-Integration produktiver Standard?
Nein. Die API-V8-Anbindung ist als Beta dokumentiert. Berechtigungen, Datenqualität und Arbeitsabläufe sollten vor dem produktiven Einsatz geprüft werden.
Welche Kontakte lassen sich importieren?
Sie können alle erreichbaren Contacts oder eine einzelne, für den Integrationsbenutzer sichtbare Target List als Quelle wählen.
Wie verhindert mailfino Dubletten bei einem Reimport?
Die SuiteCRM Contact-ID wird als stabiler Remote-Bezug gespeichert. Ein späterer Reimport aktualisiert denselben lokalen Kontakt für dieselbe ID.
Was passiert bei einer Formularübermittlung?
Genau ein Contact mit passender E-Mail-Adresse 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 allgemeines Formularziel gewählt werden; auch Checkbox-Aktionen können Beziehungen hinzufügen. Bestehende Beziehungen werden nicht doppelt angelegt.
Welche Versandereignisse werden als Notes unterstützt?
Dokumentiert sind erfolgreiche und fehlgeschlagene Zustellungen, Abmeldungen und Beschwerden. Ein technischer Marker verhindert doppelte Notes bei Wiederholungen.
Werden Änderungen per SuiteCRM-Webhook übernommen?
Nein. Webhooks sind in dieser Beta nicht aktiviert. Änderungen werden über den normalen Import oder Reimport übernommen.
SuiteCRM-Beta prüfen
Welche Contacts, Target Lists und Notes sollen verbunden werden?
Klären Sie API-V8-Erreichbarkeit, OAuth-Rechte und Datenflüsse, bevor Sie die Beta-Anbindung produktiv einsetzen.