Erstellen von Feedback-Webhooks für durch API ausgelöste Kampagnen webhooks
Feedback-Webhooks ermöglichen es Ihnen, Statusaktualisierungen in Echtzeit für Nachrichten zu erhalten, die über durch API ausgelöste Transaktions-Kampagnen gesendet werden. Durch die Konfiguration eines Webhooks können Sie automatisch Versandergebnisse direkt in Ihren Systemen empfangen, was Überwachung, Protokollierung und automatisierte Verarbeitung ermöglicht.
Sie können Webhook-Konfigurationen über das Menü Administration/Kanäle/Feedback-Webhook-Einstellungen verwalten.
Erstellen eines Feedback-Webhooks
Gehen Sie wie folgt vor, um einen Webhook zu erstellen:
-
Navigieren Sie zu Administration/Kanäle/Feedback Webhook-Einstellungen.
-
Klicken Sie auf Feedback-Webhook erstellen.
-
Geben Sie im Abschnitt Grundkonfiguration die folgenden Details an:
- Webhook-Name: Geben Sie einen beschreibenden Namen zur Identifizierung des Webhooks ein.
- Kanäle: Wählen Sie die Kanäle aus, für die dieser Webhook Feedback erhalten soll (E-Mail und/oder SMS).
- Webhook-URL: Geben Sie den HTTPS-Endpunkt an, an den Feedback-Ereignisse gesendet werden sollen.
-
Wählen Sie im Abschnitt Authentifizierung die Authentifizierungsmethode aus.
- Keine Authentifizierung: Es werden keine Authentifizierungs-Header hinzugefügt.
- JWT-Authentifizierung: Geben Sie die erforderlichen Details an, wenn Ihr Endpunkt eine JWT-Authentifizierung erfordert.
-
Im Abschnitt Header-Parameter können Sie zusätzliche benutzerdefinierte Header konfigurieren, die mit jeder Webhook-Anfrage gesendet werden sollen.
-
Klicken Sie auf Senden, um die Konfiguration zu speichern.
Webhook-Payload-Struktur
Nach der Ausführung einer Nachricht sendet Journey Optimizer die folgende Payload an den konfigurierten Endpunkt.
{
"requestId": "8NoByJneShCdCGRnrGS1t1m3CdA73dhR",
"imsOrg": "myImsOrg",
"sandbox": {
"id": "068abf40-575e-11ea-8512-9b1bfdb82603",
"name": "prod"
},
"channel": "email",
"eventType": "message.feedback",
"messageExecution": {
"messageExecutionID": "HUMA-26362805",
"messageType": "transactional",
"campaignID": "16f24a15-7e21-477c-848a-d5695ca7f137",
"campaignVersionID": "2ca10c10-56dd-4505-87cd-fa5da84e7a5d"
},
"messageDeliveryFeedback": {
"feedbackStatus": {
"value": "bounce"
},
"offers": null,
"messageExclusion": null,
"messageFailure": {
"category": "sync",
"type": "Ignored",
"code": "25",
"reason": "Admin Failure"
},
"retryCount": 0
},
"identityMap": {
"email": [
{
"id": "john.doe@luma.com",
"primary": true
}
]
}
}
Der Webhook kann die folgenden Ereignisse erfassen:
- Gesendet
- Zugestellt
- Bounce (siehe obiges Beispiel)
- Fehler
Jede eingehende Anfrage enthält auch eine eindeutige requestId, die an den Webhook zurückgesendet wird.
Nächste Schritte next
Nachdem ein Feedback-Webhook erstellt wurde, können Sie ihn bei der Konfiguration einer Zielgruppe von durch API ausgelösten Transaktionskampagnen aktivieren. Weitere Informationen finden Sie in diesem Abschnitt: Aktivieren von Webhooks