Dokumentation
soulclick.ch

Dynamics 365 Synchronisation

Diese Anleitung beschreibt die Einrichtung und Funktionsweise der Synchronisation zwischen Soulclick und Microsoft Dynamics 365.

📍

Voraussetzung: Die Dynamics-365-Integration wird individuell eingerichtet. Kontaktiere den Soulclick-Support für die Aktivierung.

Überblick

Die Integration synchronisiert Daten in Echtzeit von Soulclick nach Dynamics 365. Folgende Daten werden übertragen:

DatenRichtungBeschreibung
KontakteSoulclick → DynamicsName, E-Mail, Adresse, Telefon, Anrede, Kontakttyp
SpendentransaktionenSoulclick → DynamicsBetrag, Datum, Produkt, Zahlungsmethode, Referenznummer
Newsletter-AbonnementsSoulclick → DynamicsOpt-In-Status, Bestätigungsdatum, Sprache
DauerspendenSoulclick → DynamicsIntervall, Status, nächstes Fälligkeitsdatum

Voraussetzungen

  • Ein aktives Microsoft Dynamics 365-Konto mit Web-API-Zugriff
  • Eine App-Registrierung in Azure AD mit den nötigen Berechtigungen
  • Zugang zum Soulclick Admin

Einrichtung

Schritt 1: Azure AD App-Registrierung

  1. Melde dich im Azure-Portal an.
  2. Navigiere zu Azure Active Directory → App-Registrierungen → Neue Registrierung.
  3. Vergib einen Namen (z. B. „Soulclick CRM Sync").
  4. Notiere die Anwendungs-ID (Client ID) und die Verzeichnis-ID (Tenant ID).
  5. Erstelle unter Zertifikate & Geheimnisse ein neues Client Secret.

Schritt 2: Dynamics-365-Berechtigungen

  1. In der App-Registrierung → API-Berechtigungen → Berechtigung hinzufügen.
  2. Wähle Dynamics CRM → Delegierte Berechtigungen → user_impersonation.
  3. Erteile die Administratorzustimmung.

Schritt 3: Konfiguration übermitteln

Übermittle folgende Daten an den Soulclick-Support:

FeldBeschreibung
Dynamics URLDie URL deiner Dynamics-Instanz (z. B. https://org.crm4.dynamics.com)
Client IDAnwendungs-ID aus der Azure-App-Registrierung
Client SecretDer erstellte geheime Clientschlüssel
Tenant IDVerzeichnis-ID aus der Azure-App-Registrierung

Das Soulclick-Team richtet die Verbindung ein und konfiguriert das Feldmapping.

Feldmapping

Das Feldmapping definiert, welche Soulclick-Felder in welche Dynamics-365-Felder geschrieben werden. Das Standard-Mapping umfasst:

Kontakte

Soulclick-FeldDynamics-365-FeldHinweis
Vornamefirstname
Nachnamelastname
E-Mailemailaddress1
Strasseaddress1_line1
PLZaddress1_postalcode
Ortaddress1_city
Landaddress1_country
Telefontelephone1
Anredesalutationm/w/n
FirmacompanynameNur bei B2B-Kontakten

Transaktionen

Soulclick-FeldDynamics-365-EntitätHinweis
SpendenbetragBenutzerdefiniertWird als eigene Entität angelegt
ZahlungsmethodeBenutzerdefiniertKreditkarte, TWINT, Rechnung usw.
SpendenproduktBenutzerdefiniertZuordnung zum Spendenzweck
Transaktions-IDBenutzerdefiniertEindeutige Referenz
💡

Das Feldmapping kann individuell angepasst werden. Benutzerdefinierte Felder in Dynamics 365 werden ebenfalls unterstützt.

Synchronisationsverhalten

SzenarioVerhalten
Neue SpendeKontakt wird angelegt (falls neu) oder aktualisiert; Transaktion wird erstellt
Kontaktdaten geändertÄnderungen werden bei der nächsten Transaktion übertragen
DuplikaterkennungSoulclick prüft anhand der E-Mail-Adresse, ob der Kontakt bereits existiert
Sync-FehlerFehlgeschlagene Synchronisationen werden automatisch wiederholt; bei dauerhaften Fehlern wird das Soulclick-Team benachrichtigt

Fehlerbehebung

ProblemLösung
Kontakt wird nicht synchronisiertPrüfe, ob die Azure-App-Berechtigungen korrekt gesetzt und die Administratorzustimmung erteilt ist
Fehler „401 Unauthorized"Client Secret ist abgelaufen. Erstelle ein neues Secret und übermittle es dem Soulclick-Support
Felder fehlen in DynamicsPrüfe das Feldmapping. Benutzerdefinierte Felder müssen zuerst in Dynamics angelegt werden
Doppelte KontakteStelle sicher, dass die E-Mail-Adresse als Duplikaterkennungsregel in Dynamics konfiguriert ist

Updated 3 days ago