SuiteCRM OAuth2-Client vorbereiten
Voraussetzungen
- SuiteCRM mit erreichbarer API V8
- ein aktiver SuiteCRM-Benutzer für die Anbindung
- Leserechte auf Contacts, Target Lists und Feldmetadaten
- für Formular-Sync zusätzlich Schreibrechte auf Contacts und Target-List-Beziehungen
- für Touchpoints zusätzlich Schreibrechte auf Notes
OAuth2-Client anlegen
- Öffnen Sie in SuiteCRM den Administrationsbereich.
- Open OAuth2 Clients and Tokens.
- Erstellen Sie einen vertraulichen Client vom Typ Client Credentials.
- Ordnen Sie dem Client den Benutzer zu, dessen Rechte mailfino verwenden soll.
- Kopieren Sie Client ID und Client Secret direkt in Ihren Passwortmanager. Das Secret wird später nicht aus mailfino zurückgegeben.
SuiteCRM benötigt für API V8 außerdem ein gültiges OAuth-Keypair. Wenn bereits andere API-V8-Clients funktionieren, ist dieses normalerweise vorhanden. Bei einer neuen Self-Hosted-Installation folgen Sie der offiziellen SuiteCRM-Anleitung für die API-V8-Schlüssel und Dateirechte.
Daten vorbereiten
Kontakte benötigen für den normalen mailfino-Abgleich eine eindeutige E-Mail-Adresse. Wenn dieselbe E-Mail-Adresse mehrfach in SuiteCRM vorkommt, kann Formular-Sync den passenden Contact nicht eindeutig bestimmen und markiert das Ereignis zur Prüfung.
Target Lists können als Importquelle und Formularziel verwendet werden. Legen Sie sprechende Listen wie Newsletter oder Interessenten an. SuiteCRM Suppression Lists verändern nicht automatisch die mailfino-Versandberechtigung; Sperren und Abmeldungen bleiben in mailfino führend.
You need a SuiteCRM installation with an accessible API V8, an active integration user, and read access to Contacts, Target Lists, and field metadata. Form sync additionally requires write access to Contacts and Target List relationships. Touchpoints require write access to Notes.
In the SuiteCRM administration area, open OAuth2 Clients and Tokens. Create a confidential client of type Client Credentials and assign the integration user. Copy the client ID and client secret to your password manager. The secret will not be displayed by mailfino later.
API V8 also requires a valid OAuth key pair. If other API V8 clients already work, it is usually configured. For a new self-hosted installation, follow the official SuiteCRM instructions for the key pair and file permissions.
Contacts should have an unambiguous email address. Duplicate email addresses cannot be updated automatically by form sync. Target Lists such as Newsletter prospects can be used both as import sources and form targets.