使用虛擬號碼給多個被叫號碼創建文本轉語音任務、語音通知任務和語音驗證碼任務。
接口說明
-
此接口僅支持使用虛擬號碼給多個被叫號碼創建通話任務。
-
SingleCallByVoice 或 SingleCallByTts 接口支持使用真實號碼或虛擬號碼給單個被叫號碼發送語音通知或語音驗證碼，如果需要批量發送，可以多次調用。
-
通話任務創建完成后，請使用 ExecuteCallTask 接口執行通話任務。您也可以在語音服務控制臺任務中心頁面執行通話任務。
-
使用此接口創建一次通話任務，最多支持創建 1000 條語音通知任務。
QPS 限制
單用戶調用頻率：100 次/秒。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| dyvms:CreateCallTask | create |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| TaskName | string | 否 | 通話的任務名稱。 | 語音通知 |
| BizType | string | 否 | 語音模板類型。取值：
| VMS_VOICE_CODE |
| TemplateCode | string | 否 | TTS_2122**** | |
| TemplateName | string | 否 | 語音通知模板 | |
| ResourceType | string | 否 | 主叫號碼類型。固定取值：LIST。 | LIST |
| Resource | string | 否 | 主叫號碼。目前僅支持虛擬號碼。 您可以在語音服務控制臺虛擬號管理頁面獲取虛擬號碼。 | 05516214**** |
| DataType | string | 否 | 被叫號碼類型。取值：
| JSON |
| Data | string | 否 | 被叫號碼。
| { "paramNames":["name1","name2","key3"], "calleeList":[ { "callee":"1310000****", "params":["zangsan","zhangsan01","zhangsan02"] }, { "callee":"1310000****", "params":["zangsan","zhangsan01","zhangsan02"] } ] } |
| FireTime | string | 否 | 參數暫不可用。 | 1 |
| StopTime | string | 否 | 參數暫不可用。 | 1 |
| ScheduleType | string | 否 | 參數暫不可用。 | 1 |
返回參數
示例
正常返回示例
JSON格式
{
"Code": "OK",
"Data": 0,
"RequestId": "ED815433-724A-4357-9991-A54AD2FF09FD"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParameters | The parameter is invalid. | 無效參數 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史