<!-- SMS4J SpringBoot3啟動器 官方最新穩(wěn)定版3.3.5 -->
<dependency>
    <groupId>org.dromara.sms4j</groupId>
    <artifactId>sms4j-spring-boot-starter</artifactId>
    <version>3.3.5</version>
</dependency>
<!-- SMS4J OA消息通知 -->
<dependency>
    <groupId>org.dromara.sms4j</groupId>
    <artifactId>sms4j-oa-core</artifactId>
    <version>3.3.5</version>
</dependency>

spring:
  application:
    name: sms4j-demo
# SMS4J核心配置，3.3.5版本支持短信+OA雙配置
sms:
  config-type: yaml
  blends:
    # 阿里云短信配置
    aliyun:
      supplier: alibaba
      accessKeyId: 您的阿里云AccessKey
      accessKeySecret: 您的阿里云Secret
      signature: 短信簽名
      templateId: SMS_215125134
      templateName: code
      requestUrl: dysmsapi.aliyuncs.com
   oas:
     oaDingTalkByYaml: # configId
       isEnable: true # 表示該配置是否生效(默認(rèn)生效,false表示不生效)
       supplier: ding_ding # 廠商標(biāo)識
       tokenId: 您的accessKey # webhook 中的 access_token
       sign: 您的sign # 安全設(shè)置在驗(yàn)簽?zāi)Ｊ较虏诺拿罔€，非驗(yàn)簽?zāi)Ｊ經(jīng)]有此值

import cn.hutool.core.util.RandomUtil;
import org.dromara.oa.api.OaSender;
import org.dromara.oa.comm.entity.Request;
import org.dromara.oa.comm.entity.Response;
import org.dromara.oa.comm.enums.MessageType;
import org.dromara.oa.core.provider.factory.OaFactory;
import org.dromara.sms4j.api.SmsBlend;
import org.dromara.sms4j.api.entity.SmsResponse;
import org.dromara.sms4j.core.factory.SmsFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
 
import java.util.ArrayList;
 
@RestController
@RequestMapping("/sms")
public class SmsController {
 
    /**
     * 通用短信驗(yàn)證碼發(fā)送接口
     * @param phone 接收短信的手機(jī)號
     * @return 發(fā)送結(jié)果反饋
     */
    @GetMapping("/send/{phone}")
    public String sendSmsCode(@PathVariable String phone) {
        // 獲取對應(yīng)廠商標(biāo)識的短信實(shí)例，和yml配置一一對應(yīng)
        SmsBlend smsBlend = SmsFactory.getSmsBlend("aliyun");
        // 生成6位純數(shù)字驗(yàn)證碼，適配絕大多數(shù)驗(yàn)證碼場景
        String code = RandomUtil.randomNumbers(6);
        // 執(zhí)行短信發(fā)送，參數(shù)順序嚴(yán)格匹配短信模板變量順序
        SmsResponse response = smsBlend.sendMessage(phone, code);
        // 結(jié)果返回，開發(fā)階段可直接返回驗(yàn)證碼調(diào)試，生產(chǎn)環(huán)境建議隱藏
        if (response.isSuccess()) {
            return "短信發(fā)送成功，驗(yàn)證碼：" + code;
        }
        return "短信發(fā)送失敗，失敗原因：" + response.getData().toString();
    }
 
    /**
     * 通用OA通知發(fā)送接口
     * @param phone 接收通知的手機(jī)號
     * @return 發(fā)送結(jié)果反饋
     */
    @GetMapping("/send/oa/notice/{phone}")
    public String sendOANotice(@PathVariable String phone) {
        String configId = "oaDingTalkByYaml";
        OaSender alarm = OaFactory.getSmsOaBlend(configId);
        Request request = new Request();
        ArrayList<String> phones = new ArrayList<>();
        phones.add(phone);
        // 支持通過手機(jī)號@
        request.setPhoneList(phones);
        // 支持@all
        // request.setIsNoticeAll(true);
        request.setContent("測試消息");
        Response response = alarm.sender(request, MessageType.DING_TALK_TEXT);
        // 結(jié)果返回
        if (response.isSuccess()) {
            return "OA通知消息發(fā)送成功";
        }
        return "OA通知消息發(fā)送失敗，失敗原因：" + response.getData().toString();
    }
}