Einrichtung 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 nutzt oder abschließt. Sie können eine Verbindung zu einer Custom API, HubSpot oder Salesforce herstellen – und für jede Integration können Sie genau festlegen, welche Datenfelder übertragen werden.

Erste Schritte

Navigieren Sie zu Einstellungen → Integrationen. Wenn noch keine Integrationen konfiguriert wurden, sehen Sie den Platzhalterbildschirm "Noch keine Webhook-Integrationen". Klicken Sie auf + Neue Integration hinzufügen (sowohl in der oberen rechten Ecke als auch in der Mitte der Seite verfügbar), um den Integrationsselektor zu öffnen.

Auswahl eines Integrationstyps

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

• Custom API — für jeden REST API-Endpunkt, den Sie kontrollieren
• HubSpot — für CRM- & Marketing-Automatisierung über HubSpot
• Salesforce — für Salesforce CRM

Klicken Sie auf die Kachel des Integrationstyps, den Sie konfigurieren möchten.

Custom API-Integration

Authentifizierung

Nachdem Sie Custom API ausgewählt haben, öffnet sich das Integration hinzufügen-Panel mit den folgenden Feldern:

Integrationsname Ein Label zur eigenen Referenz (standardmäßig "Custom API Integration"). Sie können es in etwas Beschreibendes umbenennen.

API-Endpunkt Die vollständige URL Ihres Webhook-Empfängers (z.B. https://api.example.com/webhook). Dies muss ein HTTPS-Endpunkt sein.

API-Schlüsseltyp Wählen Sie die Authentifizierungsmethode aus, die Ihr Endpunkt verwendet. Optionen sind:

Wenn Benutzerdefinierter Header ausgewählt ist, erscheint ein zusätzliches Feld Benutzerdefinierter Headername, in das Sie den Schlüssel für den Headernamen eingeben.

API-Schlüssel Das geheime Wort, das mit der gewählten Authentifizierungsmethode gesendet wird.

Verbindung überprüfen Klicken Sie auf diese Schaltfläche, um zu testen, ob Drimify Ihren Endpunkt mit den bereitgestellten Anmeldeinformationen erfolgreich erreichen kann, bevor Sie speichern.

HubSpot-Integration

Nach der Auswahl von HubSpot zeigt das Panel:

Integrationsname Standardmäßig "HubSpot Integration".

API-Schlüssel / Zugriffstoken Fügen Sie hier Ihr HubSpot Private App Access Token ein. HubSpot hat 2022 veraltete API-Schlüssel eingestellt, daher sollten Sie ein Private App-Token verwenden, das von Ihrem HubSpot-Konto unter Einstellungen → Integrationen → Private Apps generiert wird.

Verbindung überprüfen Testet das Token gegen die HubSpot-API, bevor Sie speichern.

Salesforce-Integration

Nach der Auswahl von Salesforce zeigt das Panel:

Integrationsname Standardmäßig "Salesforce Integration".

Salesforce-Domain Die URL Ihrer Salesforce-Instanz (z.B. yourcompany.my.salesforce.com).

Consumer Key und Consumer Secret Diese erhalten Sie von einer Verbundenen App, die in Salesforce unter Setup → App Manager → Neue Verbundene App konfiguriert ist. Drimify verwendet den OAuth 2.0-Zugriffsfluss mit Clientberechtigungsnachweisen.

Externe ID-Feldname 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 im Kontakt- oder Lead-Objekt. Dieses Feld muss in Salesforce als Externe ID markiert sein.

Quelle der externen ID Ein Dropdown-Menü, um auszuwählen, welches Drimify Datenfeld als Schlüssel zum Abgleichen verwendet werden soll (z.B. E-Mail).

Verbindung überprüfen Testet die Salesforce OAuth-Verbindung, bevor Sie speichern.### ⚠️ Pflichtfelder für Salesforce

Salesforce erzwingt Pflichtfelder auf Objektebene. Wenn du Leads einfügst oder aktualisierst, benötigt Salesforce mindestens:

• Nachname (lastName) — erforderlich für die Lead-Erstellung.

Wenn du Kontakte einfügst oder aktualisierst, benötigt Salesforce:

• Nachname (lastName) — erforderlich für die Kontakt-Erstellung.

E-Mail ist laut Salesforce-Schema standardmäßig nicht pflichtig, wird aber fast immer als Externe ID benötigt, um Datensätze korrekt abzugleichen und Duplikate bei einem Upsert zu vermeiden. Ohne eine zuverlässige Übereinstimmung der externen ID wird Salesforce doppelte Datensätze erstellen oder einen Fehler zurückgeben.

Best Practice: Immer mindestens Nachname und E-Mail beim Verbinden mit Salesforce abbilden. Das Auslassen des Nachnamens führt dazu, dass der Webhook einen Fehler zurückgibt und der Datensatz nicht erstellt oder aktualisiert wird.

Feldzuordnung

Für alle drei Integrationstypen verfügbar, ermöglicht die Feldzuordnung dir, genau anzugeben, welche Drimify-Datenfelder an deine Integration gesendet werden, und mit welchen Schlüsselbezeichnungen.

Klicke auf + Feld Hinzufügen, um eine Zuordnungszeile hinzuzufügen. Jede Zeile besteht aus:

• Webhook-Feld (links) — der Schlüsselname, der im ausgehenden Payload erscheint (du definierst das, um den erwarteten Feldnamen deiner Integration zu entsprechen)
• → Quelldatenfeld (rechtes Dropdown) — das Drimify-Datenfeld, das zugeordnet werden soll

Verfügbare Drimify-Quellefelder

Du kannst so viele Zeilen hinzufügen, wie benötigt werden. Zum Entfernen einer Zuordnung klicke auf das Mülleimer-Symbol auf der rechten Seite der Zeile.

In Arbeitsbereichen verfügbar

Am unteren Rand jeder Integrationsform gibt es den Abschnitt Verfügbar in Arbeitsbereichen. Verwende den Umschalter neben jedem Arbeitsbereich, um zu steuern, welche Arbeitsbereiche diese Integration nutzen können. Klicke auf Alle auswählen um sie für alle Arbeitsbereiche gleichzeitig zu aktivieren.

Speichern und Verwalten von Integrationen

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

Klicke auf Abbrechen, um nicht gespeicherte Änderungen zu verwerfen.

Aktualisiert am: 06/03/2026