当前位置：首页 > news >正文

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

news 2025/6/30 8:32:15

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

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

1️⃣ 进入资质管理页

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

2️⃣ 填写资质信息

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

3️⃣ 提交审核

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

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

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

2️⃣ 关键配置项

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

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

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

2️⃣ 模板配置

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

3️⃣ 参数说明

占位符	类型	示例值	作用
{1}	数字	`384592`	随机6位验证码
{2}	数字	`5`	验证码有效期(分钟)

四、微信小程序代码对接（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步模板IDTemplateParamSet: [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: "短信服务异常" });}
};

五、全流程避坑指南

环节	高频错误	解决方案
资质审核	公章模糊/证件过期	使用高清扫描件+有效期验证
签名驳回	小程序名称与签名不一致	检查微信开放平台名称
模板审核	未声明「验证码」用途	在模板中显式包含「验证码」关键词
代码发送失败	SecretId/Key 泄露	用环境变量存储密钥 → 严禁硬编码
用户收不到	触发频率限制(默认1条/分钟，30条/天)	控制台调整频控策略 → 设置链接