秒级短信通知！手把手教你集成腾讯云短信功能

2023-02-04 22:20:02

轻松集成腾讯云短信，赋能你的SpringBoot应用

在当今快节奏的数字时代，短信已成为一种不可或缺的沟通渠道。它提供了即时性和广泛的可访问性，使其成为广泛应用场景的理想选择。对于开发人员来说，将短信功能集成到他们的应用程序中变得至关重要。本博客将引导你一步步完成将腾讯云短信功能集成到SpringBoot项目的详细过程。

准备工作

1. 注册腾讯云账号并实名认证

访问腾讯云官网并创建一个账号。
完成实名认证以验证你的身份。

2. 创建云通信短信服务，购买短信套餐或申请免费额度

登录腾讯云控制台，导航到云通信 > 短信。
创建一个短信服务实例并购买短信套餐或申请免费额度。

3. 获取密钥ID和密钥Key

在短信服务实例的详情页面，找到“密钥管理”部分。
单击“创建密钥”以生成密钥对。
将密钥ID和密钥Key复制到安全的地方，因为它们对于调用短信API至关重要。

集成依赖

1. 在pom.xml文件中添加依赖

<dependency>
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tencentcloud-sdk-sms</artifactId>
    <version>3.0.14</version>
</dependency>

2. 刷新Maven依赖

使用Maven命令 mvn clean install 或使用IDE的依赖管理功能刷新依赖。

配置腾讯云短信属性

1. 在application.properties或application.yml文件中配置

# 腾讯云短信服务配置
tencentcloud.sms.secret-id=YOUR_SECRET_ID
tencentcloud.sms.secret-key=YOUR_SECRET_KEY
tencentcloud.sms.region=ap-guangzhou
# 短信模板ID，需要在腾讯云控制台配置
tencentcloud.sms.template-id=YOUR_TEMPLATE_ID

将密钥ID、密钥Key和短信模板ID替换为自己的值。

编写Java代码

1. 创建短信发送服务类

@Service
public class SmsService {

    @Autowired
    private SmsClient smsClient;

    public void sendSms(String phoneNumber, String templateParams) {
        try {
            SendSmsRequest request = new SendSmsRequest();
            // 国际/港澳台手机号前加国家区号
            request.setPhoneNumberSet(phoneNumber);
            // 模板参数需要使用 JSON 格式字符串
            request.setTemplateParamSet(templateParams);
            // 短信模板ID，需要在腾讯云控制台配置
            request.setTemplateId(templateId);

            // 发送短信
            SendSmsResponse response = smsClient.sendSms(request);

            // 打印响应信息
            System.out.println(response.getRequestId());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. 在需要发送短信的地方调用SmsService

@Controller
public class MyController {

    @Autowired
    private SmsService smsService;

    @PostMapping("/send-sms")
    public String sendSms(@RequestParam String phoneNumber) {
        // 构建模板参数
        String templateParams = "{\"code\": \"123456\"}";

        // 调用发送短信服务
        smsService.sendSms(phoneNumber, templateParams);

        return "success";
    }
}