Node.js SDK

关于国际/港澳台短信2024年9月1日调整价格的公告

关于国际/港澳台短信价格调整的公告

关于腾讯云短信模板类型优化公告

关于马来西亚短信禁止含链接、电话号码等内容的公告

严禁通过腾讯云短信服务发送金融营销、赌博、诈骗等违规信息知会

关于国际/港澳台短信内容长度计算规则调整的公告

关于国际/港澳台短信部分地区价格调整的公告

公告

动态与公告

常用概念

产品概述

产品简介

使用须知

签名审核标准

正文模板审核标准

正文模板示例

常见模板驳回原因与处理建议

审核驳回原因

审核标准

国际/港澳台短信概述

国际/港澳台短信功能介绍

国际/港澳台短信应用场景

国际/港澳台短信 Sender ID 说明

国际/港澳台短信简介

国际/港澳台短信计费概述

国际/港澳台短信价格总览

 国际/港澳台短信购买指南 

国际/港澳台短信快速入门

国际/港澳台短信

控制台说明

管理国际/港澳台短信签名

管理国际/港澳台短信正文模板

发送国际/港澳台短信

客户管理

营销管理

创建应用

配置基础信息

配置告警联系人

停用或删除应用

应用管理

配置回复回调

管理免打扰名单

通用管理

访问管理综述

可授权的资源及操作

预设策略

自定义策略

访问管理

控制台指南

如何群发祝福短信

如何实现短信验证码功能

实践教程

History

Introduction

API Category

Request Structure

Common Params

Signature v3

Signature

Responses

Making API Requests

PullSmsReplyStatus

PullSmsReplyStatusByPhoneNumber

PullSmsSendStatus

PullSmsSendStatusByPhoneNumber

Status Pull APIs

CallbackStatusStatistics

SendStatusStatistics

SMS Statistics APIs

AddSmsSign

DeleteSmsSign

DescribeSmsSignList

ModifySmsSign

SMS Signature APIs

SendSms

SMS Delivery APIs

DescribePhoneNumberInfo

SMS Mobile Number APIs

ReportConversion

SMS Conversion Rate APIs

AddSmsTemplate

DeleteSmsTemplate

DescribeSmsTemplateList

ModifySmsTemplate

SMS Template APIs

Data Types

Error Codes

短信发送和回执状态错误码

短信下发状态通知

短信回复

短信回调相关接口

API 文档

SDK 下载

Java SDK

PHP SDK

Python SDK

C# SDK

Go SDK

C++ SDK

SDK 文档

费用相关问题

安全相关问题

签名相关问题

模板相关问题

发送内容相关问题

其他问题

常见问题

Service Level Agreement

联系我们

短信

SDK 3.0是云 API 3.0平台的配套工具，您可以通过 SDK 使用所有 

https://intl.cloud.tencent.com/document/product/382/40463

。新版 SDK 实现了统一化，具有各个语言版本的 SDK 使用方法相同，接口调用方式相同，错误码相同以及返回包格式相同等优点。

接入国际站需要使用短信 API 2021-01-11 版本，可参考示例代码。

一次群发请求最多支持200个号码。

个人认证用户不支持使用签名、正文模板相关接口，只能通过短信控制台 

https://intl.cloud.tencent.com/document/product/382/35456

https://intl.cloud.tencent.com/document/product/382/35457

。如需使用该类接口，请将 “个人认证” 变更为 “企业认证”。

https://intl.cloud.tencent.com/zh/document/product/382/13299#.E5.9C.B0.E5.9F.9F

已开通短信服务，具体操作请参见 

https://intl.cloud.tencent.com/document/product/382/35452

SecretID 用于标识 API 调用者的身份。

SecretKey 用于加密签名字符串和服务器端验证签名字符串的密钥，

各个接口及其参数的详细介绍请参见 

https://github.com/tencentcloud/tencentcloud-sdk-nodejs

https://gitee.com/tencentcloud/tencentcloud-sdk-nodejs

https://github.com/tencentcloud/tencentcloud-sdk-nodejs#%E9%80%9A%E8%BF%87-npm-%E5%AE%89%E8%A3%85

https://gitee.com/tencentcloud/tencentcloud-sdk-nodejs#%E9%80%9A%E8%BF%87-npm-%E5%AE%89%E8%A3%85

https://github.com/tencentcloud/tencentcloud-sdk-nodejs#%E9%80%9A%E8%BF%87%E6%BA%90%E7%A0%81%E5%8C%85%E5%AE%89%E8%A3%85

