Einrichten von Webhook-Integrationen in Drimify

Die webhook-integrationen von Drimify ermöglichen es Ihnen, Teilnehmerdaten automatisch an externe Dienste zu senden, sobald ein Benutzer Ihre App abschließt oder mit ihr interagiert. Sie können eine Verbindung zu einer Custom API, HubSpot oder Salesforce herstellen — und dabei genau festlegen, welche Datenfelder übermittelt werden sollen.

Erste Schritte

Navigieren Sie zu My Account → Integrations. Wenn noch keine Integrationen konfiguriert wurden, sehen Sie den Platzhalterbildschirm "No webhook-integrationen yet". Klicken Sie auf + Hinzufügen Neue Integration (verfügbar sowohl in der oberen rechten Ecke als auch in der Mitte der Seite), um den Integrationsselektor zu öffnen.

Auswahl eines Integrationstyps

Ein Modal mit dem Titel "Select Webhook Integration" erscheint. Sie können nach Kategorien filtern, indem Sie das Dropdown-Menü verwenden (standardmäßig auf All eingestellt). Die drei verfügbaren Integrationen sind:

• Custom API — für jeden von Ihnen verwalteten REST-API-Endpunkt
• HubSpot — für CRM- und Marketingautomatisierung über HubSpot
• Salesforce — für Salesforce CRM

Klicken Sie auf die Kachel für den Integrationstyp, den Sie konfigurieren möchten.

Custom API Integration

Authentifizierung

Nach der Auswahl von Custom API öffnet sich das Add Integration-Panel mit folgenden Feldern:

• Integration Name Ein Etikett für Ihre eigene Referenz (standardmäßig "Custom API Integration"). Sie können es in etwas Beschreibendes umbenennen.
• API Endpoint Die vollständige URL Ihres Webhook-Empfängers (z.B. https://api.example.com/webhook). Dies muss ein HTTPS-Endpunkt sein.
• API Key Type Wählen Sie die Authentifizierungsmethode aus, die Ihr Endpunkt verwendet. Optionen sind:

• Wenn Custom Header ausgewählt ist, erscheint ein zusätzliches Feld Custom Header Name, in das Sie den Header-Schlüssel eingeben.
• API Key Das geheime Schlüsselwort, das mit der gewählten Authentifizierungsmethode gesendet wird.
• Verify Connection Klicken Sie auf diese Schaltfläche, um zu testen, ob Drimify Ihr Endpunkt mit den bereitgestellten Anmeldeinformationen erreichen kann, bevor Sie speichern.

HubSpot Integration

Nach der Auswahl von HubSpot zeigt das Panel:

• Integration Name Standardmäßig "HubSpot Integration".
• API Key / Access Token Fügen Sie hier Ihr HubSpot Private App Access Token ein. HubSpot hat 2022 die Verwendung von klassischen API-Schlüsseln eingestellt, daher sollten Sie ein Private App Token verwenden, das aus Ihrem HubSpot-Konto unter Settings → Integrationen → Private Apps generiert wurde.
• Verify Connection Testet das Token mit der HubSpot API, bevor Sie speichern.

Salesforce Integration

Nach der Auswahl von Salesforce zeigt das Panel:

• Integration Name Standardmäßig "Salesforce Integration".
• Salesforce Domain Ihre Salesforce Instanz-URL (z.B. yourcompany.my.salesforce.com).
• Consumer Key und Consumer Secret Diese werden von einer Verbundenen App in Salesforce unter Setup → App Manager → Neue Verbundene App abgerufen. Drimify verwendet den OAuth 2.0 Client Credentials Flow.
• External id-feld Name Der API-Name des Feldes, das zum Abgleichen (Upsert) von Datensätzen verwendet wird — typischerweise Email_External_Id__c oder ein benutzerdefiniertes externes ID-Feld am Kontakt- oder Lead-Objekt. Dieses Feld muss in Salesforce als External ID gekennzeichnet sein.
• External ID Source Ein Dropdown-Menü zur Auswahl, welches Drimify Datenfeld als Übereinstimmungsschlüssel verwendet werden soll (z.B. Email).
• Verify Connection Testet die Salesforce OAuth-Verbindung, bevor Sie speichern.

⚠️ Pflichtfelder für Salesforce

Salesforce erzwingt pflichtfelder auf der Objektebene. Wenn Sie Leads einfügen oder aktualisieren, verlangt Salesforce mindestens:

• Nachname (lastName) — erforderlich für die Erstellung von Leads

Wenn Sie Kontakte einfügen oder aktualisieren, benötigt Salesforce:

• Nachname (lastName) — erforderlich für die Erstellung von Kontakten

E-Mail ist laut Salesforce-Standard-Schema nicht zwingend erforderlich, wird jedoch fast immer als Externe ID benötigt, um Datensätze bei einer Aktualisierung korrekt zuzuordnen und Duplikate zu vermeiden. Ohne eine zuverlässige Übereinstimmung der Externen ID erstellt Salesforce möglicherweise doppelte Datensätze oder gibt einen Fehler aus.

Best Practice: Immer mindestens Nachname und E-Mail abgleichen, wenn Sie sich mit Salesforce verbinden. Das Auslassen des Nachnamens führt dazu, dass der Webhook einen Fehler zurückgibt und der Datensatz wird weder erstellt noch aktualisiert.

Feldzuordnung

Für alle drei Integrationstypen verfügbar, ermöglicht die Feldzuordnung es Ihnen, genau anzugeben, welche Drimify-Datenfelder an Ihre Integration gesendet werden und unter welchen Schlüsselnamen.

Klicken Sie auf + Feld hinzufügen, um eine Zuordnungsreihe hinzuzufügen. Jede Reihe besteht aus:

• Webhook-Feld (links) — Der Schlüsselnamen, der im ausgehenden Payload erscheint (Sie definieren dies entsprechend den von Ihrer Integration erwarteten Feldnamen)
• → Quellfeld (rechtes Dropdown) — Das Drimify Datenfeld, das Sie zuordnen möchten

Verfügbare Drimify-Quellfelder

Sie können so viele Reihen hinzufügen, wie benötigt werden. Zum Entfernen einer Zuordnung klicken Sie auf das Papierkorb-Icon auf der rechten Seite der Reihe.

Verfügbar in Arbeitsbereiche

Am Ende jedes Integrationsformulars befindet sich ein Verfügbar in Arbeitsbereichen-Abschnitt. Verwenden Sie den Umschalter neben jedem Arbeitsbereich, um zu steuern, welche Arbeitsbereiche diese Integration nutzen können. Klicken Sie auf Alle auswählen, um es für alle Arbeitsbereiche gleichzeitig zu aktivieren.

Speichern und Verwalten von Integrationen

Sobald alle Felder ausgefüllt sind, klicken Sie auf Änderungen speichern, um die Integration zu erstellen. Diese erscheint dann in der Hauptliste der Integrationen. Sie können bestehende Integrationen jederzeit aus dieser Liste bearbeiten oder löschen.

Klicken Sie auf Abbrechen, um nicht gespeicherte Änderungen zu verwerfen.

Aktualisiert am: 10/03/2026