首页 > API中心 > IVR群呼 > 文档指引

 
 

TTS群呼

POST
https://api.laaffic.com/v3/voice/sendCode
通过指定语言和指定语言文本发送TTS语音消息。当设置重呼次数大于0后,将会开启呼叫失败重呼功能,当【recallPush重呼话单推送方式】入参为0时,则报告推送时仅推送最后一次呼叫结果。
 
请求参数
callee
String
必填
被叫号码,国码+手机号组成的7-18位数字。
displayNum
String
显示号码,1-20位数字,允许为空
speakingRate
Double
文本转语音,语速:0.25 - 4倍
timbreCode
String
必填
文本转语音,音色编码
emotionStyleCode
String
必填
文本转语音,情感风格编码(FRIENDLY-亲切友好,CONVERSATIONAL-正常对话,CALM-平静严肃,ANGRY-愤怒),仅部分音色支持。
ttsBgmType
String
必填
文本转语音,背景音类型编码(office-办公室环境音,telemarketing-电销环境音)
ttsBgmVolume
String
文本转语音,背景音音量,范围0.0~1.0,默认1.0。需配合 ttsBgmType 使用。
text
String
必填
文本内容,长度2048。
appId
String
必填
语音应用id
loopCount
Int
循环播报次数,1-9数字,默认为1,允许为空。
calledInfo
String
被叫信息,0-1000位字符
recallCount
Int
重呼次数,0-10数字,允许字段为空,不填默认0,等于0时不开启重呼功能
recallInterval
Int
重呼间隔,1-1440数字,单位分钟。只在重呼次数大于0时字段才生效,允许字段为空,当字段为空时默认为5
maxDuration
Int
最长通话时长,接通后N秒强制挂断,1-999数字,允许为空。
maxRingingTime
Int
最大响铃时长,默认60,可输入20-120秒。
delayPlay
Int
延迟播放,默认0,可输入0-999秒。
delayHangup
Int
延迟挂断,默认0,可输入0-999秒。
dimensionId
Int
统计维度ID,具体数值需联系商务获取
recallPush
Int
重呼话单推送方式:默认0(重呼仅推送最后一次呼叫结果),1(重呼的每次呼叫结果均推送】)
 
请求示例
Request URL:
    https://api.laaffic.com/v3/voice/sendCode
Request Method:
    POST
Request Headers:
    Content-Type: application/json;charset=UTF-8
    Sign: 05d7a50893e22a5c4bb3216ae3396c7c
    Timestamp: 1630468800
    Api-Key: bDqJFiq9
Request Body:
{
    "callee":"932111111111",
    "displayNum":"1008122211",
    "text":"hello world",
    "timbreCode": "b7b181d01542479d8ace3637ab7cb35d",
    "emotionStyleCode": "CONVERSATIONAL",
    "speakingRate": 1.0,
    "ttsBgmType": "office",
    "ttsBgmVolume": 1.0,
    "appId":"4luaKsL2",
    "loopCount":2,
    "recallCount":0,
    "recallInterval":0,
    "maxDuration":120,
    "maxRingingTime":60
}
 
响应参数
参数 说明 类型
status 状态码,0成功,其他失败参见响应状态码说明 String
reason 失败原因说明 String
data 记录唯一id String
 
响应状态码
status 状态说明
0 成功
-1 账号认证异常
-2 ip限制
-10 余额不足
-16 时间戳过期
-18 系统异常
-22 参数异常
-26 获取费率失败
 
