配置 VERP 以处理退回的电子邮件

[Discourse]

设置反弹处理

Discourse 使用 可变信封退回路径 (VERP) 技术来处理弹出的电子邮件。

要启用 VERP，请使用包含 + 符号的电子邮件地址模板设置“reply by email address”站点设置。默认的
replies+%{reply_key}@discourse.example.com
……工作正常。如果您使用的是您自己或您公司的电子邮件服务器，那么就这样了

您的 Discourse 实例必须能够接收发送到此地址的电子邮件。这应该可以通过 POP 正常工作，但我们强烈推荐自托管站点的直接投递入站邮件

但是，如果您使用第三方电子邮件服务，则需要启用 VERP，或按如下所示激活其 webhooks：

MailGun

1. 登录 MailGun 并转到您的仪表板；在左侧栏中查找 发送 → Webhooks 页面。
2. 选择 配置 选项卡并复制 HTTP 签名密钥
3. 在您的 Discourse 站点中，使用您的 HTTP 签名密钥 设置 Mailgun API key 站点设置
4. 返回 Mailgun，单击 添加 Webhook 按钮（选择 域级别）并将 HTTP post URL 设置为 https://your.discourse/webhooks/mailgun。测试此项。
5. 选择 永久失败 和 临时失败，仔细检查域，然后创建 Webhook。

SendGrid

• 登录 SendGrid 并转到邮件设置
• 展开 事件 Webhook 设置，如果尚未启用，则启用它
• 单击 编辑 将 HTTP POST URL 设置为 http://your.discourse/webhooks/sendgrid
• 确保选择了以下 3 个操作： 已丢弃、已推迟 和 已反弹
• 单击 保存您的更改

MailJet

• 登录 MailJet 并转到事件跟踪
• 检查 反弹 事件
• 将 端点 URL 设置为 http://your.discourse/webhooks/mailjet
• 选中 分组事件 列中的
• 单击 save 按钮

SparkPost

• 登录 SparkPost 并转到您的仪表板。
• 从左侧菜单图标中选择 帐户
• 从菜单中选择 Webhooks ( SparkPost )
• 选择 New Webhook。
• 为 Webhook 名称 输入一个友好的值，例如 Discourse Forum
• 输入 目标 URL 为 http://your.discourse/webhooks/sparkpost
• 选择 Add Webhook。

Amazon Simple Email Service (AWS SES)

• 在 Discourse 上：
  • 如 OP 顶部所述，设置 reply by email enabled 和 reply by email address
  • 设置 manual polling enabled
• 在 AWS 上：
  • 创建一个 SNS 主题
  • 为创建的主题创建一个 SNS 订阅，作为指向 https://your.discourse/webhooks/aws 的 HTTPS
  • 转到 SES > 验证的身份，选择您的站点域，然后转到“通知”选项卡。编辑您的反馈通知。将“反弹反馈”和“投诉反馈”设置为您刚刚创建的 SNS 主题

Postmark

• 登录 Postmark，然后选择用于发送 Discourse 电子邮件的服务器
• 选择与 Discourse 电子邮件相关的消息流，通常是默认事务性流
• 单击 Webhooks
• 单击 添加 Webhook
• 输入 Webhook URL 为 http://your.discourse/webhooks/postmark
• 在“我们应该发送哪些事件？”下，选中 投递 和 垃圾邮件投诉
• 向下滚动并单击 保存 Webhook

测试反弹

为确保一切正常，请执行以下操作：

1. 在您的站点上使用一个明显不正确的电子邮件地址注册一个新帐户，格式为 bademail@obviously-invalid-domain.com 或 clearly.nobody.has.this.email.address@gmail.com
2. 等待一段时间让电子邮件完全反弹（如果您愿意，可以检查您提供商的日志——它们通常会显示在“警告”或“错误”日志级别下）
3. 检查您站点上的 /admin/email/bounced 以确认反弹已被捕获。请记住，这可能需要长达 48 小时，具体取决于重试次数和您的电子邮件提供商的具体逻辑。

配置反弹

可以使用以下站点设置自定义反弹处理：