https://gitee.com/tencentcloud/tencentcloud-sdk-nodejs#%E9%80%9A%E8%BF%87%E6%BA%90%E7%A0%81%E5%8C%85%E5%AE%89%E8%A3%85

所有示例代码仅作参考，无法直接编译和运行，需根据实际情况进行修改，您也可以根据实际需求使用 

https://console.tencentcloud.com/api/explorer?Product=sms&Version=2021-01-11&Action=SendSms

每个接口都有一个对应的 Request 结构和一个 Response 结构。本文仅列举几个常用功能的示例代码，如下所示。 

const tencentcloud = require("tencentcloud-sdk-nodejs")

// 导入对应产品模块的client models。

const smsClient = tencentcloud.sms.v20210111.Client

/* 实例化要请求产品(以sms为例)的client对象 */

  /* 为了保护密钥安全，建议将密钥设置在环境变量中或者配置文件中。

   * 硬编码密钥到代码中有可能随代码泄露而暴露，有安全隐患，并不推荐。

   * CAM密匙查询: https://console.tencentcloud.com/cam/capi */

    secretId: process.env.TENCENTCLOUD_SECRET_ID,

    secretKey: process.env.TENCENTCLOUD_SECRET_KEY,

  /* 必填：地域信息，根据您选择的国际站地域，如您选择的是新加坡国际站，则应该填入字符串ap-singapore，地域列表可参考https://intl.cloud.tencent.com/document/api/382/40466?lang=en#region-list */

   * 客户端配置对象，可以指定超时时间等配置 */

    /* SDK默认用TC3-HMAC-SHA256进行签名，非必要请不要修改这个字段 */

      reqTimeout: 10, // 请求超时时间，默认60s

      endpoint: "sms.tencentcloudapi.com"

/* 请求参数，根据调用的接口和实际情况，可以进一步设置请求参数

 * 属性可能是基本类型，也可能引用了另一个数据结构

 * 推荐使用IDE进行开发，可以方便的跳转查阅各个接口和数据结构的文档说明 */

  /* 短信应用ID: 短信SdkAppId在 [短信控制台] 添加应用后生成的实际SdkAppId，示例如2400006666 */

  /* 短信签名内容: 使用 UTF-8 编码，必须填写已审核通过的签名，签名信息可登录 [短信控制台] 查看 */

  /* 短信码号扩展号: 默认未开通，如需开通请联系 [sms helper] */

  /* 国际/港澳台短信 senderid: 中国大陆地区短信填空，默认未开通，如需开通请联系 [sms helper] */

  /* 用户的 session 内容: 可以携带用户侧 ID 等上下文信息，server 会原样返回 */

  /* 下发手机号码，采用 e.164 标准，+[国家或地区码][手机号]

   * 示例如：+60198890000， 其中前面有一个+号 ，60为国家码，198890000为手机号，最多不要超过200个手机号*/

  /* 模板 ID: 必须填写已审核通过的模板 ID。模板ID可登录 [短信控制台] 查看 */

  /* 模板参数: 若无模板参数，则设置为空*/

// 通过client对象调用想要访问的接口，需要传入请求对象以及响应回调函数

client.SendSms(params, function (err, response) {

  // 请求异常返回，打印异常信息

  // 请求正常返回，打印response对象

      reqTimeout: 30, // 请求超时时间，默认60s

  // 短信应用ID: 短信SdkAppId在 [短信控制台] 添加应用后生成的实际SdkAppId，示例如2400006666

client.PullSmsSendStatus(params, function (err, response) {

    // 短信应用ID: 短信SdkAppId在 [短信控制台] 添加应用后生成的实际SdkAppId，示例如2400006666

    // 偏移量 注：目前固定设置为0

    // 开始时间，yyyymmddhh 需要拉取的起始时间，精确到小时

    // 结束时间，yyyymmddhh 需要拉取的截止时间，精确到小时

    // 注：EndTime 必须大于 BeginTime

client.SendStatusStatistics(params, function (err, response) {

  TemplateContent: "{1}为您的登录验证码，请于{2}分钟内填写，如非本人操作，请忽略本短信。",

  /* 短信类型，1表示营销短信，2表示通知短信，3表示验证码短信 */

  /* 是否国际/港澳台短信：0：表示中国大陆地区短信; 1：表示国际/港澳台短信 */

  /* 模板备注：例如申请原因，使用场景等 */

client.AddSmsTemplate(params, function (err, response) {

tencent cloud