ChatHub/docs

搜索文档

为你推荐200 条结果

在已发布文章中搜索 · 按小节

移动打开esc关闭ChatHub docs
系统配置使用 Resend 配置 SMTP
配置指南管理员指南

使用 Resend 配置 SMTP

接入 Resend 用于 ChatHub 的密码重置、员工邀请和工作流邮件：验证域名、创建 API 密钥、配置 SMTP 并发送测试邮件。

ChatHub Team·阅读约 6 分钟

开始之前#

邮件设置由密码重置、员工邀请和工作流中的“发送邮件”步骤共用。请准备：一个具有设置管理权限的 ChatHub 账号、一个 Resend 账号、一个你拥有的域名，以及该域名 DNS 设置的访问权限。

noreply@example.com 和 support@example.com 仅为示例，请替换成你自己的地址。不要把真实的 API 密钥写入源代码、截图或支持工单。

1. 在 Resend 中验证发信域名#

  1. 1

    登录 Resend，打开 Domains，添加你将用于发信的域名或子域名。

  2. 2

    打开域名详情页的 Records 标签页。在你的 DNS 服务商处按 Resend 提供的记录逐条添加，类型、名称和值都要完全一致。不要照抄其他域名的示例值。

  3. 3

    点击 Verify DNS Records 并等待发信验证通过。若显示 pending，请检查记录并留出生效时间。域名验证通过后再继续。

  4. 4

    在该已验证域名下选择发信地址。例如验证了 mail.example.com，就可以使用 noreply@mail.example.com。

Resend：管理域名与 DNS 记录 ↗

Resend：已验证域名说明 ↗

2. 为 ChatHub 创建 API 密钥#

  1. 1

    在 Resend 中打开 API Keys，创建一个专用密钥，取一个便于识别的名称，例如 ChatHub SMTP。

  2. 2

    选择 Sending access（发信权限），若有该选项，把密钥限制到你的发信域名。

  3. 3

    创建后立即复制密钥并妥善保存。Resend 不会再次显示它的值。稍后你要把它粘贴到 ChatHub 的“密码”字段。

Resend 的 SMTP 密码就是 API 密钥，不是 Resend 账号密码，也不是 Gmail 应用专用密码。从其他服务商切换过来时，请填入新的 Resend 密钥。

Resend：管理 API 密钥 ↗

3. 填写 ChatHub 的邮件设置#

打开 管理 → 设置 → 邮件，或在你自己的 ChatHub 域名下访问 /settings?tab=email。在 SMTP 面板中填写以下字段（括号内为越南语界面的标签，便于对照）：

  1. 1

    SMTP 服务器（Máy chủ SMTP）：smtp.resend.com，不要带 https://。

  2. 2

    加密方式（Mã hoá）：STARTTLS。端口（Cổng）：587。

  3. 3

    登录账号（Tài khoản đăng nhập）：resend。

  4. 4

    密码（Mật khẩu）：粘贴 Resend API 密钥。若已存在密码，该字段会显示为“新密码”（Mật khẩu mới）；输入新密钥即可替换。

  5. 5

    发件人名称（Tên người gửi）：你的店铺或品牌名称，例如 ChatHub。

  6. 6

    发件地址（Địa chỉ gửi）：已验证域名下的地址。请把示例 noreply@example.com 换成你自己的地址。

  7. 7

    回复地址（Địa chỉ nhận trả lời）：一个你会查看的邮箱。请把 support@example.com 换成真实地址。若希望回复直接发到发件地址且该地址可以收信，可以留空。

  8. 8

    打开“启用邮件发送”（Bật gửi email）开关。

图 1。越南语界面：在左侧选择“邮件”，输入图中的服务器地址和账号。在右侧的密码框中粘贴你的 Resend API 密钥。这是未保存的示意截图，不含真实密钥。
图 2。越南语界面：把 example.com 的示例地址换成你自己的地址。发件地址必须使用你在 Resend 已验证的域名；回复地址应是你会查看的邮箱。保存前记得开启邮件发送。图中数值为未保存的示例。
使用 Resend 时务必填写发件地址。若留空，ChatHub 会把 SMTP 账号“resend”当作发件人，而它并不是有效的邮箱地址。界面上“账号通常是你的邮箱”的通用提示不适用于 Resend。

若使用 465 端口，请选择 SSL/TLS 而不是 STARTTLS。修改加密方式后要同时检查两个字段。常见搭配为 STARTTLS + 587 或 SSL/TLS + 465。

Resend：官方 SMTP 配置说明 ↗

4. 保存并发送测试邮件#

  1. 1

    核对设置后点击“保存”（Lưu）。等待提示 “Đã lưu cấu hình email.”（邮件配置已保存）。

  2. 2

    在测试区块的“发送至”（Gửi tới）中填入你自己的邮箱。系统会用已保存的配置发送一封真实邮件。

  3. 3

    点击“发送测试邮件”（Gửi thư thử），阅读结果并检查收件箱（包括垃圾邮件）。核对发件人名称、发件地址和回复地址。

  4. 4

    若邮件没有收到，在 Resend 中打开 Emails 页面查看该 SMTP 消息及其状态。ChatHub 提示发送成功并不代表一定进入收件箱。

图 3。越南语界面：先点击下方的“保存”（Lưu），再使用上方的“发送至”（Gửi tới）和“发送测试邮件”（Gửi thư thử）。截图中按钮呈灰色，是因为该示意配置尚未保存。请把 your-email@example.com 换成你自己的邮箱。这不是发送成功的截图。
在保存 SMTP 服务器之前，以及配置有未保存的改动时，测试按钮都不可用。每次修改设置或 API 密钥后都要先保存再测试。“已配置”只表示已保存 SMTP 服务器，并不代表投递成功。

ChatHub 会加密保存密码且不再显示。把“新密码”留空即保持原密码不变，所以保存后该字段为空属于正常现象。关闭“启用邮件发送”并保存，可以在保留配置的同时停止发送系统邮件。

5. 问题排查#

  1. 1

    认证被拒绝：检查账号是否为 resend，密码是否为对应域名且具备发信权限的有效 API 密钥。重新输入密钥并保存。

  2. 2

    发件人或域名报错：确认发件地址已填写、格式正确、属于已验证的 Resend 域名，并在密钥允许的范围内。

  3. 3

    SSL/TLS 报错：使用 STARTTLS + 587 或 SSL/TLS + 465。不要为了消除报错而改用不加密模式。

  4. 4

    连接失败或超时：检查 smtp.resend.com 以及 ChatHub 服务器的对外 SMTP 连通性，包括 DNS、防火墙和主机商限制。

  5. 5

    提示未配置或已停用：检查 SMTP 服务器地址，开启邮件发送并保存。

  6. 6

    收件人被拒或达到发送上限：阅读错误详情，检查收件地址和当前 Resend 账号的额度限制。

  7. 7

    已发送但收不到：在 Resend 的 Emails 页面查看该消息，检查垃圾邮件和收件地址，然后跟踪该消息的状态。

本文对照 ChatHub 的邮件界面、源代码以及 Resend 官方文档核对。撰写过程中没有创建 API 密钥、修改 DNS、保存正式配置，也没有发送测试邮件。
使用 Resend 配置 SMTP回到顶部
© 2026 ChatHub DocsPowered by CMSNT LTDChatHub 使用文档。