快速入门-TTS方式
IVR群呼
文本转语音，通过指定语言和指定语言文本发送TTS语音消息，适用OTP、营销场景。
TTS对接流程
前期准备
获取API Key、API Secret和appld的值。
需登陆客户端获取, 具体位图如下图所示：
Sign签名规则
使用API Key + API Secret + Timestamp当前系统时间戳（秒），生成MD5-32位字符串(不区分大小写)作为签名。
示例：
API Key：bDqJFiq9
API Secret：7bz1lzh9
Timestamp当前系统时间戳（秒）：1630468800
MD5(bDqJFiq97bz1lzh91630468800)：05d7a50893e22a5c4bb3216ae3396c7c
API对接流程
01TTS群呼
详情可参考 TTS群呼对接文档。
| 功能 | 参数 | 参数值 |
|---|---|---|
| 选择不同音色，使语音更有亲和力 | accent | 口音，可配置语种口音，如英语[美国口音]、英语[印度口音] 等，口音详细内容请查询表格 |
| 配合合理的语速更清晰，推荐1倍速 | speakingRate | 语速：0.25 - 4倍 |
| 文本转语音，可在文本中插入变量，例如用户名 | recallCount | 重呼次数，0-10数字 |
发送语音OTP示例（仅作说明参考；实际调用时请删除所有//开头的注释内容，确保 JSON 格式正确）
curl --location 'https://api.laaffic.com/v3/voice/sendCode'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: 02b484c9209a738162cdcd958e30c31c'
--header 'Timestamp: 1761550833'
--header 'Api-Key: cLMnWQhR'
--data '{
"callee":"912111111111", //被叫号码
"language":"EN", //语言
"text":"your otp is 1 2 6 4", //otp内容
"appId":"cER2Ev2w", //语音应用ID
"loopCount":2 //循环播放次数，推荐3
}'发送语音营销示例（仅作说明参考；实际调用时请删除所有//开头的注释内容，确保 JSON 格式正确）
curl --location 'https://api.laaffic.com/v3/voice/sendCode'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: 2bb28c85f3990e2b8a657ee11089766d'
--header 'Timestamp: 1765966432'
--header 'Api-Key: Lh7vkyKSv0kTb5KvSPNdF7M67QZMvt2o'
--header 'Cookie: JSESSIONID=491C9A87E7854840E5DB4ECF6815D666'
--data '{
"callee": "918111111111",//被叫号码
"language":"EN", //文本语言
"text":"hello,Your AAV limit has been updated! Enjoy a daily interest rate as low as 0.4%! Borrow 10,000 Naira and repay as little as 10,900 Naira in one month. Log in to your AAV app NOW to check your limited-time offer!",
"appId":"sER2Ev2w", //语音应用
"maxDuration":50, //最长通话时长,接通后50秒强制挂断
"loopCount":2, //循环播放2次
"recallCount":3, //失败重呼，最多重呼3次
"recallInterval":20 //间隔20min重呼
}'02状态报告推送
当用户在账户设置-语音应用管理页面，配置了http推送地址后，平台会将http-api接入的语音，状态报告主动推送给用户配置地址。可登录客户端设置，具体位置如图所示
当用户在账户管理-语音应用管理页面，配置了cc-http推送地址后，平台会将呼叫中心生成的通话记录，主动推送给用户配置地址。 我方推送失败后，会隔30分钟再次进行推送，最多推送3次
状态报告推送
常见错误码速查
以下是几个常见错误码原因和处理方式，全局可看 全局状态码
| Status | Reason | Description |
|---|---|---|
| -1 | Authentication error | 检查API Key、API Secret和appId的参数值 |
| -18 | Port program unusual | 检查请求格式，请求body是否是json格式 |
此页面的内容有帮助吗？
对接有疑问？联络我们的技术支援
LAAFFIC API 专属 TG 技术对接频道，即时回应您的需求
