Einrichtung von Integrationen in Drimify (Webhooks & Mailers)

Drimify-Integrationen ermöglichen es Ihnen, automatisch Teilnehmerdaten an externe Dienste zu senden, sobald ein Nutzer mit Ihrer Anwendung interagiert. Sie können eine Verbindung zu einer Benutzerdefinierten API, HubSpot oder Salesforce herstellen — und für jede Integration können Sie genau angeben, welche Datenfelder übertragen werden.

Erste Schritte

Wenn noch keine Integration konfiguriert wurde, erscheint der Platzhalter-Bildschirm "Noch keine Webhook-Integrationen" oder "Noch keine Mailer-Integrationen".
Klicken Sie + Neue Integration Hinzufügen (sowohl oben rechts als auch zentral auf der Seite verfügbar), um den Integrationsselektor zu öffnen.

Webhook-Integrationen

Auswahl eines Integrationstyps

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

• Benutzerdefinierte API — für jeden REST-API-Endpunkt, den Sie steuern
• HubSpot — für CRM- und Marketing-Automatisierung über HubSpot
• Salesforce — für Salesforce CRM

Klicken Sie auf das Integrationsfeld, das Sie konfigurieren möchten.

Benutzerdefinierte API-Integration

Authentifizierung

Nach der Auswahl von Benutzerdefinierte API öffnet sich das Integration Hinzufügen-Panel mit folgenden Feldern:

• Integrationsname: Ein Label für Ihre eigene Referenz (Standard: "Benutzerdefinierte API-Integration"). Sie können es in etwas Beschreibenderes umbenennen.
• API-Endpunkt: Die vollständige URL Ihres Webhook-Empfängers (zum Beispiel: https://api.beispiel.com/webhook). Dies muss ein HTTPS-Endpunkt sein.
• HTTP-Methode:

Wählen Sie die HTTP-Methode aus, die verwendet wird, um die Webhook-Anfrage an Ihren Endpunkt zu senden.
Verfügbare Optionen:

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

Wählen Sie die Methode, die der erwarteten Datenübermittlungsweise Ihrer API entspricht.

• Authentifizierungstyp: Wählen Sie die Authentifizierungsmethode, die von Ihrem Endpunkt verwendet wird.

• Wenn Basic Authentifizierung ausgewählt ist, erscheinen zwei Felder: Login (Benutzername) und Passwort. Geben Sie diese unverändert ein — Drimify erstellt den Authorization: Basic-Header automatisch für Sie. Sie müssen nichts selbst kodieren.
• Wenn Benutzerdefinierter Header ausgewählt ist, erscheint ein zusätzliches Benutzerdefinierter Header Name-Feld, in dem Sie den Header-Schlüsselnamen eingeben können.
• API Key: Der geheime Schlüssel, der mit der ausgewählten Authentifizierungsmethode gesendet wird.
• Verbindung überprüfen: Klicken Sie auf diese Schaltfläche, um zu testen, ob Drimify erfolgreich Ihren Endpunkt mit den bereitgestellten Anmeldeinformationen erreichen kann, bevor Sie speichern.

Abrufen des Tokens von einem Auth-Endpunkt (Vor-Anruf)

Einige APIs erfordern, dass Sie sich zuerst authentifizieren: Sie rufen einen Auth-Endpunkt mit Ihren Anmeldeinformationen auf, erhalten ein Token und verwenden dieses Token für den eigentlichen Webhook-Aufruf. Drimify unterstützt dies automatisch.

Wenn der Authentifizierungstyp API Key, Bearer Token oder Benutzerdefinierter Header ist, erscheint das Kontrollkästchen "Dieses Token von einem Auth-Endpunkt abrufen". Wenn aktiviert, wird das statische Anmeldefeld durch die folgenden Vor-Anruf-Einstellungen ersetzt (bei Benutzerdefiniertem Header bleibt das Headernamenfeld sichtbar — das abgerufene Token wird in diesem Header gesendet).

Das abgerufene Token wird entsprechend Ihrem Authentifizierungstyp platziert:

• Bearer Token → Authorization: Bearer <token>
• API-Schlüssel → X-API-KEY: <token>
• Benutzerdefinierter Header → <Ihr Headername>: <token>### Wählen Sie eine von drei Methoden

OAuth2 (client_credentials) — für standardmäßige OAuth2-Server (z.B. Keycloak).

• Felder: Token URL, Client ID, Client Secret, Scope (optional)
• Drimify sendet eine standardmäßige OAuth2 client_credentials Anfrage und liest das Token von access_token. Die Tokenlebensdauer wird von expires_in des Servers übernommen.

Login JSON — für Login-Endpunkte, die einen JSON-Body annehmen und ein Token zurückgeben.

• Felder: Auth URL, Body (Schlüssel/Wert-Liste), Token-Pfad
• Drimify sendet eine POST-Anfrage mit einem JSON-Body, der von Ihren Schlüssel/Wert-Reihen erstellt wird (z.B. Reihen email = a@b.com und password = geheim ergeben {"email":"a@b.com","password":"geheim"}).
• Token-Pfad gibt Drimify vor, wo das Token in der JSON-Antwort zu finden ist, mittels Punktnotation — z.B. data.access_token, oder einfach token, wenn es auf der obersten Ebene ist.

Benutzerdefiniert — für alles, was nicht in die beiden oben genannten Methoden passt.

• Felder: Auth URL, HTTP-Methode (POST oder GET), Header (Schlüssel/Wert-Liste), Body (Schlüssel/Wert-Liste), Body-Encoding (JSON oder form-urlencoded), Token-Pfad
• Bei der Methode GET gibt es keinen Anfrage-Body — Parameter werden über die Header oder die Auth URL übergeben.
• Wenn Sie selbst einen Content-Type-Header hinzufügen, hat dieser Vorrang vor dem durch das Body-Encoding implizierten.

Schlüssel/Wert-Listen (Body und Header)

Jede Zeile hat einen Schlüssel, einen Wert und ein “empfindlich”-Kontrollkästchen (standardmäßig aktiviert). Zeilen können hinzugefügt und entfernt werden, aber nicht direkt bearbeitet werden — um eine Zeile zu ändern, entfernen Sie sie und fügen Sie sie erneut hinzu. Die empfindlich-Kennzeichnung kann nur beim Hinzufügen einer Zeile gesetzt werden. Empfindliche Werte sind nach dem Speichern maskiert und werden niemals erneut offengelegt, weder im Formular noch in Protokollen.

Token-Caching und Wiederholungsversuche

• OAuth2-Tokens werden für die Dauer von expires_in zwischengespeichert.
• Für Login JSON und Benutzerdefiniert die Token-Gültigkeit (Minuten) festlegen — Standard ist 60 Minuten, wenn leer gelassen.
• Zwischengespeicherte Tokens werden maximal 7 Tage aufbewahrt.
• Wenn Ihr Endpunkt 401 zurückgibt, während ein zwischengespeichertes Token verwendet wird, verwirft Drimify das Token, authentifiziert sich neu und wiederholt den Aufruf einmal.
• Falls der Vorab-Aufruf fehlschlägt (Fehler, Zeitüberschreitung oder kein Token im Token-Pfad gefunden), wird der Webhook nicht ohne Authentifizierung gesendet — die Zustellung schlägt fehl, wird protokolliert und wie üblich von der Zustellungswarteschlange wiederholt.

Verbindung verifizieren mit einem Vorab-Aufruf

Die Taste Verbindung verifizieren unterstützt den Vorab-Aufruf vollständig: Sie authentifiziert zunächst gegen Ihren Auth-Endpunkt und führt dann den Testaufruf mit dem abgerufenen Token aus.

HubSpot Integration

Nach der Auswahl von HubSpot zeigt das Panel Folgendes an:

• Integrationsname: Standard: "HubSpot Integration".
• API Schlüssel / Access Token: Fügen Sie Ihr HubSpot Private App Access Token hier ein. HubSpot hat die veralteten API-Schlüssel 2022 eingestellt, daher müssen Sie ein Private App Token verwenden, das aus Ihrem HubSpot-Konto unter: Einstellungen → Integrationen → Private Apps generiert wurde.
• Verbindung verifizieren: Testet das Token gegen die HubSpot API vor dem Speichern.

Salesforce Integration

Nach der Auswahl von Salesforce zeigt das Panel Folgendes an:

• Integrationsname: Standard: "Salesforce Integration".
• Salesforce-Domain: Die URL Ihrer Salesforce-Instanz (zum Beispiel: yourcompany.my.salesforce.com).
• Consumer Schlüssel und Consumer Secret: Erhalten von einer verbundenen App, die in Salesforce unter: Setup → App Manager → Neue Verbundene App konfiguriert wurde. Drimify verwendet den OAuth 2.0 Client Credentials-Flow.
• Externes ID-Feld Vorname: Der API-Name des Feldes, das zum Abgleichen (Upsert) von Datensätzen verwendet wird — typischerweise etwas wie Email_External_Id__c oder ein benutzerdefiniertes externes ID-Feld im Kontakt- oder Lead-Objekt. Dieses Feld muss in Salesforce als Externe ID gekennzeichnet sein.
• Externe ID-Quelle: Ein Dropdown-Menü, das Ihnen ermöglicht, auszuwählen, welches Drimify-Datenfeld als Abgleichsschlüssel verwendet werden soll (zum Beispiel: E-Mail).
• Verbindung verifizieren: Testet die Salesforce-OAuth-Verbindung vor dem Speichern.## ⚠️ Erforderliche Salesforce-Felder

Salesforce verlangt bestimmte erforderliche Objekt-Level-Felder. Wenn Sie Leads aktualisieren oder einfügen, benötigt Salesforce mindestens:

• lastName — notwendig für die Lead-Erstellung

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

• lastName — notwendig für die Kontakt-Erstellung

Obwohl die E-Mail-Adresse im Salesforce-Standard-Schema nicht als erforderlich gilt, ist sie fast immer notwendig, um als externe ID die Datensätze ordnungsgemäß abzugleichen und Duplikate während der Aktualisierungen zu vermeiden. Ohne einen zuverlässigen externen ID-Abgleich kann Salesforce duplizierte Einträge erstellen oder einen Fehler zurückgeben.

Beste Praxis

Immer mindestens Folgendes zuordnen:

• Nachname
• E-Mail-Adresse

wenn Sie eine Verbindung zu Salesforce herstellen. Das Auslassen des Nachnamens führt dazu, dass der Webhook fehlschlägt und der Datensatz nicht erstellt oder aktualisiert wird.

Felder zuordnen

Für alle drei Integrationstypen verfügbar, ermöglicht Map Fields Ihnen, genau anzugeben, welche Drimify-Datenfelder an Ihre Integration gesendet werden und unter welchem Schlüssel-Namen.
Klicken Sie auf + Feld hinzufügen um eine Zuordnungszeile hinzuzufügen.

Jede Zeile besteht aus:

• Webhook-Feld (links) — der Schlüsselname, der im ausgehenden Payload erscheinen wird (von Ihnen definiert, um Ihren Integrationsanforderungen zu entsprechen)
• → Quellfeld (Dropdown rechts) — die Datenquelle für dieses Feld. Sie können entweder:
• • Ein Drimify-Datenfeld auswählen (z.B. App-Referenz, E-Mail-Adresse, Score), um einen dynamischen Wert zu senden, der vom Teilnehmer gesammelt wurde
  • Statischer Wert auswählen, um einen festen, festkodierten Wert jedes Mal zu senden, wenn der Webhook ausgelöst wird — ein zusätzliches Texteingabefeld wird erscheinen, in dem Sie den Wert eingeben (z.B. My_Value). Nützlich zum Übertragen von Konstanten wie einem Ereignisnamen, einer Quellenkennung oder einer Umgebungsetikette.

Verfügbare Drimify-Quellenfelder

Sie können so viele Zuordnungen hinzufügen, wie nötig.
Um eine Zuordnung zu entfernen, klicken Sie auf das Papierkorb-Symbol auf der rechten Seite der Zeile.

In Arbeitsbereichen verfügbar

Am Ende des Integrationsformulars können Sie im Abschnitt In Arbeitsbereichen verfügbar den Schalter neben jedem Arbeitsbereich verwenden, um zu steuern, welcher Arbeitsbereich die Integration nutzen kann.
Klicken Sie auf Alle auswählen, um die Integration 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. Die Integration erscheint dann in der Hauptliste der Integrationen. Sie können bestehende Integrationen jederzeit bearbeiten oder löschen. Klicken Sie auf Abbrechen, um ungespeicherte Änderungen zu verwerfen.

Mailer-Integrationen

Mailer-Integrationen ermöglichen es Ihnen, transaktionale E-Mails (z.B. Bestätigungen, Ergebnisse oder Nachfassaktionen) direkt von Ihren Drimify-Erlebnissen mit Ihrem bevorzugten E-Mail-Anbieter zu versenden.### Hinzufügen einer Mailer-Integration

1. Gehe zu Integrationen → Mailer-Integrationen
2. Klicke auf Mailer-Integration hinzufügen
3. Wähle deinen Anbieter aus:

• Amazon SES
• Brevo
• Drimify
• Mailgun
• Mailjet
• Mandrill
• SendGrid
• Tipimail
• Benutzerdefinierter SMTP

Konfigurieren deiner Mailer-Integration

Allgemeine Einstellungen

Alle Anbieter teilen die folgenden allgemeinen Einstellungen:

• Integrationsname – Interner Name zur Identifizierung deiner Integration
• Absendername – Name, der als Absenderadresse angezeigt wird
• Absender-E-Mail – E-Mail-Adresse, die zum Versenden von E-Mails verwendet wird (nicht anwendbar für Drimify – siehe unten)
• BCC-E-Mail (optional) – E-Mail-Adresse hinzufügen, um eine Kopie aller ausgehenden E-Mails zu erhalten

Authentifizierung

Jeder Anbieter benötigt spezifische Zugangsdaten. Siehe den anbieterspezifischen Einrichtungsabschnitt unten für Details.

Verbindung testen

Nachdem du deine Anmeldedaten eingegeben hast, klicke auf Test-E-Mail senden, um zu überprüfen, ob deine Integration korrekt funktioniert. Eine Bestätigung "Test-E-Mail erfolgreich versendet" erscheint, wenn die Verbindung gültig ist.

Vorlagenparameterfelder

Ordne Drimify-Datenfelder den Template-Variablen deines E-Mail-Anbieters zu. Dieser Abschnitt ist verfügbar für Anbieter, die dynamische E-Mail-Vorlagen unterstützen: Brevo, Mailgun, Mailjet, Mandrill, SendGrid und Tipimail.

• Parametername – Der erwartete Variablenname in deiner E-Mail-Vorlage
• Feld – Die entsprechenden Drimify-Daten (z.B. Vorname, E-Mail-Adresse, Punktzahl, etc.)

Klicke auf Feld hinzufügen, um zusätzliche Zuordnungen zu erstellen.

In Arbeitsbereichen verfügbar

Wähle aus, welche Arbeitsbereiche diese Mailer-Integration nutzen können.### Anbieter-spezifische Einrichtung

Amazon SES

Was Sie benötigen:

• Ein AWS IAM-Benutzer mit ses:SendEmail-Berechtigungen
• API-Zugriffsschlüssel und API-Privatschlüssel (von AWS IAM)
• Ihre AWS-Region (z. B. eu-west-1, us-east-1)
• Sitzungstoken (nur bei Nutzung temporärer/STS-Anmeldedaten)
• Eine verifizierte Absender-E-Mail-Adresse oder Domain in Amazon SES

Schritte:

1. Erstellen Sie in AWS IAM einen Benutzer mit SES-Sendeberechtigungen und generieren Sie ein Zugriffsschlüssel-Paar
2. Geben Sie in Drimify Ihren API Access Key, API Private Key und die Region ein
3. Wenn Sie temporäre Anmeldedaten verwenden, geben Sie auch das Session Token ein
4. Stellen Sie sicher, dass Ihre Absender-E-Mail-Adresse oder Domain in Amazon SES verifiziert ist
5. Klicken Sie auf Send Test Email, um die Verbindung zu validieren
6. Speichern Sie Ihre Integration

Brevo

Was Sie benötigen:

• Einen Brevo-API-Schlüssel

Schritte:

1. Generieren Sie in Ihrem Brevo-Konto einen API-Schlüssel unter Einstellungen → API-Schlüssel
2. Fügen Sie diesen in das API Key-Feld in Drimify ein
3. Klicken Sie auf Send Test Email, um die Verbindung zu validieren
4. Speichern Sie Ihre Integration

Drimify

Keine Authentifizierung erforderlich. E-Mails werden über Drimifys interne E-Mail-Infrastruktur (notification@digitaservice.com) gesendet.
Was Sie benötigen:

• Einen Absender-Vornamen
• Eine Reply-To-E-Mail-Adresse (z. B. contact@ihrefirma.com)
• Optional eine BCC-E-Mail-Adresse

Schritte:

1. Wählen Sie Drimify als Ihren Anbieter
2. Geben Sie Ihren Sender Name und Reply-To Email ein
3. Optional: Fügen Sie eine BCC Email hinzu
4. Wählen Sie die Arbeitsbereiche, die diese Integration nutzen sollen, und speichern Sie

Mailgun

Was Sie benötigen:

• Einen Mailgun-API-Schlüssel
• Ihre in Mailgun registrierte Versanddomain
• Ihre API-Region (US oder EU)

Schritte:

1. Rufen Sie in Ihrem Mailgun-Konto Ihren API-Schlüssel und die Versanddomain ab
2. Geben Sie diese in Drimify in das API Key, API Domain und API Region-Feld ein
3. Klicken Sie auf Send Test Email, um die Verbindung zu validieren
4. Speichern Sie Ihre Integration

Mailjet

Was Sie benötigen:

• Einen Mailjet-API-Access-Schlüssel und API-Private-Schlüssel

Schritte:

1. Gehen Sie in Ihrem Mailjet-Konto zu Kontoeinstellungen → REST API → API-Schlüssel-Management
2. Kopieren Sie Ihren API Access Key und API Private Key
3. Geben Sie beide in Drimify ein
4. Klicken Sie auf Send Test Email, um die Verbindung zu validieren
5. Speichern Sie Ihre Integration

Mandrill

Was Sie benötigen:

• Einen Mandrill-API-Schlüssel (Mandrill ist ein Mailchimp-Transaktions-E-Mail-Zusatz)

Schritte:

1. Gehen Sie in Ihrem Mandrill-Konto zu Einstellungen → API-Schlüssel und generieren Sie einen Schlüssel
2. Fügen Sie den API Key in Drimify ein
3. Klicken Sie auf Send Test Email, um die Verbindung zu validieren
4. Speichern Sie Ihre Integration

SendGrid

Was Sie benötigen:

• Einen SendGrid-API-Schlüssel mit Mail-Sendeberechtigungen

Schritte:

1. Gehen Sie in Ihrem SendGrid-Konto zu Einstellungen → API-Schlüssel und erstellen Sie einen Schlüssel mit Mail Send-Berechtigungen
2. Fügen Sie den API Key in Drimify ein
3. Klicken Sie auf Send Test Email, um die Verbindung zu validieren
4. Speichern Sie Ihre Integration

Tipimail

Was Sie benötigen:

• Einen Tipimail-API-Benutzer und API-Schlüssel (Tipimail ist der Transaktions-E-Mail-Service von Sarbacane)

Schritte:

1. Rufen Sie in Ihrem Tipimail-Konto unter Einstellungen → SMTP & APIs Ihren API User und API Key ab
2. Geben Sie beide in Drimify ein
3. Klicken Sie auf Send Test Email, um die Verbindung zu validieren
4. Speichern Sie Ihre Integration

Benutzerdefiniert SMTP

Was Sie benötigen:

• Den Hostnamen Ihres SMTP-Servers
• SMTP-Port (in der Regel 587 für TLS, 465 für SSL)
• SMTP-Anmeldung (meist Ihre E-Mail-Adresse)
• SMTP-Passwort

Schritte:

1. Rufen Sie Ihre SMTP-Anmeldedaten von Ihrem E-Mail-Hosting-Anbieter oder Serverkonfiguration ab
2. Geben Sie in Drimify Ihren Host, Port, Login und Password ein
3. Klicken Sie auf Send Test Email, um die Verbindung zu validieren
4. Speichern Sie Ihre Integration

Aktualisiert am: 24/07/2026