为API触发的营销活动创建反馈Webhook webhooks
利用反馈Webhook,可接收通过事务性API触发的营销活动发送的消息的实时状态更新。 通过配置webhook,您可以自动将投放结果直接接收至您的系统,从而实现监控、日志记录和自动处理。
您可以从 管理 / 渠道 / 反馈webhook设置 菜单管理webhook配置。
创建反馈webhook
要创建webhook,请执行以下步骤:
-
导航到 管理 / 渠道 / 反馈webhook设置。
-
单击 创建反馈Webhook。
-
在 基本配置 部分中,提供以下详细信息:
- Webhook名称 — 输入描述性名称以标识webhook。
- 渠道 — 选择此webhook应接收其反馈(电子邮件和/或短信)的渠道。
- Webhook URL — 提供必须向其传递反馈事件的HTTPS终结点。
-
在 身份验证 部分中,选择身份验证方法:
- 无身份验证 — 未添加身份验证标头。
- JWT身份验证 — 如果您的端点需要JWT身份验证,请提供所需的详细信息。
-
在 标头参数 部分中,配置要随每个webhook请求发送的其他自定义标头。
-
单击 提交 以保存配置。
Webhook有效载荷结构
消息执行后,Journey Optimizer 将以下有效负载发送到配置的终结点。
{
"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
}
]
}
}
webhook可以捕获以下事件:
- 已发送
- 已送达
- 跳出(请参阅以上示例)
- 错误
每个传入请求还包括一个发送回webhook的唯一请求ID。