本设置指南适用于您已经有 Mailgun 并希望将其与 OneSignal 集成的情况。如果您没有 Mailgun 账户,您可以使用 OneSignal 电子邮件。
要求
- Mailgun 账户
- Mailgun 美国 API(不支持欧盟地区)
- OneSignal 账户
- 您拥有的域名和对其 DNS 提供商的访问权限
设置
1. 在 Mailgun 中添加新域名
如果您的域名已经在美国地区设置,请跳过此步骤。- 转到 Mailgun 仪表板中的 域名 页面。

导航到域名页面
- 点击添加新域名。

打开添加新域名表单
- 输入子域名(如
mail.yourdomain.com
)并确保区域为美国。

指定子域名并选择美国区域
2. Verify DNS settings
Mailgun 提供以下 DNS 记录:- 2 个 TXT(SPF 和 DKIM)
- 2 个 MX
- 1 个 CNAME
- 转到 Mailgun > 发送 > 域设置 > 您的域 > DNS 记录
- 查找每条记录旁边的绿色复选标记

验证 DNS 设置
如果 CNAME 设置不正确,电子邮件点击、打开和取消订阅跟踪将无法工作。
3. Set up SMTP credentials
- 在 Mailgun 中转到 发送 > 域设置 > SMTP 凭据。

导航到 SMTP 凭据
- 点击 添加新的 SMTP 用户。

添加新的 SMTP 凭据
- 设置登录名并保存凭据。

创建 SMTP 用户
- 点击 复制 图标以安全地保存密码。

复制 SMTP 密码
4. Get a Mailgun API key
- 在 Mailgun 仪表板中,滚动到底部并点击 API 密钥。

导航到 API 密钥
- 点击 添加新密钥

添加新密钥
- 为密钥命名并点击 创建密钥。

创建密钥
- 复制生成的 API 密钥并安全保存。

复制 API 密钥
5. Configure Mailgun in OneSignal
- 在 OneSignal 中,转到 设置 > 平台 > 电子邮件 并选择 Mailgun。

应用设置电子邮件
- 选择 Mailgun 作为提供商。

应用设置电子邮件
- Enter:

配置提供商
- 设置默认发件人姓名和
from
电子邮件地址。

配置附加设置
6. Add OneSignal webhooks to Mailgun
导航到 Mailgun > 发送 > Webhooks > 您的域 > Webhooks 并添加:
添加 webhook
7. 将跟踪协议更改为 HTTPS
确保收件人被定向到安全 URL。- 在 Mailgun 中转到您的域设置。
- 在跟踪 > 跟踪协议下,从 HTTP 更改为 HTTPS。

更改追踪协议
8. 发送测试电子邮件
- 转到 OneSignal > 消息 > 电子邮件,点击 新建电子邮件。
- 添加主题,点击 发送测试邮件,输入您的电子邮件,然后点击 发送测试消息。

发送测试电子邮件
故障排除
查看我们的电子邮件常见问题需要帮助?与我们的支持团队聊天或发送邮件至
support@onesignal.com
请包含以下信息:- 您遇到的问题详情以及复现步骤(如有)
- 您的 OneSignal 应用 ID
- 外部 ID 或订阅 ID(如适用)
- 您在 OneSignal 控制台中测试的消息 URL(如适用)
- 任何相关的日志或错误信息
电子邮件设置完成!
下一步:
- 返回电子邮件设置指南探索 OneSignal 电子邮件功能。