Skip to content

邮箱与自动发货 ​

本篇讲解为什么邮箱应作为首要发货方式、收货邮箱如何收集、SMTP 参数如何填写、发货模板变量如何使用,以及发货失败后的处理流程。

📮 为什么邮箱应作为首要发货方式 ​

QQ 官方机器人拿不到用户的 QQ 号(只有 openid),「自动发到 QQ 邮箱」不成立;机器人私聊又受主动消息权限、沙箱限制和平台风控影响。邮箱不要求用户先加机器人好友,用户也能长期保存卡密、教程和售后说明。

因此 v1.10.0 起,群聊下单必须提供收货邮箱(「发货设置 → 下单必须填写收货邮箱」,默认开启):没邮箱先提示补邮箱,不会建单——绝不出现「付了钱却没有收件人」。私聊下单不拦截(私聊本身就是一条送达通道)。

当前发货链路:

text
下单(必带收货邮箱) → 支付成功 → 邮件发送
                                   ├─ 送达 → 群内播报「支付成功 + 卡密已发至邮箱(@买家)」
                                   └─ 失败 → 自动补发复核(可配次数,默认 1 次)
                                              ├─ 复核通过 → 按送达播报
                                              └─ 仍失败 → 群内 @ 买家提醒(每单只提醒一次)

v1.12.0 起群内播报按真实发货结果:卡密送达才报「已发货」,失败先自动复核再提醒,不会再出现「邮件明明收到了、群里却报发货失败」。

📧 三种收货邮箱收集方式 ​

  1. 下单时直接带上(推荐):购买 1 支付宝 邮箱 user@example.com;
  2. 待支付时补:邮箱 user@example.com(或 邮箱 订单号 邮箱 精确补到某单);
  3. 按钮补邮箱(v1.11.0):支付成功但订单没邮箱时,机器人会在群里 @ 买家本人并给一个「📧 填写收货邮箱」按钮。买家点按钮后 10 分钟内直接发邮箱地址(或 QQ 号),系统就只把这一笔订单的卡密发到该邮箱——别人点别人的按钮会被拒绝,不会串单;管理员可代操作。

QQ 官方按钮只能「替用户发一条指令」,不能弹输入框,所以点完按钮还需要买家自己把邮箱发出来。

邮箱地址属于隐私信息,建议私聊机器人发送。若用户在群内填写,管理员应提醒其注意隐私,但插件仍会按当前消息处理。

⚙️ SMTP 参数 ​

字段说明
SMTP 主机邮箱服务商提供,例如 QQ 邮箱的 SMTP 地址
端口SSL/TLS 常用 465,STARTTLS 常用 587
安全连接按服务商要求选择自动、SSL/TLS 或 STARTTLS
用户名通常是完整邮箱地址
密码/授权码优先填写邮箱后台生成的 SMTP 授权码
发件地址收件人看到的邮箱地址,通常与用户名一致
发件昵称收件人看到的发件人名称,例如「ZL-售卡系统」
测试收件人只用于发送测试邮件

授权码不是登录密码

QQ、163 等邮箱通常要求先在官网设置中开启 SMTP,再生成授权码。网页登录密码不一定可用于 SMTP。

✏️ 发件昵称、主题与正文的区别 ​

字段作用
发件昵称邮件列表里显示的发送者名称
主题模板邮件标题,例如 【{商品名称}】订单 {订单号} 已发货
正文模板邮件打开后的内容
商品使用教程 / 售后说明通过模板变量插入正文,不应成为发件昵称

建议主题:

text
【{商品名称}】订单 {订单号} 发货通知

正文至少包含:订单号、商品、金额、卡密、使用教程、售后说明和发货时间。

🧾 配置步骤 ​

  1. 点击邮箱预设,自动填写常见主机和端口;
  2. 填写用户名、授权码、发件地址和发件昵称;
  3. 选择安全连接;
  4. 保存配置;
  5. 点击「测试连接」;
  6. 填写测试收件人并发送测试邮件;
  7. 检查收件箱和垃圾箱;
  8. 核对中文、换行、发件昵称、主题与正文;
  9. 再用真实订单测试模板变量。

测试连接成功不等于发货正常

「测试连接」只说明登录 SMTP 成功,不代表正文模板和真实发货流程一定正确,所以仍需发送测试邮件和真实 0.01 元订单。

📨 用户怎样提交邮箱 ​

推荐在下单指令中直接填写:

text
购买 1 支付宝 邮箱 user@example.com

也可以在订单待支付时发送:

text
邮箱 user@example.com

或点机器人发的「📧 填写收货邮箱」按钮(见上文三种收集方式)。

邮箱地址属于隐私信息,建议私聊机器人发送。若用户在群内填写,管理员应提醒其注意隐私,但插件仍会按当前消息处理。

🧩 发货模板变量 ​

「发货设置 → 发货消息模板」用于机器人临时会话/私聊发货,邮箱设置中的正文模板用于邮件发货,两者变量通用:

text
{用户QQ} {用户昵称} {群号} {订单号} {商品名称}
{卡密内容} {商品说明} {使用教程} {售后说明}
{支付金额} {支付方式} {支付时间} {邮箱}
  • 商品的「发货附加话术」会在模板渲染完成后自动追加到消息末尾,无需写变量;
  • 模板被清空时(0.1.0 起)插件加载配置会自动恢复为默认发货模板:
text
你的订单已支付成功

订单号:{订单号}
商品:{商品名称}

卡密:
{卡密内容}

商品说明:
{商品说明}

使用教程:
{使用教程}

售后说明:
{售后说明}

保持变量完整

变量名称应保持花括号完整,不要随意改字。发送测试邮件时如果没有真实订单,部分变量可能使用示例值,最终以真实 0.01 元订单为准。

🚑 发货失败处理 ​

  1. 在订单详情确认支付状态与邮箱地址;
  2. 查看运行日志中的 SMTP 错误;
  3. 检查授权码是否被重置、账号是否触发安全限制;
  4. 检查主机、端口和安全连接是否匹配;
  5. 检查商品是否允许邮件发货;
  6. 修复配置并保存;
  7. 在订单管理点击补发,或使用管理员补发指令;
  8. 告知用户检查垃圾箱。

补发不扣库存

补发会使用原订单卡密,不会重复扣减库存。


📚 下一节:群内指令与运营

薇薇官机平台 · ZL 系列插件