跳到主要内容
POSTsdk.groupNotify去调试

多模态组呼通知接口 (groupNotify)

支持 文字转语音 (TTS 自动合成朗读) 与 语音音频录音文件 (.wav) 两种模式，向目标群体批量下发应急通知。

SDK 方法调用说明​

SDK 调用方法签名：

const res = await sdk.groupNotify(options);

对应后台接口端点：

POST /dispatch-web/api/call/groupNotify

SDK 调用代码示例 (JavaScript Demo)​

模式一：文字转语音 (TTS 语音自动朗读)​

// 发送文字广播通知（后台自动合成语音播报）
const res = await sdk.groupNotify({
  // 接收号码列表
  tels: ["142001", "1000021"],
  // 文本内容
  files: "紧急调度通知：请全体参会人员迅速就位，各组长汇报当前准备情况！",
  // 类型声明为文字
  type: "text",
  // 播报次数：1 (单次), 3 (三次), 0 (循环)
  times: 1
});

console.log("文字通知下发成功:", res);

模式二：语音录音文件播报​

// 发送音频文件广播通知
const res = await sdk.groupNotify({
  tels: ["142001"],
  // 服务器音频录音文件名
  files: "emergency_alarm.wav",
  // 类型声明为音频
  type: "voice",
  times: 3
});

console.log("语音文件通知下发成功:", res);

入参字段详细说明​

参数名字段类型是否必填默认值说明
telsstring[] 或 string是-接收人号码列表（如 ["142001", "1000021"]）
filesstring是-播报内容：TTS 模式下为文本字符串；音频模式下为文件名
typestring是"text"类型："text"（文字转语音）或 "voice"（录音播报）
timesnumber否1循环播放次数：1 (单次), 3 (多次), 0 (无限循环)
notifyIdstring否自动生成通知流水号，格式为 ${operatorId}_${时间戳}

回参说明 (Response Demo)​

{
  "code": 0,
  "message": "success",
  "notifyId": "142009_1787812000"
}