邮箱与自动发货
本篇讲解为什么邮箱应作为首要发货方式、收货邮箱如何收集、SMTP 参数如何填写、发货模板变量如何使用,以及发货失败后的处理流程。
📮 为什么邮箱应作为首要发货方式
QQ 官方机器人拿不到用户的 QQ 号(只有 openid),「自动发到 QQ 邮箱」不成立;机器人私聊又受主动消息权限、沙箱限制和平台风控影响。邮箱不要求用户先加机器人好友,用户也能长期保存卡密、教程和售后说明。
因此 v1.10.0 起,群聊下单必须提供收货邮箱(「发货设置 → 下单必须填写收货邮箱」,默认开启):没邮箱先提示补邮箱,不会建单——绝不出现「付了钱却没有收件人」。私聊下单不拦截(私聊本身就是一条送达通道)。
当前发货链路:
下单(必带收货邮箱) → 支付成功 → 邮件发送
├─ 送达 → 群内播报「支付成功 + 卡密已发至邮箱(@买家)」
└─ 失败 → 自动补发复核(可配次数,默认 1 次)
├─ 复核通过 → 按送达播报
└─ 仍失败 → 群内 @ 买家提醒(每单只提醒一次)v1.12.0 起群内播报按真实发货结果:卡密送达才报「已发货」,失败先自动复核再提醒,不会再出现「邮件明明收到了、群里却报发货失败」。
📧 三种收货邮箱收集方式
- 下单时直接带上(推荐):
购买 1 支付宝 邮箱 user@example.com; - 待支付时补:
邮箱 user@example.com(或邮箱 订单号 邮箱精确补到某单); - 按钮补邮箱(v1.11.0):支付成功但订单没邮箱时,机器人会在群里 @ 买家本人并给一个「📧 填写收货邮箱」按钮。买家点按钮后 10 分钟内直接发邮箱地址(或 QQ 号),系统就只把这一笔订单的卡密发到该邮箱——别人点别人的按钮会被拒绝,不会串单;管理员可代操作。
QQ 官方按钮只能「替用户发一条指令」,不能弹输入框,所以点完按钮还需要买家自己把邮箱发出来。
邮箱地址属于隐私信息,建议私聊机器人发送。若用户在群内填写,管理员应提醒其注意隐私,但插件仍会按当前消息处理。
⚙️ SMTP 参数
| 字段 | 说明 |
|---|---|
| SMTP 主机 | 邮箱服务商提供,例如 QQ 邮箱的 SMTP 地址 |
| 端口 | SSL/TLS 常用 465,STARTTLS 常用 587 |
| 安全连接 | 按服务商要求选择自动、SSL/TLS 或 STARTTLS |
| 用户名 | 通常是完整邮箱地址 |
| 密码/授权码 | 优先填写邮箱后台生成的 SMTP 授权码 |
| 发件地址 | 收件人看到的邮箱地址,通常与用户名一致 |
| 发件昵称 | 收件人看到的发件人名称,例如「ZL-售卡系统」 |
| 测试收件人 | 只用于发送测试邮件 |
授权码不是登录密码
QQ、163 等邮箱通常要求先在官网设置中开启 SMTP,再生成授权码。网页登录密码不一定可用于 SMTP。
✏️ 发件昵称、主题与正文的区别
| 字段 | 作用 |
|---|---|
| 发件昵称 | 邮件列表里显示的发送者名称 |
| 主题模板 | 邮件标题,例如 【{商品名称}】订单 {订单号} 已发货 |
| 正文模板 | 邮件打开后的内容 |
| 商品使用教程 / 售后说明 | 通过模板变量插入正文,不应成为发件昵称 |
建议主题:
【{商品名称}】订单 {订单号} 发货通知正文至少包含:订单号、商品、金额、卡密、使用教程、售后说明和发货时间。
🧾 配置步骤
- 点击邮箱预设,自动填写常见主机和端口;
- 填写用户名、授权码、发件地址和发件昵称;
- 选择安全连接;
- 保存配置;
- 点击「测试连接」;
- 填写测试收件人并发送测试邮件;
- 检查收件箱和垃圾箱;
- 核对中文、换行、发件昵称、主题与正文;
- 再用真实订单测试模板变量。
测试连接成功不等于发货正常
「测试连接」只说明登录 SMTP 成功,不代表正文模板和真实发货流程一定正确,所以仍需发送测试邮件和真实 0.01 元订单。
📨 用户怎样提交邮箱
推荐在下单指令中直接填写:
购买 1 支付宝 邮箱 user@example.com也可以在订单待支付时发送:
邮箱 user@example.com或点机器人发的「📧 填写收货邮箱」按钮(见上文三种收集方式)。
邮箱地址属于隐私信息,建议私聊机器人发送。若用户在群内填写,管理员应提醒其注意隐私,但插件仍会按当前消息处理。
🧩 发货模板变量
「发货设置 → 发货消息模板」用于机器人临时会话/私聊发货,邮箱设置中的正文模板用于邮件发货,两者变量通用:
{用户QQ} {用户昵称} {群号} {订单号} {商品名称}
{卡密内容} {商品说明} {使用教程} {售后说明}
{支付金额} {支付方式} {支付时间} {邮箱}- 商品的「发货附加话术」会在模板渲染完成后自动追加到消息末尾,无需写变量;
- 模板被清空时(0.1.0 起)插件加载配置会自动恢复为默认发货模板:
你的订单已支付成功
订单号:{订单号}
商品:{商品名称}
卡密:
{卡密内容}
商品说明:
{商品说明}
使用教程:
{使用教程}
售后说明:
{售后说明}保持变量完整
变量名称应保持花括号完整,不要随意改字。发送测试邮件时如果没有真实订单,部分变量可能使用示例值,最终以真实 0.01 元订单为准。
🚑 发货失败处理
- 在订单详情确认支付状态与邮箱地址;
- 查看运行日志中的 SMTP 错误;
- 检查授权码是否被重置、账号是否触发安全限制;
- 检查主机、端口和安全连接是否匹配;
- 检查商品是否允许邮件发货;
- 修复配置并保存;
- 在订单管理点击补发,或使用管理员补发指令;
- 告知用户检查垃圾箱。
补发不扣库存
补发会使用原订单卡密,不会重复扣减库存。
📚 下一节:群内指令与运营
