退订

每封群发邮件都带有两种退订机制，你无需进行任何配置。

链接

{{{SPACEPOST_UNSUBSCRIBE_URL}}} 会展开为类似 https://app.spacepost.dev/u/<token> 的 URL。该令牌按联系人签名，因此无法被猜出或篡改。

• 打开链接会显示确认页面（“Stop receiving emails at j***@example.com?”）。GET 请求绝不会让任何人退订，因此链接扫描器和邮件安全工具不会误让人退订。页面上的地址已做脱敏处理。
• 点击按钮会发送一个 POST 请求，将该联系人的 unsubscribed 标记设为 true。

如果你的 HTML 中没有退订占位符，系统会为你追加一个带链接的页脚（纯文本部分则追加一行文字）。把占位符放进你自己的设计中，即可控制措辞和位置。

标头

SpacePost 会添加 Gmail 和 Yahoo 对群发邮件所要求的标头：

List-Unsubscribe: <https://app.spacepost.dev/u/<token>>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

有了这些标头，Gmail 和 Apple Mail 会在发件人旁边显示原生的退订按钮。点击后，邮件客户端会向该 URL 发送 POST 请求，按照 RFC 8058 的规定立即让联系人退订。这对你的信誉远比收件人点击垃圾邮件按钮要好得多。

之后会发生什么

• 该联系人会被之后发送给该受众的所有群发跳过。
• 目前退订不会向你的 Webhook 发送任何事件；请从 GET /audiences/{id}/contacts/{idOrEmail} 读取 unsubscribed 标记，或列出联系人，以同步你自己的数据库。
• 如需让提出要求的人重新订阅，请对该联系人执行 PATCH，传入 { "unsubscribed": false }。仅在对方明确要求时才这样做。

事务邮件

退订链接适用于营销邮件。重置密码、收据和安全通知不需要退订链接。如果你通过 POST /emails 发送营销内容，请自行添加这些标头（参见自定义标头）并在你这边处理退订，或者改用群发。