创建手动外呼任务

服务描述

本接口,可用于创建云呼叫中心手动外呼任务

开发须知

调用本接口前,请先获取appId

服务地址

POST https://{您的专属域名}/speech/openapi/v1/task/outbound/create

请求参数

参数 位置 类型 是否必填 说明
appId header String Y 应用ID
timestamp header String Y 时间戳,毫秒
sign header String Y 签名
Content-Type header String Y application/json
taskName Body String Y 任务名称(不能重复),长度:1至50
taskType Body Integer Y 任务类型(1自动外呼,2手动外呼)
taskExecStartDate Body String Y 任务开始时间(yyyy-MM-dd)
taskExecEndDate Body String Y 任务结束时间(yyyy-MM-dd)
taskDesc Body String N 任务描述
skillSetId Body String Y 技能组id,通过接口呼出技能组获取
taskAgents Body List<AgentOpenDto> Y 坐席分配客户数量
outboundPhoneGroups Body List<PhoneGroupDto> Y 号码批次,目前只支持1个号码组
outBoundCustomers Body List<CustomerDto> Y 外呼名单,单次可添加1000个名单,可追加到2万

AgentOpenDto

参数 位置 类型 是否必填 说明
agentId Body Integer Y 坐席id,通过根据技能组查询坐席获取
assignNum Body Integer Y 分配客户数量

PhoneGroupDto

参数 位置 类型 是否必填 说明
name Body String Y 号码批次-名称
identify Body String Y 号码批次-标识
autoOutboundSwitch Body Integer Y 重呼设置开关(0-关闭;1-开启,默认0)
autoOutboundInterval Body Integer 自动重呼开启:Y 重呼间隔(分钟),范围:5 至 2880
autoOutboundTimes Body Integer 自动重呼开启:Y 重呼次数,范围:1 至 3

CustomerDto

参数 位置 类型 是否必填 说明
name Body String Y 客户名称,长度限制:20,特殊字符将被忽略:
desc Body String N 客户备注,长度限制:200,特殊字符将被忽略:
externalCustomerId Body String Y 外部-客户id,租户方的客户id,长度限制:64,特殊字符将被忽略:
externalData Body String N 透传数据,长度限制:40,特殊字符将被忽略:
phoneGroupVoList Body List<PhoneGroupCustomerDto> Y 客户号码批次信息
PhoneGroupCustomerDto
参数 位置 类型 是否必填 说明
phoneGroupIdentify Body String Y 号码批次 - 标识,必须与“号码批次标识一致”
relations Body List<PhoneRelationDto> Y 关系人,第一个关系人必须为客户本人,支持3个号码
PhoneRelationDto
参数 位置 类型 是否必填 说明
mobile Body String Y 关系人号码
relation Body String N 与客户的关系,如:父亲
请求示例数据:
POST https://abc.xyz/speech/openapi/v1/task/outbound/create
sign: fo1OWX+JnfeonAFSGau2gwP1GvFa+RTw5czoBWoz+k3AjV8scDl6JnvFRDj8Lgt1nQxLlmcOhIBN4j7pEE/NAzYjXUFSGo308f5V9dHBnmGLYsqKmgma4cQZLBqHp9T43IZfRX8Zh2/Hp2HOmfTgos/L8GN6YPA8fQ2d5tbtJZrrkBuwA/LEezjOJxSRRRCrcS1ZFVvTZ+cIjYeO4QdC5r5I67LLY/nLbFAFUdQsCzUIytO09vUCLGlKierNhPfCtMzTgZSE9dWO5zJ3L2uCsXM7Od6mPROVpddVafF+BueKjtbL10PwDc9f1eBpGTpgmbOy8Bbx3NIyCjDvhc9Mag==
appId: 99845aaaaebd4d61acccc9b776208f12
timestamp: 1586314097995

请求Body:

{
    "taskName": "手动外呼名称",
    "taskType": 2,
    "taskExecStartDate": "2020-09-27",
    "taskExecEndDate": "2020-09-27",
    "taskDesc": "手动外呼描述",
    "skillSetId": "1462016331580064",
    "taskAgents": [
        {
            "agentId": 19881338,
            "assignNum": 1
        }
    ],
    "outboundPhoneGroups":[
        {
            "name":"外呼任务号码批次名称,如:本人、亲属、朋友",
            "identify":"default",
            "autoOutboundSwitch": 1,
            "autoOutboundInterval": 5,
            "autoOutboundTimes": 1
        }
    ],
    "outBoundCustomers": [
        {
            "name": "客户名称",
            "desc": "客户描述",
            "externalCustomerId":"1",
            "externalData":"",
            "phoneGroupVoList":[
                {
                    "phoneGroupIdentify":"default",
                    "relations":[
                        {
                            "mobile":"13800000001",
                            "relation":"本人"
                        }
                    ]
                }
            ]
        }
    ]
}

返回结果

参数 类型 说明
code String 结果码
message String 结果描述
data Long 任务id
CommunicateBaseVo
返回结果示例:
{
    "code": "10000",
    "message": "请求成功",
    "data": 123
}
结果码说明
结果码 说明
10000 请求成功
10001 鉴权失败
10002 找不到对应的公钥,请先上传公钥
20001 请求失败
29002 参数错误
29008 系统异常

results matching ""

    No results matching ""