发信服务(SMTP)
邮件渠道通过你自己的 SMTP 服务器发信 —— RooQuiz 不代发。所以通知是从你自己的地址发出的,也没有平台层面的发送量限制。
在设置 → 组织 → 发信服务里配一次,团队里所有邮件连接器共用这一份。
没有已验证的发信服务时,邮件连接器仍然能保存,但一封都投不出去。它的卡片上会显示红色的「未配置发信服务」标记。
填什么
| 字段 | 说明 |
|---|---|
| SMTP 服务器 | 服务商给的主机名,如 smtp.gmail.com |
| 端口 | 587(STARTTLS)、465(SSL/TLS)或 2525 |
| 用户名 | 通常是完整邮箱地址;部分服务商用固定字面量 |
| 密码 | SMTP 密码或 API key。以后修改其他字段时留空,就沿用已保存的那个 |
| 发件人地址 | 必须是这台 SMTP 服务器允许代发的地址 |
| 发件人名称 | 收件人看到的显示名 |
| 回复地址 | 选填,希望回复走别处时才用 |
25 端口不能用。 我们的托管平台封禁了该端口的出站连接,请用 587 或 465。
各服务商怎么填
| 字段 | 值 |
|---|---|
| SMTP 服务器 | smtp.gmail.com |
| 端口 | 587 (STARTTLS) |
| 用户名 | 完整的 Gmail 地址 |
| 密码 | 16 位应用专用密码 |
| 发件人地址 | 同一个 Gmail 地址,或该账号里已验证的「以此身份发送」别名 |
去 myaccount.google.com/apppasswords 生成应用专用密码。它只显示一次,格式是四组四位 —— 粘贴前把空格去掉。
账号密码是不行的。Google 已经关闭了邮件客户端的密码登录,只能用应用专用密码 —— 而应用专用密码只有在两步验证已开启时才存在。
如果那个页面显示「你要找的设置不适用于你的账号」,原因是三者之一:两步验证没开;这是 Google Workspace 账号且管理员禁用了应用专用密码;或者账号加入了高级保护计划(会直接禁掉这个功能)。
另外 Gmail 有发送上限:个人账号约每天 500 个收件人,Workspace 约 2000。对团队通知完全够用,但不适合群发。
保存并验证
填好字段,点「保存并验证」
保存和验证是同一个动作,所以不会出现「存下来了但没测过」的中间状态。
去收件箱找那封测试邮件
测试邮件发往你自己的 RooQuiz 账号邮箱 —— 也就是你当前登录用的那个,不是你刚填的发件人地址。如果没收到,先查那个邮箱和它的垃圾邮件文件夹,别急着改配置。
确认状态显示「已验证」
「已验证」的含义是:你的 SMTP 服务器接收了这封信并返回了成功码。这不等于送达 —— SMTP 服务器是先收下、再往外转投,所以信件之后仍可能被判垃圾或被退回。如果验证通过却没收到,问题在收件一侧:先看垃圾邮件文件夹,再去发件邮箱里找退信。
验证失败时
页面上会原样显示你的 SMTP 服务器返回的错误,刻意不做转述,方便你直接照着处理。常见的几种:
| 错误 | 含义 |
|---|---|
535 Username and Password not accepted | 凭据不对。Gmail 的情况通常是用了账号密码,或者应用专用密码里的空格没去掉 |
553 Sender address rejected: not owned by user | 发件人地址不在这台服务器允许代发的范围里。改成该账号真正拥有的邮箱或别名 |
550 relay not permitted | 服务器完全不为你转投 —— 一般是用户名填错,或该邮箱没开 SMTP 权限 |
| 超时 / 连接失败 | 主机名或端口不对,或者服务器不接受来自外网的连接 |
一些细节
- 密码保存后不再回显。修改其他字段时把它留空,已保存的密码不会被动。
- 改动服务器、端口、用户名、密码或发件人地址,状态会退回未验证,直到下一次验证成功。
- 保存与验证有频率限制,每个团队每小时只能试几次 —— 每一次都会真的连接你的服务器、真的发出一封信。
- 移除发信服务会删掉已保存的密码。改配置不需要先移除,直接覆盖保存即可。只要还有启用中的邮件连接器,移除会被拒绝 —— 免得你把自己的投递静默弄坏。
- 如果之后某次投递永久失败(凭据失效、发件人地址被拒),状态会变成验证失败,邮件连接器会停止投递直到你修好。单个收件人地址失效不会导致这种情况,那只会让那一封信失败。
五个渠道
连接支持五个渠道：邮件（走你自己的 SMTP 服务器）、Webhook、Slack、Zapier 与 Kit。每个渠道每个团队只能配置一条连接，要换掉已有的得先删除。这一页说明每个渠道分别投递什么、收件人与消息格式怎么设置、各自需要哪些前置配置。邮件渠道每条最多十个收件人，也可以把「答题者邮箱」作为动态收件人直接通知本人。
触发事件与范围
每条连接自己决定什么时候触发（事件）和哪些测评能触发它（范围），两者是「与」的关系：事件命中、且来源测评在范围内，才会投递。这一页列出全部触发事件的含义、如何把范围收敛到指定测评、范围留空代表全部，以及常见的事件与范围组合建议。常见组合例如：只让主推的那份测评在产生新线索时推 Slack，其余测评保持安静。