技术解析 · 附来源的解答

邮件 Webhook：定义与技术实现

邮件 Webhook 是由邮件服务提供商触发的 HTTP 回调，用于向目标服务器通知特定事件。应用无需轮询 API 获取状态更新；事件（例如投递失败或链接点击）一发生，服务商就会立即把 JSON 或 XML 负载推送到预先设定的 URL。

工作机制

事件发生时，邮件服务商会生成一个 HTTP POST 请求。该请求的负载包含事件元数据，包括邮件 ID、收件人地址和时间戳。接收方服务器必须在公开端点上监听，验证传入的请求，并返回 200 OK 响应以确认收到。如果服务器返回错误，服务商可能会采用指数退避策略重试投递。

对发件人的重要性

Webhook 对维护发件人信誉至关重要。通过实时接收硬退信或垃圾邮件投诉通知，开发者可以自动把无效地址从名单中移除，避免反复向失效邮箱发信，而这正是 ISP 将发件人标记为低质量的主要信号之一。对这些信号迅速作出响应，可以确保更高的整体送达率。

运维注意事项

常见故障包括接收方服务器同步处理负载时出现超时错误。为避免这种情况，开发者应采用异步架构：接收 Webhook 后，先放入 Redis 或 RabbitMQ 等系统排队，并立即确认。此外，安全性至关重要；服务器应验证服务商的签名或检查来源 IP，以防伪造的事件通知。

具体实现示例

典型的流程是在 Resend 或 Amazon SES 等服务商处配置一个 URL。当用户点击邮件中的链接时，服务商会向 /webhooks/email 发送 POST 请求，请求体类似 { event: click, email: user@example.com, link: https://site.com/offer }。随后，应用会更新数据库中的用户记录，将该营销活动标记为成功。

与工具集成

设置 Webhook 需要一个公开 URL 以及测试负载的手段。开发者可以使用 SendHQ 或其免费工具（https://sendhq.cc/tools）来满足邮件基础设施的各项技术要求，并确保配置符合行业标准。

团队常问的问题

API 和 Webhook 有什么区别？

API 是客户端向服务器发起请求以拉取数据；Webhook 则是在事件发生时，由服务器向客户端发起请求，自动推送数据。

如何保护邮件 Webhook 端点的安全？

可以在请求头中使用机密令牌、验证邮件服务提供的 HMAC 签名，或仅允许来自服务商所属特定 IP 段的传入流量。

Webhook 事件发生时我的服务器宕机了会怎样？

大多数专业服务商会将事件排队，并在数小时或数天内多次尝试重新投递，之后才会将该事件标记为无法投递。

一手资料

继续学习

入站邮件 Webhook退信处理事务性邮件 API邮件送达率Resend 邮件 API