Einrichten von Integrationen in Drimify (Webhooks & Mailers)

Drimify-Integrationen ermöglichen es Ihnen, Teilnehmerdaten automatisch an externe Dienste zu senden, wenn ein Benutzer mit Ihrer Anwendung interagiert. Sie können sich mit einer benutzerdefinierten API, HubSpot oder Salesforce verbinden — und für jede Integration können Sie genau angeben, welche Datenfelder übertragen werden sollen.

Erste Schritte

Wenn noch keine Integration konfiguriert wurde, sehen Sie den Platzhalterbildschirm "Noch keine Webhook-Integrationen" oder "Noch keine Mailer-Integrationen".
Klicken Sie auf + Neue Integration hinzufügen (verfügbar sowohl oben rechts als auch in der Mitte der Seite), um den Integrationselector zu öffnen.

Webhook-Integrationen

Auswahl eines Integrationstyps

Ein modales Fenster mit dem Titel "Webhook-Integration auswählen" erscheint.
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 den folgenden Feldern:

• Integrationsname: Ein Etikett 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.example.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 Ihrer API entspricht, wie sie Daten empfangen möchte.

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

• Wenn Basis-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 Feld Benutzerdefinierter Header-Name, in dem Sie den Namen des Header-Schlüssels eingeben können.
• API-Schlüssel: 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 mit den bereitgestellten Anmeldeinformationen erfolgreich auf Ihren Endpunkt zugreifen kann, bevor Sie speichern.

Abrufen des Tokens von einem Auth-Endpunkt (vor dem Aufruf)

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

