文档首页/云客服/用户接入——网页客户端接入（RESTful）/创建匿名通话/POST /ccmessaging/v1/mobileagent/createcall
更新时间：2024-03-05 GMT+08:00
查看PDF
分享

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" } }

父主题：创建匿名通话