外呼接口

此接口可以供三方平台在自己的系统中实现外呼功能。

访问路径

POST  /openapi/call/api/v1/callout

请求参数

字段名称字段类型是否必填字段描述
agentNumberString坐席工号
customerNumberString被叫号码,固话请输入完整区号。
calloutTypeString外呼方式:PSTN(坐席绑定手机号),SIP(sip话机)、WEBRTC(软电话)。
agentTimeoutString呼叫座席侧超时时间,默认60秒。
customerTimeoutString呼叫客户侧超时时间,默认60秒。
agentDisNumber string指定呼叫座席侧外显号码,优先级最高。
customerDisNumber string指定呼叫客户侧外显号码,此号码应为企业账户外显号码中的已存在的。
numberGroupNamestring号码组名称,传该值,会查找对应名称的号码组,并根据策略选择外显号。未找到号码组按照没传处理
numberGroupIdstring号码组编号,传该值,会查找对应Id的号码组,并根据策略选择外显号。未找到号码组按照没传处理,号码组名称和id同时存在时,优先根据编号查找号码组
extrasjsonString自定义参数,通话中通过事件推送,通话后通话记录中可以查询搜索和定位 限制字节数为255个,并且使用json格式进行传输,超出或者格式不正确则报错。同时可在此参数里传extraNumber分机号,实现分机号自动拨号。

请求示例

{ "agentNumber": "2000", "customerNumber": "1861111111", "calloutType": "PSTN", "agentTimeout": "60", "customerTimeout": "120", "agentDisNumber": "01011111111", "customerDisNumber": "0101111111", "extras": { "extraNumber":"8000", "test": "自定义传参" } }

返回示例

{ "success": true, "message": "200 ok!", "code": "200", "data": null }

外呼接口错误码

错误码错误信息
01030061返回下面提示信息之一:该号码呼叫次数今日已达上限,请勿重复呼叫。该号码呼叫次数本周已达上限,请勿重复呼叫。该号码呼叫次数本月已达上限,请勿重复呼叫。该号码呼叫次数本季度已达上限,请勿重复呼叫。该号码呼叫次数今年已达上限,请勿重复呼叫。
01030080该时间段属于风控阶段,已限制呼叫
01030063由于网络原因,当前坐席已掉线,请刷新后重试
01030064外呼失败
01030065extras格式错误
01030003座席忙
01030019agent_not_find
01030020agent_disable
01030021agent_locked
01030044座席没有绑定手机号,不可手机方式签入
01030045未找到外显号
01030046座席没有绑定sip号,不可SIP话机方式签入
01030047话机掉注册,请重新注册后再试
01030086账户余额不足,请联系管理员
01030059该号码属于黑名单号码,已限制呼叫
01030088线路呼叫限制
01030035current display number is not belong current account
01030089当前外显组未找到空闲号码
01030090座席呼叫锁定中,请稍后重试
2025-07-14