语种、口音和音色关系表
语种 口音 音色
阿拉伯语(AR) - 男声:1;女声:2
巴斯克语(BAS) 西班牙(34) 男声:-;女声:2
加泰罗尼亚语(CA) 男声:-;女声:2
加利西亚语(GL) 男声:-;女声:2
孟加拉语(BN) 印度(91) 男声:1;女声:2
古吉拉特语(GU) 男声:1;女声:2
印地语(HI) 男声:1;女声:2
卡纳达语(KN) 男声:1;女声:2
马拉雅拉姆语(ML) 男声:1;女声:2
马拉地语(MR) 男声:1;女声:2
旁遮普语(PA) 男声:1;女声:2
乌尔都语(UR) 男声:1;女声:2
泰米尔语(TA) 男声:1;女声:2
保加利亚语(BG) 保加利亚(359) 男声:-;女声:2
捷克语(CS) 捷克(420) 男声:-;女声:2
丹麦语(DA) 丹麦(45) 男声:1;女声:2
荷兰语(NL) 荷兰(31)【默认口音】 男声:1;女声:2
比利时(32) 男声:1;女声:2
英语(EN) 印度(91) 男声:1;女声:2
美国(1)【默认口音】 男声:1;女声:2
英国(44) 男声:1;女声:2
澳大利亚(61) 男声:1;女声:2
菲律宾语(TL) 菲律宾(63) 男声:1;女声:2
芬兰语(FI) 芬兰(358) 男声:-;女声:2
法语(FR) 法国(33)【默认口音】 男声:1;女声:2
加拿大(1) 男声:1;女声:2
德语(DE) 德国(49) 男声:1;女声:2
希腊语(EL) 希腊(30) 男声:-;女声:2
希伯来语(HE) 以色列(972) 男声:1;女声:2
匈牙利语(HU) 匈牙利(36) 男声:-;女声:2
冰岛语(IS) 冰岛(354) 男声:-;女声:2
印度尼西亚语(ID) 印度尼西亚(62) 男声:1;女声:2
意大利语(IT) 意大利(39) 男声:1;女声:2
日语(JA) 日本(81) 男声:1;女声:2
韩语(KO) 韩国(82) 男声:1;女声:2
拉脱维亚语(LV) 拉脱维亚(371) 男声:1;女声:-
立陶宛语(LT) 立陶宛(370) 男声:1;女声:-
马来语(MS) 马来西亚(60) 男声:1;女声:2
挪威语(NO) 挪威(47) 男声:1;女声:2
波兰语(PL) 波兰(48) 男声:1;女声:2
葡萄牙语(PT) 巴西(55) 男声:1;女声:2
葡萄牙(351)【默认口音】 男声:1;女声:2
罗马尼亚语(RO) 罗马尼亚(40) 男声:-;女声:2
俄语(RU) 俄罗斯(7) 男声:1;女声:2
塞尔维亚语(RS) 塞尔维亚(381) 男声:-;女声:2
斯洛伐克语(SK) 斯洛伐克(421) 男声:-;女声:2
西班牙语(ES) 西班牙(34)【默认口音】 男声:1;女声:2
美国(1) 男声:1;女声:2
瑞典语(SV) 瑞典(46) 男声:1;女声:2
泰语(TH) 泰国(66) 男声:-;女声:2
土耳其语(TR) 土耳其(90) 男声:1;女声:2
越南语(VI) 越南(84) 男声:1;女声:2
南非荷兰语(AF) 南非(27) 男声:-;女声:2

此页面的内容有帮助吗?

对接有疑问?联络我们的技术支援

LAAFFIC API 专属 TG 技术对接频道,即时回应您的需求

前往Telegram联系
 

LANGUAGE

Java

PHP

REQUEST

import cn.hutool.core.codec.Base64;
import cn.hutool.crypto.SecureUtil;
import cn.hutool.http.Header;
import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONObject;
import cn.hutool.json.JSONUtil;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.time.LocalDateTime;
import java.time.ZoneId;

