C++ 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

Node.js SDK

C# SDK

Go 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/document/product/378/37276

https://intl.cloud.tencent.com/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-cpp

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

https://github.com/tencentcloud/tencentcloud-sdk-cpp#%E7%8E%AF%E5%A2%83%E4%BE%9D%E8%B5%96

https://gitee.com/tencentcloud/tencentcloud-sdk-cpp#%E7%8E%AF%E5%A2%83%E4%BE%9D%E8%B5%96

https://github.com/tencentcloud/tencentcloud-sdk-cpp#%E4%BB%8E%E6%BA%90%E4%BB%A3%E7%A0%81%E6%9E%84%E5%BB%BA-sdk

https://gitee.com/tencentcloud/tencentcloud-sdk-cpp#%E4%BB%8E%E6%BA%90%E4%BB%A3%E7%A0%81%E6%9E%84%E5%BB%BA-sdk

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

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

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

#include <tencentcloud/core/TencentCloud.h>

#include <tencentcloud/core/profile/HttpProfile.h>

#include <tencentcloud/core/profile/ClientProfile.h>

#include <tencentcloud/core/Credential.h>

#include <tencentcloud/core/NetworkProxy.h>

#include <tencentcloud/core/AsyncCallerContext.h>

#include <tencentcloud/sms/v20210111/SmsClient.h>

#include <tencentcloud/sms/v20210111/model/SendSmsRequest.h>

#include <tencentcloud/sms/v20210111/model/SendSmsResponse.h>

using namespace TencentCloud::Sms::V20210111;

using namespace TencentCloud::Sms::V20210111::Model;

    // 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey, 切勿将密钥泄露给他人

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

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

    // 前往 https://console.tencentcloud.com/cam/capi 获取 API 密钥 SecretId SecretKey

    Credential cred = Credential(getenv("TENCENTCLOUD_SECRET_ID"),                                 

                                 getenv("TENCENTCLOUD_SECRET_KEY"));

    // 实例化一个http选项，可选的，没有特殊需求可以跳过。

    HttpProfile httpProfile = HttpProfile();

    httpProfile.SetKeepAlive(true);  // 状态保持，默认是False

    httpProfile.SetEndpoint("sms.tencentcloudapi.com");  // 指定接入地域域名(默认就近接入)

    httpProfile.SetReqTimeout(10);  // 请求超时时间，单位为秒(默认60秒)

    httpProfile.SetConnectTimeout(10); // 响应超时时间，单位是秒(默认是60秒)

    ClientProfile clientProfile = ClientProfile(httpProfile);

    SendSmsRequest req = SendSmsRequest();

     * 短信控制台: https://console.tencentcloud.com/smsv2

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

    /* 短信签名内容: 使用 UTF-8 编码，必须填写已审核通过的签名 */

    /* 模板 ID: 必须填写已审核通过的模板 ID */

    /* 模板参数: 模板参数的个数需要与 TemplateId 对应模板的变量个数保持一致，若无模板参数，则设置为空 */

    req.SetTemplateParamSet(std::vector<std::string>{"1234"});

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

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

    req.SetPhoneNumberSet(std::vector<std::string>{"+60198890000"});

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

    /* 短信码号扩展号（无需要可忽略）: 默认未开通，如需开通请提交工单*/

    /* 国际/港澳台短信 senderid（无需要可忽略）: 国内短信填空，默认未开通，如需开通请提交工单 */

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

     * 第二个参数是地域信息，可以直接填写字符串ap-singapore，支持的地域列表参考 https://intl.cloud.tencent.com/document/api/382/40466?lang=en#region-list */

    SmsClient sms_client = SmsClient(cred, "ap-singapore", clientProfile);

    // 设置代理（无需要直接忽略）

    // NetworkProxy proxy = NetworkProxy(NetworkProxy::Type::HTTP, "localhost.proxy.com", 8080);

    // sms_client.SetNetworkProxy(proxy);

    auto outcome = sms_client.SendSms(req);

        cout << outcome.GetError().PrintAll() << endl;

    SendSmsResponse rsp = outcome.GetResult();

    cout<<"RequestId="<<rsp.GetRequestId()<<endl;

    cout<<"SendSmsResponse="<<rsp.ToJsonString()<<endl;

    /* 当出现以下错误码时，快速解决方案参考

     * [FailedOperation.SignatureIncorrectOrUnapproved](https://intl.cloud.tencent.com/document/product/382/9558)

     * [FailedOperation.TemplateIncorrectOrUnapproved](https://intl.cloud.tencent.com/document/product/382/9558)

     * [UnauthorizedOperation.SmsSdkAppIdVerifyFail](https://intl.cloud.tencent.com/document/product/382/9558)

     * [UnsupportedOperation.ContainDomesticAndInternationalPhoneNumber](https://intl.cloud.tencent.com/document/product/382/9558)

#include <tencentcloud/sms/v20210111/model/PullSmsSendStatusRequest.h>

#include <tencentcloud/sms/v20210111/model/PullSmsSendStatusResponse.h>

    httpProfile.SetReqTimeout(30);  // 请求超时时间，单位为秒(默认60秒)

    httpProfile.SetConnectTimeout(30); // 响应超时时间，单位是秒(默认是60秒)

    PullSmsSendStatusRequest req = PullSmsSendStatusRequest();

    // 设置拉取最大条数，最多100条

    // cvm_client.SetNetworkProxy(proxy);

    auto outcome = sms_client.PullSmsSendStatus(req);

    PullSmsSendStatusResponse rsp = outcome.GetResult();

    cout<<"PullSmsSendStatusResponse="<<rsp.ToJsonString()<<endl;

#include <tencentcloud/sms/v20210111/model/SendStatusStatisticsRequest.h>

tencent cloud