Webhooks
E-Mail-Zustellungsevents
Erhalten Sie Benachrichtigungen in Echtzeit zum Zustellstatus Ihrer E-Mails. Konfigurieren Sie Ihre Webhook-URL im Dashboard. Alle Events werden aus Sicherheitsgründen mit HMAC-SHA256 signiert.
https://your-server.com/webhook/email/deliveryPrüfen Sie immer die Webhook-Signatur. Erzeugen Sie Ihr Webhook-Secret im Dashboard und prüfen Sie damit eingehende Requests. Berechnen Sie den HMAC über den rohen Request-Body, nicht über neu serialisiertes JSON.
Schnellstart
Ein Listener, der die Signatur prüft und dann das Event verarbeitet. Sobald das Event angenommen ist, antworten Sie mit einem 2xx Statuscode.
const express = require('express');
const crypto = require('crypto');
const app = express();
const WEBHOOK_SECRET = process.env.WEBHOOK_SECRET;
function verifySignature(rawBody, signature) {
if (!signature) return false;
const expected = 'sha256=' + crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(rawBody)
.digest('hex');
const a = Buffer.from(signature);
const b = Buffer.from(expected);
// timingSafeEqual throws when the lengths differ
return a.length === b.length && crypto.timingSafeEqual(a, b);
}
// express.raw keeps the body as a Buffer, exactly as it was sent
app.post('/webhook/email/delivery', express.raw({ type: 'application/json' }), (req, res) => {
if (!verifySignature(req.body, req.headers['x-webhook-signature'])) {
return res.status(401).json({ error: 'Invalid signature' });
}
const { event, emailId, data } = JSON.parse(req.body.toString('utf8'));
console.log('[Email Delivery] ' + event + ' - ' + emailId);
if (event === 'delivered') {
console.log(' Recipient: ' + data.recipientEmail);
} else if (event === 'bounced') {
console.log(' Reason: ' + data.reason);
}
res.status(200).json({ received: true });
});
app.listen(3001, () => {
console.log('Email delivery webhook listener on port 3001');
console.log(' POST /webhook/email/delivery');
});Header
X-Webhook-SignaturestringerforderlichHMAC-SHA256-Signatur des Request-Bodys. Format:
sha256=hex_digest
Testen mit ngrok
Machen Sie Ihren lokalen Listener im Internet erreichbar und hinterlegen Sie die erzeugte URL im Dashboard als Webhook-URL.
ngrok http 3001
# Your webhook URL:
# https://abc123.ngrok.io/webhook/email/deliveryEvents
Jedes Event ist ein JSON-Objekt mit event, timestamp und einem data-Objekt. Öffnen Sie ein Event, um den vollständigen Payload und alle Felder zu sehen.
Zustellung
Was mit einer E-Mail auf dem Weg ins Postfach passiert.
queuedWird einmal gesendet, wenn eine E-Mail in die Zustellwarteschlange kommt, für jede E-Mail: API, SMTP und Kampagnen. Wird erneut gesendet, wenn die E-Mail für einen weiteren Versuch auf eine andere IP oder einen anderen Server verschoben wird.
processingWird gesendet, wenn die E-Mail unsere Prüfungen bestanden hat und gleich an den empfangenden Server geht.
deliveredWird gesendet, wenn der empfangende Mailserver die E-Mail annimmt.
bouncedWird gesendet, wenn eine E-Mail endgültig abgelehnt wird: Die Adresse existiert nicht, die Domain kann keine Mails empfangen oder wir haben die Versuche eingestellt.
spamWird gesendet, wenn der empfangende Mailserver die E-Mail während der Zustellung als Spam oder aus Richtliniengründen ablehnt.
retryingWird jedes Mal gesendet, wenn eine E-Mail noch nicht zugestellt werden konnte und erneut versucht wird.
failedWird gesendet, wenn wir eine E-Mail aufgeben, nachdem ihre Wiederholungen aufgebraucht sind.
return_pathWird gesendet, wenn eine Bounce-Nachricht (DSN) später eintrifft, nachdem der empfangende Server die E-Mail zunächst angenommen hatte. Ein Fehler setzt die E-Mail auf bounced. Eine Verzögerungs- oder Zustellungsmeldung sendet nur dieses Event.
Tracking
Was der Empfänger nach dem Eingang damit macht.
email_openedWird gesendet, wenn ein Empfänger eine E-Mail mit aktivem Öffnungs-Tracking öffnet. Enthält Gerät, IP, Land und ob die Öffnung über einen Proxy kam.
email_clickedWird gesendet, wenn ein Empfänger einen Link in einer E-Mail mit aktivem Klick-Tracking anklickt. Enthält die URL und ob es der erste Klick war.
unsubscribeWird gesendet, wenn sich ein Empfänger über eine Ihrer E-Mails abmeldet: auf der Abmeldeseite, über den One-Click-Button seines Postfachs (Gmail, Yahoo, Outlook) oder per E-Mail über den List-Unsubscribe-Header.
tracking_preferences_updatedWird gesendet, wenn ein Empfänger auf der Seite für Tracking-Einstellungen seine Wahl zum Öffnungs- oder Klick-Tracking ändert. Er erhält Ihre E-Mails weiterhin: Das ist keine Abmeldung.
Ihr Endpoint schlägt zu oft fehl? Prüfen Sie mit Webhooks auflisten den Status. Mit Alle fehlgeschlagenen erneut senden reihen Sie Verpasstes erneut ein.