更新时间:2024-03-05 GMT+08:00

POST /ccmessaging/v1/mobileagent/createcall

描述

业务员通过登录APP调用chat提供的createcall接口创建匿名外呼任务,后续通过集成sdk发起匿名呼叫。

接口方法

POST

接口URI

https://域名/apiaccess/ccmessaging/v1/mobileagent/createcall,例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

X-APP-Key

string

True

appKey字段,用户标识,请联系运营人员获取appKey

2

Authorization

string

True

鉴权字段,内容格式为:Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1.1

called

string(32)

True

被叫号码

1.2

callData

string(1,024)

False

呼叫数据

1.3

callerPresent

string(32)

True

用户侧主叫显示号码,用户看到的主叫号码,不携带的情况下,采用平台默认的主叫号码

响应说明

  • 响应状态码: 200
表3 响应体参数

序号

名称

参数类型

是否必选

说明

1.1

resultCode

string

True

接口返回码。

0:成功,其他为失败

30010000001:没有开通此特性,无法使用

30010000002:没有查到SIP Server 信息

30010000003:入参校验失败

30010010001:添加外呼任务失败

30010010002:VDN不可用

30010010003:VDN配置异常,Record Path生成失败

30010019999:CCM其他异常

30011010001:创建呼叫失败,未等到呼叫建立成功事件

30011019999:CCUCS其他异常

30010009999:Chat模块异常

1.2

resultDesc

string

False

失败原因描述

1.3

resultData

object

False

响应消息结构体

1.3.1

callSerialNo

string(50)

False

呼叫序列号,唯一标示一次外呼

1.3.2

sipServiceAddress

string

True

sip服务地址,ip:port

1.3.3

accesscode

string

True

用于VOIP匿名呼叫,接入码+uvid

  • 响应状态码: 400

    错误的请求:请检查请求路径及参数。

  • 响应状态码: 401

    未授权:1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。

  • 响应状态码: 404

    请求的内容未找到:请检查请求的路径。

  • 响应状态码: 500

    业务失败:请依次确认您请求中各参数的取值。

错误码

无。

报文样例

  • 场景描述:调用chat接口创建外呼任务

    URL:调用chat接口创建外呼任务

    请求头:

    { "X-APP-Key": "***********************", "Authorization": "Bearer ***********************", "Content-Type": "application/json" }

    请求参数:

    { "called":"88884432", "callData":"1", "callerPresent":"95599" }

    响应头:

    connection →keep-alive content-encoding →gzip content-length →130 content-type →application/json;charset=UTF-8 date →Wed, 12 May 2021 08:52:40 GMT server →openresty

    响应参数:

    { "resultCode": "0", "resultDesc": "Success", "resultData": { "sipServiceAddress": "10.137.203.215:5063", "accesscode": "179080024609291" } }