tencent cloud

邮件推送

动态与公告
产品动态
关于新增独立 IP 增值服务的公告
产品简介
产品概述
产品功能
产品优势
应用场景
规格明细
购买指南
价格说明
快速入门
邮件配置
邮件发送
信誉度等级说明
控制台指南
邮件配置
邮件发送
数据统计
投递回应
API 文档
History
Introduction
API Category
调用方式
域名验证相关接口
邮件相关接口
模板相关接口
统计相关接口
发信地址相关接口
黑名单相关接口
查询发送状态相关接口
批量任务相关接口
自定义黑名单相关接口
Data Types
Error Codes
SMTP 文档
SMTP 发送邮件指南
SMTP 服务地址
Java 调用示例
Go 调用示例
PHP 调用示例
Python 调用示例
C# 调用示例
发送带附件的邮件
错误码
Webhook 文档
邮件通知事件
发件限制
附件类型
常见问题
入门相关问题
计费相关问题
发送限制相关问题
发送功能相关问题
域名相关问题
模板相关问题
身份验证和配置相关问题
独立 IP 相关问题
递送相关问题
API 使用相关问题
回调相关问题
垃圾箱相关问题
安全性相关问题
域名加速配置相关问题
注意事项
其他问题
联系我们

邮件通知事件

PDF
聚焦模式
字号
最后更新时间: 2025-10-30 11:08:29
设置回调地址后,腾讯云将在产生“递送成功、腾讯云拒信、ESP 退信、用户打开邮件、点击链接、退订”等事件后通知到回调地址。通过邮件推送控制台,您可以配置回调地址的操作,请参见 回调地址

请求示例

{
"event":"bounce",
"email":"example@example.com",
"bulkId":"qcloudses-30-251200670-date-20220601142439-8jolHvR2XcXC1",
"timestamp":1654064683,
"reason":"551 5.1.1 recipient is not exist",
"bounceType":"hard_bounce",
"username":"251200670",
"from":"test@fromexample.com",
"fromDomain":"fromexample.com",
"templateId":123456,
"subject":"example subject",
"messageId":"ea2783c1-7704-48a8-af36-2b9e83e767ec@fromexample.com",
"sentTimestamp":1761555487,
"X-Tencentcloudses-Cb-Custom":"ses callback"
}
字段
类型
描述
event
string
事件类型,详情请参见 事件类型
email
string
收件人地址
link
string
用户点击的邮件中的链接 URL,仅在event="click"时生效
bulkid
string
SendEmail 接口返回的 MessageId
timestamp
int
事件产生的时间戳
reason
string
邮件递送失败的原因
bounceType
string
如果收件人邮件服务商拒信,拒信类型,取值:soft_bounce | hard_bounce,仅在event="bounce"的时候生效
username
string
腾讯云账号对应的 appId
from
string
发信地址(不带发件人别名)
fromDomain
string
发信域名
templateId
int
模板 Id
useragent
string
用户代理提供有关用于访问邮件的设备、操作系统和浏览器的信息,仅对 open 和 click 事件生效
subject
string
邮件主题,若包含非 ASCII 字符(例如中文),则会使用 MIME 编码进行转义。
messageId
string
smtp 协议头中的 Message-ID,用户在使用 smtp 或 API 发送时可以传自已定义的邮件唯一标识符,注意这个一定要能够唯一标识一封邮件且符合 RFC5322标准。
eventid
int
1:delivered
2:dropped
3:bounce
4:open
5:click
6:spamreport
7:unsubscribe
8:deferred
taskId
int
批量发送任务的 taskId
sentTimestamp
int
发送时间戳
X-Tencentcloudses-Cb-
string
在邮件头中设置以"X-Tencentcloudses-Cb-"为前缀的自定义内容,支持在api、smtp发送中设置。api发送可以通过接口SendEmail的参数SmtpHeaders设置。

事件类型

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


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