快速入门-任务方式
IVR群呼
用于向批量用户发送重要信息通知，贷款逾期催缴、信用卡还款提醒、理财产品到期通知、活动营销等；
任务对接流程
前期准备
获取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对接流程
01上传语音文件
将语音文件转为base64编码，并调用接口上传语音文件。
curl --location --request POST 'https://api.laaffic.com/v3/voice/fileUpload'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: 621862bfd0a7140dbb8fcbefe333fe9a'
--header 'Timestamp: 1765944162'
--header 'Api-Key: SQLHdsQFe0Gk8ckwJZqcwxfuYRm0Qu0o'
--data-raw '{
"fileName":"11-24.mp3",
"file":"base64编码的文件内容"
}'02创建IVR群呼任务
根据需求，可参考特色功能，调用IVR群呼任务接口进行相关参数传递。
| 功能 | 参数 | 参数值 | 备注 |
|---|---|---|---|
| 转接坐席，人工客服接听 | toSeat | 1 | 需配置相关坐席 |
| 通话成功/失败/按键反馈/响铃成功,触发挂机短信 | hangUpSms | 1 | 需商务配置短信应用 |
| 文本转语音，可在文本中插入变量，例如用户名/号码 | source | 3 | 需配合其他参数使用 |
| 定时呼叫功能 | sendTime | 定时呼叫时间（立即呼叫则传null） | |
| 任务重呼，可选择失败重呼或全部重呼 | recallFlow | 是否重呼，需要重呼时设置，recallFlow为空时则不开启重呼 | 需在请求中配置重呼相关细节 |
curl --location 'https://api.laaffic.com/v3/voice/group/call/send'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: 954169507790e95d2ffe2c19636a9f4b'
--header 'Timestamp: 1761552496'
--header 'Api-Key: Lh7vkyKSv0kTb5KvSPNdF7M67QZMvt2o'
--data '{
"appId":"cER2Ev2w", //语音应用ID
"taskName":"20251024123", //任务名
"source":1,//文件来源（1-已上传文件，2-重新上传语音文件，3-文本转语音）
"voiceFileId":"12025073082f4b0d63ac5400a8320853c67341456.m4a",//语音文件ID
"lan": "EN", //语言
"loopCount":1,//循环播放次数1
"maxCalls":40, //最大响铃时长40s
"hangUpSms":1,//推送挂机短信
"smsAppId":"cF9u6UmT", //短信应用ID
"smsContent": "Attention! Your loan of $1,200 is overdue. Please settle the payment by Aug 15 via NULL.", //短信内容
"feedbackPush":1, //按键反馈推送挂机短信
"feedbackValue":6, //用户按键6推送短信
"successPushTime":10, //通话成功10s后推送短信，
"failedPush":1, //通话失败推送短信
"numberInfoList":[{
"calleeNumber":"9113000000001",//被叫号码
"text1":"https://www.laaffic.com/api/voice/callSend/" //被叫信息（作为变量插入smsContent的NULL中）
}
,{
"calleeNumber":"9113000000002",//被叫号码
"text1":"https://www.laaffic.com/api/voice/callSend/" //被叫信息（作为变量插入smsContent中的NULL.）
}
]
}
'注释：numberInfoList中写入所有被叫号码及被叫信息，calleeNumber代表被叫号码、text1代表被叫信息，可作为变量插入短信内容smsContent中。
03状态报告推送
当用户在账户设置-语音应用管理页面，配置了http推送地址后，平台会将http-api接入的语音，状态报告主动推送给用户配置地址。可登录客户端设置，具体位置如图所示
参考信息
常见错误码速查
以下是几个常见错误码原因和处理方式，全局可看 全局状态码
| Status | Reason | Description |
|---|---|---|
| -1 | Authentication error | 检查API Key、API Secret和appId的参数值 |
| -18 | Port program unusual | 检查请求格式，请求body是否是json格式 |
此页面的内容有帮助吗？
对接有疑问？联络我们的技术支援
LAAFFIC API 专属 TG 技术对接频道，即时回应您的需求
