有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

当邮件产生已递送、失败、退信、打开、点击、取消订阅等事件,腾讯云将以消息通知的方式,传递到该地址。以下是事件推送的协议格式:

请求示例

{
  "event": "delivered",
  "email": "example@example.com",
  "bulkId": "qcloud-ses-4F001945B2D9BE90362",
  "timestamp": 1587953211,
  "reason": "the reason when email failed to delivered",
  "bounceType": ""
}
字段 类型 描述
event string 事件类型,详情见下面的事件类型
email string 收件人地址
link string 用户点击的邮件中的链接URL,仅在event="click"时生效
bulkId string SendEmail接口返回的MessageId
timestamp int 事件产生的时间戳
reason string 邮件递送失败的原因
bounceType string 如果收件人邮件服务商拒信,拒信类型,取值: soft、hard,仅在 event="bounce"的时候生效

事件类型

Value Description
processed 递送中,此状态为中间状态,不一定会回调
deferred 邮件被收件人邮件服务商延迟传递,正在重试中
delivered 递送成功,收件人邮件服务商已接收此邮件
dropped 因为某种原因,这封邮件不能送达,被丢弃
open 收件人打开了此邮件
click 收件人点击了此邮件中的链接
bounce 收件人邮件服务商拒收此邮件,一般是因为邮箱地址错误
spamreport 收件人举报了此邮件
unsubscribe 收件人点击了业务方的“退订”按钮,需要业务方在退订链接中包含"unsubscribe"关键词