Integrationen in Drimify einrichten (Webhooks & Mailer)

Mit Drimify-Integrationen können Sie Teilnehmerdaten automatisch an externe Dienste senden, sobald ein Benutzer mit Ihrer App interagiert. Sie können eine benutzerdefinierte API, HubSpot oder Salesforce anbinden und für jede Integration genau festlegen, welche Datenfelder übertragen werden.

Erste Schritte

Wenn noch keine Integration eingerichtet wurde, sehen Sie den Hinweis „Noch keine Webhook-Integrationen“ oder „Noch keine Mailer-Integrationen“.
Klicken Sie auf + Neue Integration hinzufügen, um die Integrationsauswahl zu öffnen. Die Schaltfläche finden Sie sowohl oben rechts als auch in der Mitte der Seite.

Webhook-Integrationen

Integrationstyp auswählen

Ein Dialogfenster mit dem Titel „Webhook-Integration auswählen“ wird geöffnet.
Über das Dropdown-Menü können Sie nach Kategorien filtern. Standardmäßig ist Alle ausgewählt. Folgende drei Integrationen stehen zur Verfügung:

• Benutzerdefinierte API — für beliebige REST-API-Endpunkte, die Sie selbst verwalten
• HubSpot — für CRM und Marketingautomatisierung mit HubSpot
• Salesforce — für Salesforce CRM

Klicken Sie auf die Kachel der Integration, die Sie einrichten möchten.

Benutzerdefinierte API-Integration

Authentifizierung

Nachdem Sie Benutzerdefinierte API ausgewählt haben, öffnet sich der Bereich Integration hinzufügen mit folgenden Feldern:

• Integrationsname: Ein Name, mit dem Sie die Integration später wiedererkennen. Der Standardwert lautet „Benutzerdefinierte API-Integration“. Sie können einen aussagekräftigeren Namen vergeben.
• API-Endpunkt: Die vollständige URL Ihres Webhook-Empfängers, zum Beispiel https://api.example.com/webhook. Der Endpunkt muss HTTPS verwenden.
• HTTP-Methode:

Wählen Sie die HTTP-Methode aus, mit der die Webhook-Anfrage an Ihren Endpunkt gesendet werden soll.
Folgende Optionen stehen zur Verfügung:

• POST — Für die meisten Anwendungsfälle empfohlen; 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 Ihre API für den Empfang der Daten erwartet.

• Authentifizierungstyp: Wählen Sie die Authentifizierungsmethode aus, die Ihr Endpunkt verwendet.

• Wenn Basic-Authentifizierung ausgewählt ist, erscheinen zwei Felder: Login (Benutzername) und Passwort. Geben Sie Ihre Zugangsdaten unverändert ein. Drimify erstellt den Authorization: Basic-Header automatisch für Sie. Sie müssen die Angaben nicht selbst codieren.
• Wenn Benutzerdefinierter Header ausgewählt ist, erscheint zusätzlich das Feld Benutzerdefinierter Headername, in das Sie den Namen des Headers eingeben können.
• API-Schlüssel: Der geheime Wert, der mit der ausgewählten Authentifizierungsmethode gesendet wird.
• Verbindung prüfen: Klicken Sie vor dem Speichern auf diese Schaltfläche, um zu testen, ob Drimify Ihren Endpunkt mit den angegebenen Zugangsdaten erreichen kann.

Token vorab von einem Authentifizierungsendpunkt abrufen (Pre-Call)

Bei manchen APIs müssen Sie sich zunächst authentifizieren: Sie rufen einen Authentifizierungsendpunkt mit Ihren Zugangsdaten auf, erhalten ein Token und verwenden dieses anschließend für den eigentlichen Webhook-Aufruf. Drimify kann diesen Ablauf automatisch ausführen.

Wenn als Authentifizierungstyp API-Schlüssel, Bearer Token oder Benutzerdefinierter Header ausgewählt ist, erscheint das Kontrollkästchen „Dieses Token von einem Authentifizierungsendpunkt abrufen“. Aktivieren Sie es, wird das Feld für die statischen Zugangsdaten durch die unten beschriebenen Pre-Call-Einstellungen ersetzt. Bei Benutzerdefinierter Header bleibt das Feld für den Headernamen sichtbar. Das abgerufene Token wird in diesem Header gesendet.

Je nach Authentifizierungstyp wird das abgerufene Token wie folgt übermittelt:

