Webhooks
Zuletzt geprüft:
DMowl sendet ein JSON-Ereignis per POST an deine URL, wenn ein Lead eine E-Mail teilt, einen Link klickt, an einem Gewinnspiel teilnimmt, sich abmeldet oder kauft. URL und Ereignisse legst du unter Integrationen fest; jede Anfrage ist mit deinem Secret signiert, damit du prüfen kannst, dass sie von DMowl kommt.
Einrichten
- 1 Empfangs-URL erstellen
Make: „Custom webhook“. Zapier: „Webhooks by Zapier → Catch Hook“. n8n: „Webhook“-Node. Oder dein eigener Endpunkt.
- 2 In DMowl eintragen
Integrationen → Ausgehender Webhook: URL einfügen, Ereignisse wählen, speichern.
- 3 Testen
Klick auf „Test-Event senden“. Ein lead.email_collected-Ereignis mit Testdaten kommt an deiner URL an.
Ereignisse
| Ereignis | Wird gesendet, wenn | data enthält |
|---|---|---|
| lead.email_collected | Ein Kontakt hat eine E-Mail-Frage beantwortet | contact_id, username, name, email, source, source_id |
| link.clicked | Ein Kontakt hat einen getrackten Link geöffnet (erster Klick) | url, contact_id, source, source_id |
| giveaway.entered | Ein Kontakt nimmt an einem Gewinnspiel teil | giveaway_id, contact_id, username |
| contact.opted_out | Ein Kontakt hat STOP o. Ä. geschrieben | contact_id, username |
| conversion.created | Eine Bestellung wurde einer DM zugeordnet | amount, currency, contact_id, source, source_id, order_id |
Payload und Signatur
Der Body ist { "event": "…", "created_at": "ISO-Datum", "data": { … } }. Header: X-DMowl-Event (Name des Ereignisses) und X-DMowl-Signature: sha256=<hex>, ein HMAC-SHA256 des rohen Bodys mit deinem Signing Secret (unter Integrationen).
Berechne den HMAC über den rohen Request-Body, bevor du ihn parst, und vergleiche ihn mit dem Header. Dein Endpunkt sollte innerhalb von 5 Sekunden antworten; Ereignisse werden einmal gesendet und nicht wiederholt, also langsame Arbeit in eine Queue legen.
Fragen? Antworten.
Gibt es eine Zapier-App?
Noch nicht. Nutze „Webhooks by Zapier → Catch Hook“ – das funktioniert genauso.
Kommst du nicht weiter? Schreib uns und erzähl, was du versucht hast: hello@dmowl.com