Webhooks in DirectIQ ermöglichen es Ihnen, Benachrichtigungen in Echtzeit über Ereignisse zu erhalten, sobald in Ihrer E-Mail-Aktivität etwas passiert. Anstatt Berichte manuell abzurufen oder eine API regelmäßig abzufragen, sendet DirectIQ automatisch Daten an Ihren konfigurierten Endpunkt, sobald ein Ereignis eintritt.
Im Dashboard Integrationen → Webhooks können Sie alle konfigurierten Webhooks, deren Status (Aktiv oder Inaktiv) sowie das Erstellungsdatum einsehen. Im gezeigten Beispiel ist ein Webhook-Endpunkt aktiv und bereit, transaktionale E-Mail-Ereignisse zu empfangen.
Um einen Webhook zu erstellen, klicken Sie oben rechts auf Neuen Webhook erstellen und geben Sie die Endpunkt-URL an.
Der Secret Key ist bereits generiert. Wenn Sie ihn neu generieren, müssen Sie diesen auch in Ihrer Implementierung aktualisieren.
Die auswählbaren Ereignisse für E-Mails sind: email.sent, email.opened und email.bounced, email.complaint. Für Domains sind es: domain.unverified, domain.verified.
Sie können entweder spezifische Ereignisse auswählen oder auch alle auswählen.
Nach dem Speichern wird der Webhook sofort aktiv und beginnt, Ereignisse wie email.sent, email.opened und email.clicked zu empfangen.
Bestehende Webhooks können über das Drei-Punkte-Menü (⋮) auf der rechten Seite jeder Zeile bearbeitet werden. Dadurch können Sie die Endpunkt-URL aktualisieren, ohne den Webhook neu anzulegen.
Sie können einen Webhook auch aktivieren/deaktivieren, falls Sie die Ereignisübermittlung vorübergehend pausieren möchten, ohne die Konfiguration zu löschen. Deaktivierte Webhooks bleiben in der Liste sichtbar und können jederzeit wieder aktiviert werden.
Wenn ein Webhook nicht mehr benötigt wird, kann er aus demselben Menü dauerhaft gelöscht werden. Nach der Löschung werden keine Ereignisse mehr übermittelt und dies kann nicht rückgängig gemacht werden.
Alle Webhook-Ereignisse enthalten eine gemeinsame TransactionalId, mit der Sie den vollständigen Lebenszyklus einer E-Mail über mehrere Ereignisse hinweg verfolgen können (gesendet → geöffnet → geklickt → zurückgewiesen → Beschwerde).
Siehe auch: