知识库

通过您自己的 SendGrid 账户发送电子邮件

连接您自己的 SendGrid 账户：域名身份验证及其 CNAME 记录、受限的 Mail Send 密钥而非完全访问权限、Cloudflare 灰色云陷阱，以及有效密钥出现 403 错误的实际含义。

您将需要一个 SendGrid（Twilio SendGrid）账户以及对您域名的 DNS 访问权限。

1. 认证您的域名

Settings → Sender Authentication → Authenticate Your Domain。

从列表中选择您的 DNS 服务商，并在 "Would you like to also brand the links for this domain?" 处回答 Yes —— 链接品牌化会将追踪链接重写为您的自有域名，而非 sendgrid.net，当客户将鼠标悬停在您发票中的链接上时，应当看到的是您的名字。

当系统询问您用于发送邮件的域名时，请输入一个子域名，例如 mail.yourdomain.com。

2. 发布 CNAME 记录

SendGrid 会为您提供三条或五条 CNAME 记录。请全部添加。

类型	主机	用途
`CNAME`	`em1234.yourdomain.com`	返回路径（退信）域名
`CNAME`	`s1._domainkey.yourdomain.com`	DKIM 密钥 1
`CNAME`	`s2._domainkey.yourdomain.com`	DKIM 密钥 2

⭐ SendGrid 特意使用 CNAME 而非 TXT 记录，这样做确实更好：实际的密钥值保存在 SendGrid，因此他们可以轮换签名密钥，而无需您再次修改 DNS。

⚠️ 如果您的 DNS 服务商是 Cloudflare，请将这些记录设置为仅限 DNS（灰色云朵），不要代理。经过代理的 CNAME 会解析为 Cloudflare 的地址，导致 SendGrid 验证失败。

在 SendGrid 中点击 Verify。请等待最多一小时。

3. 创建 API 密钥

Settings → API Keys → Create API Key。

选择 Restricted Access，并仅授予 Mail Send → Full Access 权限。不要赋予任何其他权限。

⛔ 请勿使用 Full Access 密钥。Full Access 密钥可以读取您的联系人、更改您的账户设置并创建更多密钥；而我们唯一需要做的就是发送邮件。如果我们保存的密钥发生泄露，这两种密钥的区别就是收到一些垃圾邮件与整个账户被盗的区别。

⚠️ 该密钥仅显示一次。 请在离开页面前复制它 —— SendGrid 无法再次向您显示该密钥，只能替换它。

4. 在 Zinn® 中连接

在您的控制面板中打开邮件发送：

服务商 — SendGrid
发件域名 — mail.yourdomain.com（域名，而非邮箱地址）
SendGrid API 密钥 — 步骤 3 中的密钥

SendGrid 不需要您进行其他任何设置。

5. 发送测试并输入验证码

点击发送测试邮件至其他域名下的收件箱，查看其中的验证码并输入。

当出现问题时

403 Forbidden — 您的 API 密钥没有 Mail Send 权限。这是目前最常见的失败原因：创建了一个没有勾选任何作用域的 Restricted Access 密钥，该密钥虽然可以正常通过身份验证，但无权执行任何操作。

"The from address does not match a verified Sender Identity" — 您的域名认证尚未变为绿色通过状态，或者发件域名中填写的域名不是您通过认证的域名。SendGrid 会严格比对域名：认证 mail.yourdomain.com 并不授权从 yourdomain.com 发送邮件。

已接收但从未送达 — 请查看 SendGrid 中的 Activity。全新账户在第一天左右有时会被搁置审查，邮件会停留在那里而不是被退回。

发送数次后您的账户被暂停 — SendGrid 对向会导致退信的地址发送邮件的新账户要求十分严格。在切换之前，请务必确保您的客户列表是干净有效的。