全部产品
阿里云办公

新增号码

更新时间:2018-07-13 18:50:14

(AddPhoneNumber)

描述

新增号码,将从云呼控制台购买的电话号码绑定到呼叫中心实例中,并且可以和IVR流程进行绑定。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,AddPhoneNumber
InstanceId String 待添加电话号码的呼叫中心实例ID。
PhoneNumber String 待添加电话号码。
Usage String 该电话号码的用途,呼入,呼出,已经同时用于呼入和呼出。 Inbound, Outboung, Bidirection
ContactFlowId String 和电话号码绑定的联系流ID。

返回参数

名称 类型 是否必须 描述
PhoneNumber PhoneNumber 新添加的电话号码的信息。
      PhoneNumberId String 电话号码ID,系统自动生成的唯一标示符。
      InstanceId String 电话啊号码所归属的呼叫中心实例ID。
      Number String 电话号码。
      PhoneNumberDescription String 电话号码的简单描述。
      TestOnly Boolean 是否是测试号码。
      RemainingTime int 测试号码剩余的通话时间。单位为分钟。
      AllowOutbound Boolean 是否允许外呼,结果取决于1)大于的设置,比如400号码不允许外呼 2)呼叫中心实例的设置。电话号码一般都允许内呼,如果不允许内呼,可以1)由大于做设置,用户拨打该号码时听到提示音 2)该号码不绑定联系流IVR,但是ACC不建议这么做。
      Usage String 电话号码的用途,呼入,呼出,已经同时用于呼入和呼出。 Inbound, Outbound, Bidirection。上述值由枚举类型PhoneNumberType定义。该值的结果取决于1)大于的设置,比如400号码不允许外呼 2)呼叫中心实例的设置。电话号码一般都允许内呼,如果不允许内呼,可以1)由大于做设置,用户拨打该号码时听到提示音 2)该号码不连接人和联系流IVR,但是ACC不建议这么做。
      Trunks int 电话号码的中继数量,即可同时支持几路通话,数据来源于大于。
      ContactFlow ContactFlow 电话号码所连接的联系流IVR。
            ContactFlowId String 联系流唯一ID,系统自动生成的唯一标示符。
            InstanceId String 联系流所归属的呼叫中心实例。
            ContactFlowName String 联系流名称,在一个实例内名称不能重复。
            ContactFlowDescription String 联系流的简单描述。
            Type String 流程类型, 定义来自于ContactFlowType。

请求示例

  1. https://ccc.cn-shanghai.aliyuncs.com/?
  2. &Action=AddPhoneNumber
  3. &InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
  4. &PhoneNumber=053168962496
  5. &Usage=Bidirection
  6. &ContactFlowId=dDMD_0mif4hv
  7. &<公共请求参数>

返回示例

  1. {
  2. "HttpStatusCode":200,
  3. "RequestId":"BC976D32-AC4C-4E0F-8AA9-F4BC6C4E2B3E",
  4. "PhoneNumber":{
  5. "PhoneNumberId":"9191956d-3464-402b-8017-ea8df5d831fc",
  6. "Trunks":1,
  7. "Number":"053168962496",
  8. "AllowOutbound":true,
  9. "ContactFlow":{
  10. "ContactFlowName":"Welcome",
  11. "ContactFlowDescription":"Welcome",
  12. "ContactFlowId":"2957",
  13. "Type":"0",
  14. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d"
  15. },
  16. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  17. "PhoneNumberDescription":"Ali Telecom",
  18. "TestOnly":false,
  19. "RemainingTime":0,
  20. "Usage":"Bidirection"
  21. },
  22. "Success":true,
  23. "Code":"OK"
  24. }

错误码

错误代码 描述 Http状态码 语义
NotExist.Instance “Call center instance ‘%s’ does not exist” 404 呼叫中心实例不存在,请确认实例ID是否正确,或者实例是否已被删除。
LimitExceeded.PhoneNumber “The number of phone number exceeds the limit (%s)” 405 电话号码数量超出上限。无法继续添加。
InUse.PhoneNumber “Phone number ‘%s’ is in use” 409 电话号码正在被使用,请确认号码不再处于使用状态后,再进行操作。
NotExist.ContactFlow “Contact flow ‘%s’ of instance ‘%s’ does not exist” 409 联系流不存在,请确认ContactFlowId是否正确。
TenantService “Call center kernel service issue, instance: %s, operation: %s, reason: %s(%d)” 500 呼叫中心核心服务异常,请通过工单进行问题反馈。
DatabaseService “Database service issue, table: %s, operation: %s, reason: %s” 500 数据库操作异常,请通过工单进行问题反馈。