Skapa feedback-webhooks för API-utlösta kampanjer webhooks
Med hjälp av webhooks för feedback kan ni ta emot statusuppdateringar i realtid för meddelanden som skickas via kampanjer som triggas av transaktions-API. Genom att konfigurera en webkrok kan ni automatiskt få leveransresultat direkt till era system, vilket möjliggör övervakning, loggning och automatiserad bearbetning.
Du kan hantera webbkrokkonfigurationer på menyn Administration / Channels / Feedback webhook settings .
Skapa en webkrok för feedback
Så här skapar du en webkrok:
-
Navigera till Administration / Channels / Feedback webhook settings.
-
Klicka på Skapa webkrok för feedback.
-
Ange följande information i avsnittet Basic Configuration:
- Webkrok-namn - Ange ett beskrivande namn som identifierar webkroken.
- Kanaler - Välj kanal(er) som den här webkroken ska få feedback för (e-post och/eller SMS).
- Webkroks-URL - Ange HTTPS-slutpunkten där feedback-händelser måste levereras.
-
Välj autentiseringsmetod i avsnittet Authentication:
- Ingen autentisering - Inga autentiseringshuvuden läggs till.
- JWT-autentisering - Ange nödvändig information om slutpunkten kräver JWT-autentisering.
-
I avsnittet Header Parameters konfigurerar du ytterligare anpassade rubriker som ska skickas med varje webkrok-begäran.
-
Klicka på Submit för att spara konfigurationen.
Webkroks nyttolaststruktur
Efter en meddelandekörning skickar Journey Optimizer följande nyttolast till den konfigurerade slutpunkten.
{
"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
}
]
}
}
Webbhoven kan fånga följande händelser:
- Skickat
- Levererat
- Studsa (se exemplet ovan)
- Fel
Varje inkommande begäran innehåller också ett unikt requestId som skickas tillbaka till webkroken.
Nästa steg next
När en webkrok för feedback har skapats kan du aktivera den när du konfigurerar en transaktionell API-utlöst kampanj-målgrupp. Läs mer i det här avsnittet: Aktivera webhooks