Einrichten von Webhook-Integrationen in Drimify

Drimifys Webhook-Integrationen ermöglichen es Ihnen, Teilnehmerdaten automatisch an externe Dienste zu senden, sobald ein Benutzer mit Ihrer App interagiert oder eine Aufgabe abgeschlossen hat. Sie können sich mit einer Custom API, HubSpot oder Salesforce verbinden — und für jeden Dienst können Sie genau festlegen, welche Datenfelder übertragen werden.

Erste Schritte

Navigieren Sie zu Mein Konto → Integrationen. Falls noch keine Integrationen konfiguriert sind, wird Ihnen der "Noch keine Webhook-Integrationen" Platzhalter angezeigt.

Klicken Sie auf + Neue Integration hinzufügen (verfügbar sowohl in der oberen rechten Ecke als auch in der Mitte der Seite), um den Integrationsauswähler zu öffnen.

Auswahl eines Integrationstyps

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

• Custom API — für jeden REST-API-Endpunkt, den Sie kontrollieren
• HubSpot — für CRM und Marketingautomatisierung über HubSpot
• Salesforce — für Salesforce CRM

Klicken Sie auf die Kachel des gewünschten Integrationstyps, um die Konfiguration zu starten.

Custom API Integration

Authentifizierung

Nach der Auswahl von Custom API öffnet sich das Panel Integration hinzufügen mit den folgenden Feldern:

• Integrationsname Ein Label zur eigenen Referenz (standardmäßig "Custom API Integration"). Sie können dies in eine beschreibende Bezeichnung umbenennen.
• API-Endpunkt Die vollständige URL Ihres Webhook-Empfängers (z.B. https://api.beispiel.com/webhook). Dies muss ein HTTPS-Endpunkt sein.
• HTTP-Methode :

Wählen Sie die HTTP-Methode, mit der die Webhook-Anfrage an Ihren Endpunkt gesendet wird.

Die Optionen sind:

• POST — Empfohlen für die meisten Anwendungsfälle (erstellt eine neue Ressource oder sendet Daten)
• PUT — Ersetzt eine vorhandene Ressource vollständig
• PATCH — Aktualisiert eine vorhandene Ressource teilweise

Wählen Sie die Methode, die der Erwartung Ihrer API zur Datenübertragung entspricht.

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

• Wenn Custom Header ausgewählt ist, erscheint ein zusätzliches Custom Header Name Feld, in das Sie den Header-Schlüssel eintragen.
• API-Schlüssel Das geheime Passwort, das mit der gewählten Authentifizierungsmethode gesendet wird.
• Verbindung überprüfen Klicken Sie auf diesen Button, um zu testen, ob Drimify erfolgreich mit den bereitgestellten Zugangsdaten auf Ihren Endpunkt zugreifen kann, bevor Sie die Einstellungen speichern.

HubSpot Integration

Nach der Auswahl von HubSpot wird im Panel Folgendes angezeigt:

• Integrationsname Standardmäßig "HubSpot Integration".
• API-Schlüssel / Zugriffstoken Fügen Sie hier Ihr HubSpot Private App Access Token ein. HubSpot hat 2022 die Legacy-API-Schlüssel abgeschafft, also sollten Sie ein Private App Token verwenden, das in Ihrem HubSpot-Konto unter Einstellungen → Integrationen → Private Apps generiert wurde.
• Verbindung überprüfen Testet das Token gegen die HubSpot API, bevor die Einstellungen gespeichert werden.## Salesforce-Integration

Nachdem Sie Salesforce ausgewählt haben, zeigt das Panel Folgendes an:

• Integrationsname Standardmäßig auf "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 Verknüpften App, die in Salesforce unter Setup → App-Manager → Neue Verknüpfte App konfiguriert ist. Drimify nutzt den OAuth 2.0 Client-Credentials-Flow.
• Externe ID-Feldname Der API-Name des Felds, 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 Übereinstimmungsschlüssel verwendet werden soll (z.B. Email).
• Verbindung testen Prüft die Salesforce OAuth-Verbindung vor dem Speichern.

⚠️ Erforderliche Felder für Salesforce

Salesforce erzwingt erforderliche Felder auf Objektebene. Wenn Sie Leads upserten, benötigt Salesforce mindestens:

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

Wenn Sie Kontakte upserten, benötigt Salesforce:

• Nachname (lastName) — erforderlich für die Erstellung eines Kontakts

Email ist in Salesforce' Schema standardmäßig nicht erforderlich, wird aber fast immer als Externe ID benötigt, um Datensätze beim Upsert korrekt abzugleichen und zu deduplizieren. Ohne eine zuverlässige externe ID-Übereinstimmung wird Salesforce doppelte Datensätze erstellen oder einen Fehler zurückgeben.

Best Practice: Immer mindestens Nachname und Email mappen, wenn Sie eine Verbindung zu Salesforce herstellen. Das Weglassen des Nachnamens führt dazu, dass der Webhook einen Fehler zurückgibt und der Datensatz nicht erstellt oder aktualisiert wird.

Feldzuordnung

Verfügbar in allen drei Integrationstypen, ermöglicht die Feldzuordnung, genau festzulegen, welche Drimify-Datenfelder an Ihre Integration gesendet werden und unter welchen Schlüsselnamen.

Klicken Sie auf + Feld hinzufügen, um eine Mapping-Zeile hinzuzufügen. Jede Zeile besteht aus:

• Webhook-Feld (links) — der Schlüsselname, der in der ausgehenden Nutzlast erscheint (Sie definieren diesen, um den von Ihrer Integration erwarteten Feldnamen zu entsprechen)
• → Quellfeld (rechtes Dropdown) — das Drimify-Datenfeld, das darauf gemappt wird

Verfügbare Drimify-Quellfelder

Sie können so viele Zeilen hinzufügen, wie benötigt. Um ein Mapping zu entfernen, klicken Sie auf das Papierkorbsymbol auf der rechten Seite der Zeile.

In Arbeitsbereichen verfügbar

Am unteren Ende jedes Integrationsformulars befindet sich ein Abschnitt In Arbeitsbereichen verfügbar. Verwenden Sie den Schalter 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.## Speicherung und Verwaltung von Integrationen

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

Aktualisiert am: 22/04/2026