调用CreateCampaign在指定实例下创建预测式外呼活动。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 实例ID。 | ccc-test |
CaseList | array | 否 | 预测式外呼名单列表,不能与CaseFileKey(从文件导入)同时使用,文件导入和列表导入只能选择一种。 | |
object | 否 | 预测式外呼名单。 | ||
ReferenceId | string | 否 | 业务ID,客户业务系统标识,用于集成场景。 | 01 |
PhoneNumber | string | 否 | 联系人电话号码。 | 1888888888 |
CustomVariables | string | 否 | 客户自定义变量,格式为JSON对象,对象最多包含10个属性,每个属性的名称和值均由客户自定义。 | {"name":"customer","客户标签":"tag"} |
QueueId | string | 是 | 预测式外呼活动关联的技能组ID。 | skillgroup@ccc-test |
Name | string | 是 | 预测式外呼活动名称。 | test-campaign |
CaseFileKey | string | 否 | 预测式外呼名单文件,是一个OSS对象的Key,通过GetCaseFileUploadUrl接口获取。 | ccc-test/namelist.csv |
ContactFlowId | string | 是 | 预测式外呼活动关联的联系流ID。 | c1f2bc75-422e-43c7-9c9d9d95633a |
StartTime | string | 是 | 预测式外呼活动开始时间,格式为Unix时间戳,单位毫秒。 | 1634140800000 |
EndTime | string | 是 | 预测式外呼活动结束时间,格式为Unix时间戳,单位毫秒。 | 1634313600000 |
CallableTime | string | 是 | 预测式外呼活动的可外呼时段,格式为JSON对象,对象包含两个属性,beginTime和EndTime,例如:[{"beginTime":"00:00:00","endTime":"23:00:00" }]。 | [{"beginTime":"00:00:00","endTime":"23:00:00" }] |
StrategyType | string | 是 | 预测式外呼活动的策略模式。 枚举值:
| PACING |
StrategyParameters | string | 是 | 预测式外呼活动的策略参数,PID策略下的格式参数示例:{"abandonRate":"5","historicalConnectedRate":"35"},PACING策略下的格式参数示例:{"ratio":1}。abandonRate表示期望呼损率,historicalConnectedRate表示历史参考接通率,ratio表示固定外呼比例。 | {"ratio":1} |
MaxAttemptCount | long | 是 | 预测式外呼活动的最大尝试次数,表示当活动的号码呼叫失败时,最多重呼几次。 | 1 |
MinAttemptInterval | long | 是 | 预测式外呼活动的最小重呼间隔,表示失败重呼时的最小间隔,单位秒。 | 1 |
Simulation | boolean | 否 | 是否是模拟活动,用于测试,普通客户无需关心。 | 无 |
SimulationParameters | string | 否 | 模拟参数,用于测试,普通客户无需关心。 | 无 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "7CC6523B-0E51-1B62-8DA5-6A9831CAE315",
"Data": "c58b9719-3bc3-441d-a4d3-fc0309ef7066",
"Code": "OK",
"Message": "无",
"HttpStatusCode": 200
}
错误码
访问错误中心查看更多错误码。