批量發送TTS語音消息（使用模板）
POST
https://api.laaffic.com/v3/voice/sendIvr
通過指定語言和指定語言文本批量發送TTS語音消息。後臺配置模板後，呼叫時僅需要傳遞被叫號碼集合和模板ID進行呼叫。
請求參數
| 參數 | 說明 | 是否必填 | 類型 |
|---|---|---|---|
| appId | 語音應用id | 是 | String |
| recallPush | 重呼話單推送方式：預設0（重呼僅推送最後一次呼叫結果）,1（重呼的每次呼叫結果均推送） | 否 | Int |
| numberList | 號碼集合 | 是 | Array |
| callee | 被叫號碼，國碼+手機號組成的7-18位數字 | 是 | String |
| dimensionId | 模板ID，具體數值需聯繫商務獲取 | 是 | Integer |
| text1 | 1.text1-text10為預設的被叫資訊變量，可在呼叫時動態取代呼叫模板內TTS裡的${Text1}-${Text10}佔位符。 2.被叫資訊變數總計有10個，您不必10個參數全部使用可按需使用，單一被叫資訊變數並無字元長度限制，但您需要保證您使用的所有text變數加起來不超過300字元長度。 3.當您使用text變數後，我方會在【語音狀態報告主動推送】calledInfo欄位推回給您，舉例請求："text1":"Tom"、"text2":"12$"，回執推送格式"calledInfo":"{"text1":"Tom","text2":"12$"}" | 否 | String |
| text2 | 被叫信息變量2 | 否 | String |
| text3 | 被叫信息變量3 | 否 | String |
| text4 | 被叫信息變量4 | 否 | String |
| text5 | 被叫信息變量5 | 否 | String |
| text6 | 被叫信息變量6 | 否 | String |
| text7 | 被叫信息變量7 | 否 | String |
| text8 | 被叫信息變量8 | 否 | String |
| text9 | 被叫信息變量9 | 否 | String |
| text10 | 被叫信息變量10 | 否 | String |
請求示例
Request URL:
https://api.laaffic.com/v3/voice/sendIvr
Request Method:
POST
Request Headers:
Content-Type: application/json;charset=UTF-8
Sign: 05d7a50893e22a5c4bb3216ae3396c7c
Timestamp: 1630468800
Api-Key: bDqJFiq9
Request Body:
{
"appId":"4luaKsL2",
"numberList":[
{
"callee":"8613800000000",
"dimensionId":12,
"text1":"tom",
"text2":"12$"
},
{
"callee":"9113800000001",
"dimensionId":12,
"text1":"Olivia",
"text2":"13$"
}
]
}響應參數
| 參數 | 說明 | 類型 |
|---|---|---|
| status | 狀態碼，0成功，其他失敗參見接口響應碼。 | String |
| reason | 失敗原因說明 | String |
| data | 提交結果集合（順序與提交時順序一致） | JSONArray |
| voiceId | 記錄唯一id | String |
| callee | 被叫號碼 | String |
| terminationCode | 狀態碼0成功 其他失敗 | String |
| terminationReason | 狀態碼描述 | String |
響應示例
{
"status": "0",
"reason": "success",
"data": [
{
"voiceId": "2203031134011000001",
"callee": "8613800000000",
"terminationCode": "0",
"terminationReason": "success"
},
{
"voiceId": "2203031134011000002",
"callee": "9113800000001",
"terminationCode": "101502",
"terminationReason": "Failed to get rates"
}
]
}響應狀態碼
| status | 狀態說明 |
|---|---|
| 0 | 成功 |
| -1 | 帳號認證異常 |
| -2 | ip限制 |
| -10 | 餘額不足 |
| -16 | 時間戳過期 |
| -18 | 系統異常 |
| -22 | 參數異常 |
| -26 | 獲取費率失敗 |
此頁面的內容有幫助嗎？
對接有疑問？聯絡我們的技術支援
LAAFFIC API 專屬 TG 技術對接頻道，即時回應您的需求
