批量發(fā)起智能語音機器人外呼任務(wù)，一次任務(wù)支持設(shè)置1~100個號碼。
接口說明
-
智能語音機器人功能升級，老功能將于 2023.12.31 停止服務(wù)，新功能請登錄智能聯(lián)絡(luò)中心控制臺，在智能外呼機器人頁面開通使用。老客戶（語音服務(wù)已開通該功能的客戶）目前可繼續(xù)使用該功能，為避免給您帶來業(yè)務(wù)損失，請在 2023.12.31 前完成業(yè)務(wù)遷移。
-
在智能語音交互通話中，支持使用控制臺預(yù)設(shè)的機器人話術(shù)，或在每輪通話中通過回調(diào)接口返回業(yè)務(wù)方設(shè)置的回應(yīng)方式。
-
此接口用于直接使用控制臺預(yù)設(shè)的機器人話術(shù)，發(fā)起機器人外呼任務(wù)。
前提條件
- 已實名認證為企業(yè)用戶，并審核通過了企業(yè)資質(zhì)。
- 已在語音服務(wù)控制臺上購買了號碼。
- 已在話術(shù)管理頁面添加了話術(shù)并通過審核。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| dyvms:BatchRobotSmartCall | none |
|
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| CalledShowNumber | string | 是 | 被叫顯號，必須是已購買的號碼。您可以在語音服務(wù)控制臺查看已購買的號碼。 支持設(shè)置 1~100 個被叫顯號，號碼之間使用英文逗號（,）分隔。 | 136****0000,138****0000 |
| CorpName | string | 否 | 公司名稱，必須和資質(zhì)管理頁面中的公司名稱完全一致。 說明
如果開通了自有線路功能，即 isSelfLine 為 true 時，該參數(shù)為可選。反之則必須填寫公司名稱。
| 阿里巴巴通信技術(shù)（北京）有限公司 |
| CalledNumber | string | 是 | 被叫號碼。僅支持中國大陸號碼。 支持設(shè)置 1~1000 個被叫號碼，號碼之間使用英文逗號（,）分隔。 | 1390000**** |
| DialogId | string | 是 | 指定機器人 ID，即話術(shù) ID。表示選擇哪個機器人/話術(shù)發(fā)起呼叫。 請在話術(shù)管理頁面中查看話術(shù) ID。 | 100002970**** |
| EarlyMediaAsr | boolean | 否 | 早媒體語音識別標識。默認為 false，即不啟用。 如果需要啟用早媒體語音識別標識，請設(shè)置為 true。 | true |
| TaskName | string | 是 | 任務(wù)名稱。
| 批量外呼任務(wù) |
| ScheduleTime | long | 否 | 預(yù)設(shè)的呼叫時間。Unix 時間戳格式，單位為毫秒。 說明
當參數(shù) ScheduleCall 為 true 時必選。
| 12 |
| ScheduleCall | boolean | 否 | 是否定時呼叫。如果設(shè)置為 true，則必須設(shè)置 ScheduleTime。 | true |
| TtsParam | string | 否 | TTS 模板的變量值，格式為 JSON。 必須和具體的號碼對應(yīng)，TtsParam 與 TtsParamHead 變量名稱一一對應(yīng)。 | [{"number":"1390000****","params":[“小王”,"小李","小周"]}] |
| TtsParamHead | string | 否 | 帶變量的呼叫任務(wù)，格式為 JSON。 變量名稱列表，與 TtsParam 配合使用。 | ["name1","name2","name3"] |
| IsSelfLine | boolean | 否 | 是否調(diào)用自有線路，默認為 false，即不調(diào)用。 | true |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"Code": "OK",
"Message": "OK",
"RequestId": "D9CB3933-9FE3-4870-BA8E-2BEE91B69D23",
"TaskId": "4001112222"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-06-26 | API 內(nèi)部配置變更，不影響調(diào)用 | 查看變更詳情 |