• Bearer Token → Authorization: Bearer <token>
• API-Schlüssel → X-API-KEY: <token>
• Benutzerdefinierter Header → <your header name>: <token>

Eine von drei Methoden auswählen

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

• Felder: Token-URL, Client-ID, Client-Secret, Scope (optional)
• Drimify sendet eine standardmäßige OAuth2-Anfrage mit client_credentials und liest das Token aus access_token aus. Die Gültigkeitsdauer wird dem vom Server zurückgegebenen Wert expires_in entnommen.

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

• Felder: Authentifizierungs-URL, Body (Schlüssel-Wert-Liste), Token-Pfad
• Drimify sendet eine POST-Anfrage mit einem JSON-Body, der aus Ihren Schlüssel-Wert-Zeilen erstellt wird. Aus den Zeilen email = a@b.com und password = secret entsteht beispielsweise {"email":"a@b.com","password":"secret"}.
• Der Token-Pfad gibt in Punktnotation an, wo sich das Token in der JSON-Antwort befindet, z. B. data.access_token oder einfach token, wenn es auf der obersten Ebene liegt.

Benutzerdefiniert — für alle Fälle, die nicht zu den beiden oben genannten Methoden passen.

• Felder: Authentifizierungs-URL, HTTP-Methode (POST oder GET), Header (Schlüssel-Wert-Liste), Body (Schlüssel-Wert-Liste), Body-Codierung (JSON oder form-urlencoded), Token-Pfad
• Bei der Methode GET gibt es keinen Anfrage-Body. Übergeben Sie Parameter über die Header oder die Authentifizierungs-URL.
• Wenn Sie selbst einen Content-Type-Header hinzufügen, hat dieser Vorrang vor dem Header, der sich aus der gewählten Body-Codierung ergibt.

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

Jede Zeile enthält einen Schlüssel, einen Wert und das Kontrollkästchen „Vertraulich“, das standardmäßig aktiviert ist. Zeilen lassen sich hinzufügen und entfernen, aber nicht direkt bearbeiten. Um eine Zeile zu ändern, entfernen Sie sie und fügen Sie sie erneut hinzu. Die Kennzeichnung als vertraulich lässt sich nur beim Hinzufügen einer Zeile festlegen. Vertrauliche Werte werden nach dem Speichern maskiert und danach weder im Formular noch in Protokollen im Klartext angezeigt.

Token-Zwischenspeicherung und Wiederholungsversuche

• OAuth2-Token werden für die in expires_in angegebene Dauer zwischengespeichert.
• Für Login JSON und Benutzerdefiniert legen Sie die Token-Gültigkeit (Minuten) fest. Bleibt das Feld leer, gilt der Standardwert von 60 Minuten.
• Token werden höchstens 7 Tage lang zwischengespeichert.
• Wenn Ihr Endpunkt bei Verwendung eines zwischengespeicherten Tokens 401 zurückgibt, verwirft Drimify das Token, authentifiziert sich erneut und wiederholt den Aufruf einmal.
• Schlägt der Pre-Call fehl, etwa aufgrund eines Fehlers, einer Zeitüberschreitung oder weil unter dem Token-Pfad kein Token gefunden wurde, wird der Webhook nicht ohne Authentifizierung gesendet. Die Zustellung schlägt fehl, wird protokolliert und wie gewohnt über die Zustellwarteschlange erneut versucht.

Verbindung mit einem Pre-Call prüfen

Die Schaltfläche Verbindung prüfen unterstützt den Pre-Call vollständig: Drimify authentifiziert sich zunächst an Ihrem Authentifizierungsendpunkt und führt anschließend den Testaufruf mit dem abgerufenen Token aus.

HubSpot-Integration

Nachdem Sie HubSpot ausgewählt haben, werden folgende Felder angezeigt:

• Integrationsname: Standardwert: „HubSpot-Integration“.
• API-Schlüssel / Zugriffstoken: Fügen Sie hier das Zugriffstoken Ihrer privaten HubSpot-App ein. HubSpot hat die bisherigen API-Schlüssel 2022 eingestellt. Sie müssen daher das Token einer privaten App verwenden, das Sie in Ihrem HubSpot-Konto unter Einstellungen → Integrationen → Private Apps erstellen.
• Verbindung prüfen: Prüft das Token vor dem Speichern anhand einer Anfrage an die HubSpot-API.