public void sendCode() {
    final String baseUrl = "https://api.laaffic.com/v3/voice";
    final String apiKey = "your api key";
    final String apiPwd = "your api secret";
    final String appId = "{{appId}}";
    final String callee = "{{callee}}";
    final String displayNum = "{{displayNum}}";
    final double speakingRate = "{{speakingRate}}";
    final String text = "{{text}}";
    final Integer loopCount = "{{loopCount}}";
    final String calledInfo = "{{calledInfo}}";
    final Integer recallCount = "{{recallCount}}";
    final Integer recallInterval = "{{recallInterval}}";
    final Integer maxDuration = "{{maxDuration}}";
    final Integer maxRingingTime = "{{maxRingingTime}}";
    final Integer delayPlay = "{{delayPlay}}";
    final Integer delayHangup = "{{delayHangup}}";
    final Integer dimensionId = "{{dimensionId}}";
    final Integer recallPush = "{{recallPush}}";
    final String timbreCode = "{{timbreCode}}";
    final String emotionStyleCode = "{{emotionStyleCode}}";
    final String ttsBgmType = "{{ttsBgmType}}";
    final double ttsBgmVolume = "{{ttsBgmVolume}}";

    final String url = baseUrl.concat("/sendCode");
    HttpRequest request = HttpRequest.post(url);

    // generate md5 key
    final String datetime = String.valueOf(LocalDateTime.now().atZone(ZoneId.systemDefault()).toInstant().getEpochSecond());
    final String sign = SecureUtil.md5(apiKey.concat(apiPwd).concat(datetime));

    request.header(Header.CONTENT_TYPE, "application/json;charset=UTF-8")
            .header("Sign", sign)
            .header("Timestamp", datetime)
            .header("Api-Key", apiKey);

    final String body = JSONUtil.createObj()
            .set("callee", callee)
            .set("displayNum", displayNum)
            .set("speakingRate", speakingRate)
            .set("text", text)
            .set("appId", appId)
            .set("loopCount", loopCount)
            .set("calledInfo", calledInfo)
            .set("recallCount", recallCount)
            .set("recallInterval", recallInterval)
            .set("maxDuration", maxDuration)
            .set("maxRingingTime", maxRingingTime)
            .set("delayPlay", delayPlay)
            .set("delayHangup", delayHangup)
            .set("dimensionId", dimensionId)
            .set("recallPush", recallPush)
            .set("timbreCode", timbreCode)
            .set("emotionStyleCode", emotionStyleCode)
            .set("ttsBgmType", ttsBgmType)
            .set("ttsBgmVolume", ttsBgmVolume)
            .toString();

    HttpResponse response = request.body(body).execute();
    if (response.isOk()) {
        String result = response.body();
        System.out.println(result);
    }
} 

REQUEST

header('content-type:text/html;charset=utf8');

$apiKey = "your api key";
$apiSecret = "your api secret";
$appId = "{{appId}}";
$url = "https://api.laaffic.com/v3/voice/sendCode";
$timeStamp = time();
$sign = md5($apiKey.$apiSecret.$timeStamp);

$dataArr['callee'] = "{{callee}}";
$dataArr['displayNum'] = "{{displayNum}}";
$dataArr['speakingRate'] = "{{speakingRate}}";
$dataArr['appId'] = $appId;
$dataArr['text'] = "{{text}}";
$dataArr['loopCount'] = "{{loopCount}}";
$dataArr['calledInfo'] = "{{calledInfo}}";
$dataArr['recallCount'] = "{{recallCount}}";
$dataArr['recallInterval'] = "{{recallInterval}}";
$dataArr['maxDuration'] = "{{maxDuration}}";
$dataArr['maxRingingTime'] = "{{maxRingingTime}}";
$dataArr['delayPlay'] = "{{delayPlay}}";
$dataArr['delayHangup'] = "{{delayHangup}}";
$dataArr['dimensionId'] = "{{dimensionId}}";
$dataArr['recallPush'] = "{{recallPush}}";
$dataArr['timbreCode'] = "{{timbreCode}}";
$dataArr['emotionStyleCode'] = "{{emotionStyleCode}}";
$dataArr['ttsBgmType'] = "{{ttsBgmType}}";
$dataArr['ttsBgmVolume'] = "{{ttsBgmVolume}}";

$data = json_encode($dataArr);
$headers = array('Content-Type:application/json;charset=UTF-8',"Sign:$sign","Timestamp:$timeStamp","Api-Key:$apiKey");

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,$url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 600);
curl_setopt($ch, CURLOPT_HTTPHEADER,$headers);
curl_setopt($ch, CURLOPT_POSTFIELDS , $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$output = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);

var_dump($output);
 

RESPONSEEXAMPLE

{
    "status": "0",
    "reason": "success",
    "data": "2203031113381000002"
} 

Telegram
WhatsApp
咨询

点击此处开启人工服务