Wenn der Authentifizierungstyp API-Schlüssel, Bearer-Token oder Benutzerdefinierter Header ist, erscheint ein Kontrollkästchen "Token von einem Auth-Endpunkt abrufen". Wenn aktiviert, wird das statische Anmeldefeld durch die Voreinstellungen für den Voraufruf unten ersetzt (beim Benutzerdefinierten Header bleibt das Header-Namensfeld 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 → <your header name>: <token>

Auswahl einer von drei Methoden

OAuth2 (client_credentials) — für standardisierte OAuth2-Server (z.B. Keycloak).

• Felder: Token URL, Client-ID, Client-Secret, Scope (optional)
• Drimify sendet eine standardisierte OAuth2 client_credentials-Anfrage und liest das Token aus access_token. Die Gültigkeitsdauer des Tokens wird vom Server aus expires_in übernommen.

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

• Felder: Auth-URL, Body (Schlüssel/Werte-Liste), Token-Pfad
• Drimify sendet ein POST mit einem JSON-Body, der aus Ihren Schlüssel/Werte-Zeilen erstellt wird (z.B. erzeugen die Zeilen email = a@b.com und password = geheim den JSON-Body {"email":"a@b.com","password":"geheim"}).
• Token-Pfad gibt an, wo das Token in der JSON-Antwort zu finden ist, mit 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 obigen Methoden passt.

• Felder: Auth-URL, HTTP-Methode (POST oder GET), Header (Schlüssel/Werte-Liste), Body (Schlüssel/Werte-Liste), Body-Kodierung (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, der durch die Body-Kodierung impliziert wird.

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

Jede Zeile hat einen Schlüssel, einen Wert und ein "sensitiv" 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. Das empfindliche Flag kann nur beim Hinzufügen einer Zeile gesetzt werden. Empfindliche Werte werden nach dem Speichern maskiert und sind niemals wieder sichtbar, weder im Formular noch in Protokollen.

Token-Caching und -Wiederholungen

• OAuth2-Tokens werden für die Zeitspanne, die von expires_in angegeben wird, zwischengespeichert.
• Für Login JSON und Benutzerdefiniert, legen Sie die Token-Gültigkeit (Minuten) fest — standardmäßig 60 Minuten, wenn nichts eingetragen ist.
• Zwischengespeicherte Tokens werden maximal 7 Tage aufbewahrt.
• Gibt Ihr Endpunkt 401 zurück, während ein zwischengespeichertes Token verwendet wird, verwirft Drimify das Token, authentifiziert sich erneut und versucht den Aufruf einmalig erneut.
• Sollte der Vorausaufruf fehlschlagen (Fehler, Timeout oder kein Token im Token-Pfad gefunden), wird der Webhook nicht unauthentifiziert gesendet — die Lieferung schlägt fehl, wird protokolliert und von der Lieferwarteschlange wie gewohnt erneut versucht.

Verbindung mit einem Vorausaufruf verifizieren

Der Button Verbindung Verifizieren unterstützt vollständig den Vorausaufruf: Zuerst authentifiziert er sich an Ihrem Auth-Endpunkt, dann führt er den Testaufruf mit dem abgerufenen Token durch.

HubSpot-Integration

Nach Auswahl von HubSpot zeigt das Panel:

• Integrationsname: Standard: "HubSpot-Integration".
• API-Schlüssel / Access-Token: Fügen Sie hier Ihr HubSpot Private App Access Token ein. HubSpot hat alte API-Schlüssel im Jahr 2022 eingestellt, daher müssen Sie ein Private App-Token verwenden, das über Ihr HubSpot-Konto generiert wurde unter: Einstellungen → Integrationen → Private Apps
• Verbindung verifizieren: Testet das Token gegen die HubSpot-API, bevor es gespeichert wird.

Salesforce-Integration

Nach Auswahl von Salesforce zeigt das Panel:

• Integrationsname: Standard: "Salesforce-Integration".
• Salesforce-Domain: Die URL Ihrer Salesforce-Instanz (zum Beispiel: yourcompany.my.salesforce.com).
• Consumer-Schlüssel und Consumer-Geheimnis: Erhalten von einer verbundenen App, die in Salesforce konfiguriert ist unter: Setup → App-Manager → Neue Verbundene App. Drimify nutzt den OAuth 2.0 Client Credentials-Flow.
• Externe ID-Feldname: Der API-Name des Feldes, das verwendet wird, um Datensätze abzugleichen (upsert) — typischerweise etwas wie Email_External_Id__c oder ein benutzerdefiniertes externes ID-Feld in dem Kontakt- oder Lead-Objekt. Dieses Feld muss in Salesforce als Externe ID markiert sein.
• Quelle der externen ID: Ein Dropdown-Menü, in dem Sie wählen können, welches Drimify-Datenfeld als Abgleichsschlüssel verwendet werden soll (zum Beispiel: Email).
• Verbindung verifizieren: Testet die Salesforce OAuth-Verbindung vor dem Speichern.

⚠️ Erforderliche Salesforce-Felder

Salesforce erzwingt erforderliche Felder auf Objektebene. Wenn du Leads aktualisierst oder einfügst, verlangt Salesforce mindestens:

• lastName — erforderlich für die Erstellung eines Leads

Wenn du Kontakte aktualisierst oder einfügst, verlangt Salesforce:

• lastName — erforderlich für die Erstellung eines Kontakts

Obwohl eine E-Mail-Adresse nicht im Standard-Schema von Salesforce erforderlich ist, ist sie fast immer notwendig als externe ID, um Datensätze bei Upserts korrekt abzugleichen und Dubletten zu vermeiden. Ohne einen zuverlässigen Abgleich der externen ID kann Salesforce möglicherweise doppelte Datensätze erstellen oder einen Fehler zurückgeben.

Beste Praxis

Immer mindestens abgleichen:

• Nachname
• E-Mail-Adresse

wenn du eine Verbindung zu Salesforce herstellst. Wenn der Nachname fehlt, wird der Webhook fehlschlagen und der Datensatz wird nicht erstellt oder aktualisiert.

Felder zuordnen

Verfügbar für alle drei Integrationstypen ermöglicht Map Fields dir, genau anzugeben, welche Datenfelder von Drimify an deine Integration gesendet werden und unter welchen Schlüsselnamen.
Klicke auf + Feld hinzufügen, um eine Zuordnung hinzuzufügen.

Jede Zeile besteht aus:

• Webhook-Feld (links) — der Schlüsselname, der in der ausgehenden Payload erscheint (von dir definiert, um deinen Integrationsanforderungen zu entsprechen)
• → Quellenfeld (Dropdown auf der rechten Seite) — die ursprüngliche Quelle für dieses Feld. Du kannst entweder:
• • Ein Drimify-Datenfeld auswählen (z. B. App-Referenz, E-Mail-Adresse, Punktzahl) um einen dynamischen Wert zu senden, der von den Teilnehmern gesammelt wurde
  • Einen statischen Wert auswählen, um einen festen, vordefinierten Wert jedes Mal zu senden, wenn der Webhook ausgelöst wird — ein zusätzliches Texteingabefeld erscheint, wo du den Wert eingibst (z. B. My_Value). Nützlich zum Übertragen von Konstanten wie einem Ereignisnamen, einer Quellenkennung oder einem Umwelttag.

Verfügbare Drimify-Quellenfelder

Du kannst so viele Zuordnungen hinzufügen, wie du benötigst.
Um eine Zuordnung zu entfernen, klicke auf das Papierkorbsymbol auf der rechten Seite der Zeile.

In Arbeitsbereichen verfügbar

Am unteren Ende des Integrationsformulars kannst du im Abschnitt Verfügbar in Arbeitsbereichen den Schalter neben jedem Arbeitsbereich verwenden, um zu kontrollieren, welcher Arbeitsbereich die Integration nutzen kann.
Klicke auf Alle auswählen, um die Integration für alle Arbeitsbereiche gleichzeitig zu aktivieren.

Integrationen speichern und verwalten

Sobald alle Felder ausgefüllt sind, klicke auf Änderungen speichern, um die Integration zu erstellen. Die Integration erscheint dann in der Hauptintegrationsliste. Du kannst bestehende Integrationen jederzeit bearbeiten oder löschen. Klicke auf Abbrechen, um nicht gespeicherte Änderungen zu verwerfen.

Mailer-Integrationen

Mailer-Integrationen ermöglichen dir, transaktionale E-Mails (z. B. Bestätigungen, Ergebnisse oder Follow-ups) direkt aus deinen Drimify-Erlebnissen mit deinem bevorzugten E-Mail-Anbieter zu senden.

Hinzufügen einer Mailer Integration

1. Gehe zu Integrationen → Mailer Integrationen
2. Klicke auf Add Mailer Integration
3. Wähle deinen Anbieter aus:

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

Konfigurieren deiner Mailer Integration

Allgemeine Einstellungen

Alle Anbieter haben folgende allgemeine Einstellungen gemeinsam:

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

Authentifizierung

Jeder Anbieter erfordert spezifische Zugangsdaten. Siehe den anbieter-spezifischen Einrichtungsabschnitt unten für Details.

Test Deiner Verbindung

Nach Eingabe deiner Zugangsdaten, klicke auf Test E-Mail senden, um zu überprüfen, ob deine Integration korrekt funktioniert. Eine "Test E-Mail erfolgreich gesendet" Bestätigung 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-Templates unterstützen: Brevo, Mailgun, Mailjet, Mandrill, SendGrid und Tipimail.

• Parametername – Der erwartete Variablenname in deinem E-Mail-Template
• 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:

• Einen AWS IAM Benutzer mit ses:SendEmail Berechtigungen
• API Access Schlüssel und API Private Schlüssel (von AWS IAM)
• Ihre AWS Region (z.B. eu-west-1, us-east-1)
• Sitzungstoken (nur bei Nutzung von temporären/STS-Zugangsdaten)
• Eine verifizierte Absender-E-Mail oder Domain in Amazon SES

Schritte:

1. Erstellen Sie in AWS IAM einen Benutzer mit SES Sende-Berechtigungen und generieren Sie ein Paar aus Zugriffsschlüssel.
2. Geben Sie in Drimify Ihren API Access Key, API Private Key und Region ein.
3. Bei Nutzung temporärer Zugangsdaten geben Sie auch das Session Token ein.
4. Stellen Sie sicher, dass Ihre Absender-E-Mail 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 Keys.
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 die interne E-Mail-Infrastruktur von Drimify (notification@digitaservice.com) gesendet.

Was Sie benötigen:

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

Schritte:

1. Wählen Sie Drimify als Ihren Anbieter aus.
2. Geben Sie Ihren Absendernamen und Reply-To E-Mail an.
3. Optional können Sie eine BCC Email hinzufügen.
4. Wählen Sie die Arbeitsbereiche aus, die diese Integration verwenden sollen, und speichern Sie.

Mailgun

Was Sie benötigen:

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

Schritte:

1. Rufen Sie in Ihrem Mailgun-Konto Ihren API-Schlüssel und die Versand-Domain ab.
2. Geben Sie in Drimify Ihren API Key, API Domain und API Region 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 Account Einstellungen → REST API → API-Schlüssel Verwaltung.
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-Add-on)

Schritte:

1. Gehen Sie in Ihrem Mandrill-Konto zu Einstellungen → API Keys 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 Send Berechtigungen

Schritte:

1. Erstellen Sie in Ihrem SendGrid-Konto unter Einstellungen → API Keys 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 Sarbacanes Transaktions-E-Mail-Service)

Schritte:

1. Gehen Sie in Ihrem Tipimail-Konto zu Einstellungen → SMTP & APIs und rufen Sie 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.

Benutzerdefiniertes SMTP

Was Sie benötigen:

• Ihren SMTP-Server-Hostname
• SMTP-Port (typischerweise 587 für TLS, 465 für SSL)
• SMTP-Login (normalerweise Ihre E-Mail-Adresse)
• SMTP-Passwort

Schritte:

1. Rufen Sie Ihre SMTP-Zugangsdaten 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: 03/10/2026