Salesforce-Integration

Nachdem Sie Salesforce ausgewählt haben, werden folgende Felder angezeigt:

• Integrationsname: Standardwert: „Salesforce-Integration“.
• Salesforce-Domain: Die URL Ihrer Salesforce-Instanz, zum Beispiel yourcompany.my.salesforce.com.
• Consumer Key und Consumer Secret: Diese Angaben erhalten Sie über eine verbundene App, die Sie in Salesforce unter Setup → App-Manager → Neue verbundene App einrichten. Drimify verwendet den OAuth-2.0-Client-Credentials-Flow.
• Name des externen ID-Felds: Der API-Name des Felds, das zum Abgleichen und zum Erstellen bzw. Aktualisieren von Datensätzen (Upsert) verwendet wird. Üblicherweise ist dies Email_External_Id__c oder ein anderes benutzerdefiniertes externes ID-Feld des Objekts Contact. Dieses Feld muss in Salesforce als Externe ID gekennzeichnet sein. Drimify erstellt oder aktualisiert Kontakte. Leads werden derzeit noch nicht unterstützt.
• Quelle der externen ID: Über dieses Dropdown-Menü wählen Sie aus, welches Drimify-Datenfeld als Abgleichsschlüssel verwendet werden soll, zum Beispiel die E-Mail-Adresse.
• Verbindung prüfen: Prüft die OAuth-Verbindung zu Salesforce vor dem Speichern.

⚠️ Pflichtfelder in Salesforce

Salesforce schreibt für das Kontaktobjekt bestimmte Pflichtfelder vor. Um einen Kontakt zu erstellen, ist mindestens folgendes Feld erforderlich:

• lastName

Die E-Mail-Adresse ist im Standardschema von Salesforce zwar kein Pflichtfeld, wird aber fast immer als externe ID benötigt, um Datensätze bei Upserts korrekt abzugleichen und Duplikate zu vermeiden. Ohne einen zuverlässigen Abgleich über eine externe ID kann Salesforce doppelte Datensätze erstellen oder einen Fehler zurückgeben.

Empfehlung

Ordnen Sie bei der Anbindung an Salesforce immer mindestens folgende Felder zu:

• Nachname
• E-Mail-Adresse

Fehlt die Zuordnung für den Nachnamen, schlägt der Webhook fehl und der Datensatz wird weder erstellt noch aktualisiert.

Felder zuordnen

Die Funktion Felder zuordnen ist für alle drei Integrationstypen verfügbar. Damit legen Sie genau fest, welche Drimify-Datenfelder an Ihre Integration gesendet werden und welche Schlüsselnamen dabei verwendet werden.
Klicken Sie auf + Feld hinzufügen, um eine neue Zuordnungszeile hinzuzufügen.

Jede Zeile besteht aus:

• Webhook-Feld (links) — der Schlüsselname, der in den ausgehenden Nutzdaten erscheint. Diesen legen Sie passend zu den Anforderungen Ihrer Integration fest.
• → Quellfeld (Dropdown-Menü rechts) — die Quelle für den Wert dieses Felds. Sie haben zwei Möglichkeiten:
• • Wählen Sie ein Drimify-Datenfeld aus, z. B. App-Referenz, E-Mail-Adresse oder Punktzahl, um einen dynamischen Wert aus den Teilnehmerdaten zu senden.
  • Wählen Sie Statischer Wert aus, um bei jeder Auslösung des Webhooks einen fest vorgegebenen Wert zu senden. Es erscheint ein zusätzliches Textfeld, in das Sie den Wert eingeben, z. B. My_Value. Das ist nützlich, wenn Sie Konstanten wie einen Veranstaltungsnamen, eine Quellenkennung oder eine Umgebungskennzeichnung übermitteln möchten.

Verfügbare Drimify-Quellfelder

Sie können beliebig viele Zuordnungen hinzufügen.
Um eine Zuordnung zu entfernen, klicken Sie rechts in der entsprechenden Zeile auf das Papierkorbsymbol.## In Ihrem CRM anzeigen, dass ein Kontakt über Drimify gewonnen wurde

Drimify legt nicht automatisch eine Quelle fest. Sie können diese jedoch in Salesforce und HubSpot über die Feldzuordnung hinterlegen:

