語音羣呼任務創建

POST

https://api.laaffic.com/v3/voice/group/call/send

語音羣呼任務創建。

請求參數

參數	説明	是否必填	類型
appId	應用id	是	String
displayNum	顯示號碼0-20比特數位，允許為空	否	String
taskName	任務名長度2-64，不可重複	是	String
numberList	被叫號碼，最大20w個手機號，多個手機號以逗號隔開，每個手機號為：國碼+手機號組成的7-15比特數位。	是	List<String>
source	檔案來源（1-已上傳文件，2-重新上傳語音檔案，3-文字轉語音）	是	Integer
voiceFileId	語音檔案ID	當source=1時必填	String
uploadName	上傳文件名稱，長度5-32字元	當source=2時必填	String
baseFile	base64檔案流	當source=2時必填	String
text	檔案內容：tts文字最大1000	當source=3時必填	String
lan	轉換語言source等於3必填。語言程式碼 [ 越南語：VN，英語：EN，日語：JP，阿拉伯語：ARB，德國：DE，印地語：IN，義大利：IT，韓國：KR，俄羅斯：RU，西班牙：ES，葡萄牙：PT，印尼語：IDN，孟加拉：BD 泰語：TH ]	當source=3時必填	String
sendTime	定時呼叫時間（立即呼叫則傳null）	否	LocalDateTime
loopCount	迴圈播報次數：默認1次最大9次	是	Integer
maxCalls	最長通話時長，接通後n秒強制掛斷最大999秒	否	Integer
hangUpSms	觸發掛機簡訊0-否，1-是	否	Integer
smsAppId	簡訊應用主鍵	當hangUpSms=1時必填	String
smsContent	短信內容最大1000字元	當hangUpSms=1時必填	String
senderId	發送者ID最大32字元	否	String
feedbackPush	按鍵迴響推送簡訊：0-否，1-是	hangUpSms=1，（feedbackPush，successPush，failedPush，ringPush）必填有一個傳值為1	Integer
feedbackValue	按鍵迴響值：0-9	當feedbackPush=1時必填	String
successPush	通話成功推送送簡訊：0-否，1-是	hangUpSms=1，（feedbackPush，successPush，failedPush，ringPush）必填有一個傳值為1	Integer
successPushTime	通話成功後多少秒推送簡訊最少0s最大9999	當successPush=1時必填	Integer
failedPush	通話失敗推送送簡訊：0-否，1-是	hangUpSms=1，（feedbackPush，successPush，failedPush，ringPush）必填有一個傳值為1	Integer
ringPush	響鈴成功推送送簡訊：0-否，1-是	hangUpSms=1，（feedbackPush，successPush，failedPush，ringPush）必填有一個傳值為1	Integer
toSeat	是否轉坐席：0-否，1-是	否	Integer
sipGroupId	坐席組id	當toSeat=1時必填	Integer
outboundControl	外呼控制器，1-比例式外呼	當toSeat=1時必填	Integer
calloutRate	外呼倍率，最多1-100	當toSeat=1時必填	Integer
toSeatType	轉坐席條件，1群呼結束後轉接，2根據按鍵迴響轉接	當toSeat=1時必填	Integer
toSeatKey	轉接按鍵	當toSeat=1並且toSeatType=2時必填	Integer
allowSendTime	可發送時間段最多添加3個	否	List
strTime	開始時間HH:SS	否	String
endTime	結束時間HH:SS	否	String

請求示例

Request URL:
    https://api.laaffic.com/v3/voice/group/call/send
Request Method:
    POST
Request Headers:
    Content-Type: application/json;charset=UTF-8
    Sign: 05d7a50893e22a5c4bb3216ae3396c7c
    Timestamp: 1630468800
    Api-Key: bDqJFiq9
Request Body:
{
    "appId": "iaAJ6COV",
    "taskName": "2024-06-03 10:42:0511",
    "source": 3,
    "loopCount": 1,
    "maxCalls": 40,
    "hangUpSms": 1,
    "toSeat": 1,
    "sipGroupId": 1000019,
    "outboundControl": 1,
    "calloutRate": 1,
    "toSeatKey": 0,
    "toSeatType": 2,
    "numberList":["8613242926514"],
    "sendTime": "2024-06-21 00:00:00",
    "text": "Mã xác nhận của bạn là 22294",
    "smsAppId": "9obbP7Nl",
    "senderId": "123",
    "smsContent": "123",
    "feedbackValue": 0,
    "successPushTime": 10,
    "feedbackPush": 0,
    "successPush": 0,
    "failedPush": 0,
    "ringPush": 1,
    "lan": "VN",
    "displayNum": "1008122211",
    "allowSendTime": [
        {
            "strTime": "18:28",
            "endTime": "19:28"
        }
    ]
}

響應參數

參數	説明	類型
code	狀態碼，0成功，其他失敗參見接口響應碼。	String
msg	失敗原因說明	String
data	該方法返回keyId	Integer

響應示例

{
    "code":"0",
    "msg":"success",
    "data":123123
}

響應狀態碼

狀態碼	説明
0	成功
-1	帳號認證異常
-2	ip限制
-10	餘額不足
-16	時間戳過期
-18	系統異常
-20	數據已存在
-21	數據校驗異常
-22	參數異常
-23	數據上限
-24	數據不存在
-26	獲取費率失敗
-35	沒有被叫號碼
-37	您提交的群呼任務超過最大併發任務限制，請完成任務後再提交！
-38	轉換文字和語言類型必填
-39	獲取文字語言類型失敗
-41	任務名稱已經存在
-46	長文字轉語音每天最大5次，您已使用完，請聯系商務處理
-53	掛機簡訊觸發條件必須有一個