• 软反弹分数：当我们的电子邮件地址收到临时反弹时，添加到用户“反弹分数”的分数
• 硬反弹分数：当我们的电子邮件地址收到永久（或未知）反弹时，添加到用户“反弹分数”的分数
• 反弹分数重置天数：在我们收到无反弹邮件的天数内，我们可以将用户的“反弹分数”重置为 0
• 反弹分数阈值：达到此分数阈值后，我们将停止向用户发送非紧急电子邮件

---

最后由 @SaraDev 在 2022-07-19T20:00:00Z 查看

[pfaffman (Jay Pfaffman)]

如果有人想测试一下，并确认它是否有效，我会把它添加到 OP 中。

创建 Mailgun 网页钩子

for event_type in 'permanent_fail' 'temporary_fail'; do
curl -s --user 'api:'=mg_api_key= \
          https://api=mg_region=.mailgun.net/v3/domains/$discourse_hostname/webhooks \
          -F id="$event_type" \
          -F url="https://=discourse_hostname=/webhooks/mailgun"
done

[nathank (Nathan Kershaw)]

更新了 Mailgun 部分，因为他们的 UI 有一些小变化：

@zogstrip

MailGun

1. 登录 MailGun 并转到 您的仪表板；在左侧列中找到 Sending → Webhooks 页面。
2. 确保选择了正确的域（桌面版在右上角）
3. 在 Discourse 中，将 mailgun api key 站点设置设置为您的 HTTP webhook signing key
4. 单击 Add webhook 按钮，将“Event Type”菜单设置为“Permanent Failure”，并将 URL 设置为 https://your.discourse/webhooks/mailgun
5. 重复 Add webhook 部分，选择“Temporary Failure”作为“Event Type”
   • 有一个“Test webhook”部分可用于测试，但它不会保存 - 请确保您改用 Add webhook 按钮

[markersocial]

目前是否有简单的方法可以使用 VERP 来自动处理电子邮件投诉？针对那些不取消订阅但仅将电子邮件标记为垃圾邮件的用户。停止向投诉的用户发送电子邮件至关重要。

[Jagster (Jakke Flemming)]

仅供技能水平较低的各位参考：SES 部分估计已经严重过时了。

即使系统建议，也请不要选择 FIFO

[Abdelrahman_MoHamed]

@Discourse

mailgun api key

你好 @pfaffman ，感谢分享，但请快速帮忙解答一下：

如果我使用的是上面列表中未列出的其他电子邮件提供商，是否仍然可行？

[Sailor]

在我的日志中，端点 webhooks/mailjet 产生了一个警告：

收到了一个 Mailjet 网页钩子，但未配置令牌。这是不安全的行为，将来将被禁止。

在 /admin/site_settings/category/email?filter=mailjet 中有一个“Mailjet 网页钩子令牌”字段，但没有关于如何正确设置的说明。

我去了 https://app.mailjet.com/account/triggers，并在“端点 URL”字段中添加了：https://discourse.example.org/webhooks/mailjet?t=[your_token]

我将 [your_token] 替换为由 Token Generator 生成的一个令牌，并在 /admin/site_settings/category/email?filter=mailjet 的“Mailjet 网页钩子令牌”字段中输入了相同的值。

这似乎消除了日志中的警告。

[markersocial]

@markersocial

目前是否有简单的方法可以使用 VERP 来自动处理电子邮件投诉？针对那些不取消订阅但仅将电子邮件标记为垃圾邮件的用户。停止向抱怨的用户发送电子邮件至关重要。

我想指出，我已经确认，AWS SES 的垃圾邮件投诉会从 complaints@email-abuse.amazonses.com 发送到“回复电子邮件地址”（在 Discourse 设置中），并且在目前标准的 VERP 配置下（没有 SNS 网页钩子），会被 Discourse 视为硬退订。

[markersocial]

发现这个，对使用 SES 的人可能也有用（“使用邮箱模拟器”部分）：

Sending test emails in Amazon SES with the simulator - Amazon Simple Email...

可以在 Discourse 管理后台使用“发送测试邮件”功能，向特定地址发送邮件，从而模拟退信和投诉等情况，而不会损害你的发送声誉。

例如：

bounce@simulator.amazonses.com
complaint@simulator.amazonses.com

上面链接中还有其他测试地址。

[nathank (Nathan Kershaw)]

Mailgun 部分已更新，因为情况又发生了一些变化（向好的方面！）。