微信小程序接入腾讯云短信验证码流程

以下是针对 AA公司微信小程序接入腾讯云短信验证码 的 全流程操作指南，包含资质申请、签名/模板配置、代码对接的完整解决方案：

一、资质申请（必须通过审核才能发短信）

1️⃣ 进入资质管理页

• 路径：腾讯云控制台 → 短信 → 实名资质管理 → 添加资质

2️⃣ 填写资质信息

字段	填写要求	示例 (AA公司)
资质名称	自定义标识名称	AA公司短信主资质
资质属性	选「自用」（AA公司小程序主体与腾讯云账号实名主体一致） ❗ 若不一致需选「他用」并上传授权书	○ 自用
企业证件类型	营业执照或统一社会信用代码证	营业执照
资质证件	上传盖公章的营业执照 → 支持PNG/JPG ≤5MB → 水印文字：仅用于办理腾讯云短信增值服务
法定代表人	上传法人身份证正反面（需在有效期内）	张三的身份证正反面扫描件

3️⃣ 提交审核

• ✅ 审核时效：2小时内（工作时间优先审核）
• ⚠️ 注意事项：
  • 公章必须清晰可见，且与营业执照名称一致
  • 避免非工作时间提交（周末/节假日延审）

二、创建短信签名（标识短信发送方）

1️⃣ 路径：短信 → 签名管理 → 创建签名

2️⃣ 关键配置项

字段	填写规范	AA公司示例
签名类型	APP应用 → 选**「微信小程序」**
签名内容	小程序全称（需与微信开放平台一致）	AA生活服务
证明文件	上传两者之一： ① 《软件著作权证书》 ② 微信小程序后台设置页截图
申请说明	写明用途：用于AA公司微信小程序用户注册验证码发送

三、申请短信模板（验证码内容规范）

1️⃣ 路径：短信 → 正文模板管理 → 创建模板

2️⃣ 模板配置

模板名称：用户注册验证码
模板类型：验证码
短信内容：
  您的验证码为：{1}，请于{2}分钟内填写。如非本人操作，请忽略本短信。 #腾讯云会过滤【】符号
申请说明：用户手机号注册验证场景

3️⃣ 参数说明

四、微信小程序代码对接（Node.js示例）

1️⃣ 安装 SDK

npm install tencentcloud-sdk-nodejs-sms --save

2️⃣ 封装短信服务 (/service/sms.js)

const tencentcloud = require("tencentcloud-sdk-nodejs-sms");
const SmsClient = tencentcloud.sms.v20210111.Client;

const client = new SmsClient({
  credential: {
    secretId: process.env.TENCENT_SECRET_ID,   // 从环境变量读取
    secretKey: process.env.TENCENT_SECRET_KEY,
  },
  region: "ap-guangzhou", // 按资质所属地域填写
});

// 发送验证码函数
exports.sendVerificationCode = async (phone, code) => {
  const req = {
    PhoneNumberSet: [phone],
    SmsSdkAppId: "1400006789",          // 短信应用ID(控制台获取)
    SignName: "AA生活服务",             // 第2步创建的签名
    TemplateId: "1717171",              // 第3步模板ID
    TemplateParamSet: [code.toString(), "5"], // 验证码+有效期
  };
  
  try {
    const res = await client.SendSms(req);
    return { success: res.SendStatusSet[0].Code === "Ok" };
  } catch (err) {
    console.error("短信发送失败:", err);
    throw new Error("SMS_SERVICE_ERROR");
  }
};

3️⃣ 注册接口调用（/controllers/user.js）

const { sendVerificationCode } = require("../service/sms");
const crypto = require("crypto");

// 生成6位数字验证码
const generateCode = () => Math.floor(100000 + Math.random() * 900000);

// 用户注册入口
exports.register = async (req, res) => {
  const { phone } = req.body;
  
  // 1. 生成验证码并缓存(Redis推荐)
  const code = generateCode();
  await cache.set(`REG:${phone}`, code, "EX", 300); // 5分钟有效期

  // 2. 发送短信
  try {
    await sendVerificationCode(phone, code);
    res.json({ code: 0, message: "验证码已发送" });
  } catch (err) {
    res.status(500).json({ code: 1001, message: "短信服务异常" });
  }
};

五、全流程避坑指南

💡 终极调试方案：

1. 在腾讯云控制台使用「短信调试」工具直接测试API
   
2. 查看错误码：腾讯云短信错误码列表

完成以上步骤后，AA公司微信小程序即可实现 「手机号→获取验证码→注册」 的安全闭环。建议上线前用测试手机号全链路验证（测试模板需单独申请）。