1. Erstellen Sie in Ihrem CRM ein Feld für die Quelle. In Salesforce ist dies ein Textfeld im Objekt „Kontakt“ (zum Beispiel Drimify_Source__c). In HubSpot ist es eine Kontakteigenschaft (zum Beispiel drimify_source).
2. Öffnen Sie in Ihrer Drimify-Integration Felder zuordnen und fügen Sie eine Zeile hinzu. Tragen Sie links den API-Namen des Feldes ein. Wählen Sie rechts Statischer Wert aus und geben Sie Drimify ein.
3. Um festzuhalten, welches Erlebnis der Kontakt gespielt hat, fügen Sie eine zweite Zeile hinzu und ordnen Sie ein weiteres Feld (zum Beispiel Drimify_Game__c) der App-Referenz zu.

In Arbeitsbereichen verfügbar

Unten im Integrationsformular können Sie im Abschnitt In Arbeitsbereichen verfügbar über den Schalter neben jedem Arbeitsbereich festlegen, welche Arbeitsbereiche die Integration nutzen dürfen.
Klicken Sie auf Alle auswählen, um die Integration für alle Arbeitsbereiche gleichzeitig freizugeben.

Integrationen speichern und verwalten

Wenn Sie alle Felder ausgefüllt haben, klicken Sie auf Änderungen speichern, um die Integration zu erstellen. Sie erscheint anschließend in der Integrationsübersicht. Dort können Sie bestehende Integrationen jederzeit bearbeiten oder löschen. Klicken Sie auf Abbrechen, um nicht gespeicherte Änderungen zu verwerfen.

Mailer-Integrationen

Mit Mailer-Integrationen können Sie Transaktions-E-Mails (z. B. Bestätigungen, Ergebnisse oder Follow-ups) direkt aus Ihren Drimify-Erlebnissen über Ihren bevorzugten E-Mail-Anbieter versenden.

Mailer-Integration hinzufügen

1. Gehen Sie zu Integrationen → Mailer-Integrationen
2. Klicken Sie auf Mailer-Integration hinzufügen
3. Wählen Sie Ihren Anbieter aus:

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

Mailer-Integration konfigurieren

Allgemeine Einstellungen

Die folgenden allgemeinen Einstellungen sind für alle Anbieter verfügbar:

• Integrationsname – Interner Name zur Identifizierung Ihrer Integration
• Absendername – Name, der als Absender der E-Mail angezeigt wird
• Absender-E-Mail-Adresse – E-Mail-Adresse, über die E-Mails versendet werden (gilt nicht für Drimify – siehe unten)
• BCC-E-Mail-Adresse (optional) – E-Mail-Adresse, die eine Blindkopie aller ausgehenden E-Mails erhält

Authentifizierung

Jeder Anbieter benötigt eigene Zugangsdaten. Einzelheiten finden Sie unten in der Einrichtungsanleitung für den jeweiligen Anbieter.

Verbindung testen

Nachdem Sie Ihre Zugangsdaten eingegeben haben, klicken Sie auf Test-E-Mail senden, um zu prüfen, ob Ihre Integration korrekt funktioniert. Bei erfolgreicher Verbindung erscheint die Bestätigung „Test-E-Mail erfolgreich gesendet“.

Vorlagenparameterfelder

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

• Parametername – Name der in Ihrer E-Mail-Vorlage verwendeten Variable
• Feld – Die zugehörigen Drimify-Daten (z. B. Vorname, E-Mail-Adresse, Punktzahl usw.)

Klicken Sie auf Feld hinzufügen, um weitere Zuordnungen zu erstellen.

In Arbeitsbereichen verfügbar

Wählen Sie aus, welche Arbeitsbereiche diese Mailer-Integration nutzen dürfen.

Einrichtung nach Anbieter

Amazon SES

Das benötigen Sie:

• Einen AWS-IAM-Benutzer mit der Berechtigung ses:SendEmail
• Einen API-Zugriffsschlüssel und einen privaten API-Schlüssel (aus AWS IAM)
• Ihre AWS-Region (z. B. eu-west-1, us-east-1)
• Ein Sitzungstoken (nur bei Verwendung temporärer Zugangsdaten bzw. STS-Zugangsdaten)
• Eine in Amazon SES verifizierte Absender-E-Mail-Adresse oder Domain

Schritte:

1. Erstellen Sie in AWS IAM einen Benutzer mit SES-Sendeberechtigungen und generieren Sie ein Zugriffsschlüsselpaar
2. Geben Sie in Drimify Ihren API-Zugriffsschlüssel, Ihren privaten API-Schlüssel und Ihre Region ein
3. Wenn Sie temporäre Zugangsdaten verwenden, geben Sie zusätzlich das Sitzungstoken ein
4. Stellen Sie sicher, dass Ihre Absender-E-Mail-Adresse oder Domain in Amazon SES verifiziert ist
5. Klicken Sie auf Test-E-Mail senden, um die Verbindung zu prüfen
6. Speichern Sie Ihre Integration

Brevo

Das benötigen Sie:

• Einen Brevo-API-Schlüssel

Schritte:

1. Generieren Sie in Ihrem Brevo-Konto unter Einstellungen → API-Schlüssel einen API-Schlüssel
2. Fügen Sie ihn in Drimify in das Feld API-Schlüssel ein
3. Klicken Sie auf Test-E-Mail senden, um die Verbindung zu prüfen
4. Speichern Sie Ihre Integration

Drimify

Es ist keine Authentifizierung erforderlich. E-Mails werden über die interne E-Mail-Infrastruktur von Drimify versendet (notification@digitaservice.com).

Das benötigen Sie:

• Einen Absendernamen
• Eine Antwortadresse (z. B. contact@yourcompany.com)
• Optional eine BCC-E-Mail-Adresse

Schritte:

1. Wählen Sie Drimify als Anbieter aus
2. Geben Sie Ihren Absendernamen und Ihre Antwortadresse ein
3. Fügen Sie bei Bedarf eine BCC-E-Mail-Adresse hinzu
4. Wählen Sie die Arbeitsbereiche aus, die diese Integration nutzen dürfen, und speichern Sie die Integration

Mailgun

Das benötigen Sie:

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

Schritte:

1. Rufen Sie in Ihrem Mailgun-Konto Ihren API-Schlüssel und Ihre Versanddomain ab
2. Geben Sie in Drimify Ihren API-Schlüssel, Ihre API-Domain und Ihre API-Region ein
3. Klicken Sie auf Test-E-Mail senden, um die Verbindung zu prüfen
4. Speichern Sie Ihre Integration

Mailjet

Das benötigen Sie:

• Einen Mailjet-API-Zugriffsschlüssel und einen privaten API-Schlüssel

Schritte:

1. Gehen Sie in Ihrem Mailjet-Konto zu Kontoeinstellungen → REST-API → API-Schlüsselverwaltung
2. Kopieren Sie Ihren API-Zugriffsschlüssel und Ihren privaten API-Schlüssel
3. Geben Sie beide Schlüssel in Drimify ein
4. Klicken Sie auf Test-E-Mail senden, um die Verbindung zu prüfen
5. Speichern Sie Ihre Integration

Mandrill

Das benötigen Sie:

• Einen Mandrill-API-Schlüssel (Mandrill ist eine Mailchimp-Erweiterung für Transaktions-E-Mails)

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-Schlüssel in Drimify ein
3. Klicken Sie auf Test-E-Mail senden, um die Verbindung zu prüfen
4. Speichern Sie Ihre Integration

SendGrid

Das benötigen Sie:

• Einen SendGrid-API-Schlüssel mit der Berechtigung zum E-Mail-Versand

Schritte:

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

Tipimail

Das benötigen Sie:

• Einen Tipimail-API-Benutzernamen und einen API-Schlüssel (Tipimail ist der Dienst für Transaktions-E-Mails von Sarbacane)

Schritte:

1. Gehen Sie in Ihrem Tipimail-Konto zu Einstellungen → SMTP & APIs und rufen Sie Ihren API-Benutzernamen und Ihren API-Schlüssel ab
2. Geben Sie beide in Drimify ein
3. Klicken Sie auf Test-E-Mail senden, um die Verbindung zu prüfen
4. Speichern Sie Ihre Integration

Benutzerdefiniertes SMTP

Das benötigen Sie:

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

Schritte:

1. Rufen Sie Ihre SMTP-Zugangsdaten bei Ihrem E-Mail-Hosting-Anbieter oder in Ihrer Serverkonfiguration ab
2. Geben Sie in Drimify Ihren Host, Ihren Port, Ihren Benutzernamen und Ihr Passwort ein
3. Klicken Sie auf Test-E-Mail senden, um die Verbindung zu prüfen
4. Speichern Sie Ihre Integration

Aktualisiert am: 03/11/2026