全部产品
云市场

点击拨号

更新时间:2017-11-10 10:41:30

点击拨号接口(clickToDial)

步骤 1 创建阿里云账号

为了访问语音服务,您需要有一个阿里云账号。如果没有,可首先按照如下步骤创建阿里云账号:

1、访问阿里云 官方网站,单击页面上的免费注册按钮。

2、按照屏幕提示完成注册流程并进行企业实名认证语音服务只支持企业实名认证用户使用。为了更好地使用阿里云服务,建议尽快完成实名认证,否则部分阿里云服务将无法使用。具体实名认证流程,请参考 这里

步骤 2 获取阿里云访问密钥

为了使用语音文本单呼API-PHP SDK,您必须申请阿里云的访问密钥。

阿里云访问秘钥是阿里云为用户使用 API(非控制台)来访问其云资源设计的“安全口令”。您可以用它来签名 API 请求内容以通过服务端的安全验证。

该访问秘钥成对(AccessKeyId 与 AccessKeySecret)生成和使用。每个阿里云用户可以创建多对访问秘钥,且可随时启用(Active)、禁用(Inactive)或者删除已经生成的访问秘钥对。

您可以通过阿里云控制台的 秘钥管理页面 创建、管理所有的访问秘钥对,且保证它处于“启用”状态。由于访问秘钥是阿里云对 API 请求进行安全验证的关键因子,请妥善保管你的访问秘钥。如果某些秘钥对出现泄漏风险,建议及时删除该秘钥对并生成新的替代秘钥对。

步骤 3 在控制台完成号码与模板的申请,获得调用接口必备的参数

在“语音号码”页面完成资质的申请,号码的购买。

入参列表

参数名称 参数类型 必填与否 样例取值 参数说明
CallerShowNumber String 必须 4001112222 主叫显号
CallerNumber String 必须 13700000000 主叫号码
CalledShowNumber String 必须 4001112222 被叫显号
CalledNumber String 必须 13700000000 被叫号码
OutId String 可选 abcdefgh 预留给调用方使用的ID, 最终会通过在回执消息中将此ID带回给调用方(15个字符及以内)

出参列表

出参名称 出参类型 样例取值 参数说明
RequestId String 8906582E-6722 请求ID
Code String OK 状态码-返回OK代表请求成功,其他错误码详见错误码列表
Message String 请求成功 状态码的描述
CallId String 134523^4351232 调用的回执ID

技术对接步骤

1:下载SDK工具包

SDK&DEMO[下载地址]

2: 编写样例程序
  1. // 代码节选,详见aliyun-dyvms-php-sdk/api_demo/VmsDemo.php
  2. ...
  3. class VmsDemo
  4. {
  5. ...
  6. /**
  7. * 点击拨号
  8. *
  9. * @return stdClass
  10. * @throws ClientException
  11. */
  12. public static function clickToDial() {
  13. //组装请求对象-具体描述见控制台-文档部分内容
  14. $request = new ClickToDialRequest();
  15. //必填-主叫显号
  16. $request->setCallerShowNumber("05344757036");
  17. //必填-主叫号码
  18. $request->setCallerNumber("1800000000");
  19. //必填-被叫显号
  20. $request->setCalledShowNumber("05344757036");
  21. //必填-被叫号码
  22. $request->setCalledNumber("1500000000");
  23. //选填-外呼流水号
  24. $request->setOutId("yourOutId");
  25. //hint 此处可能会抛出异常,注意catch
  26. $response = static::getAcsClient()->getAcsResponse($request);
  27. return $response;
  28. }
  29. }
  30. $response = VmsDemo::clickToDial();
  31. echo "点击拨号(clickToDial)接口返回的结果:\n";
  32. print_r($response);

错误码列表

Code 描述
OK 请求成功
isp.RAM_PERMISSION_DENY RAM权限DENY
isv.OUT_OF_SERVICE 业务停机
isv.PRODUCT_UN_SUBSCRIPT 未开通云通信产品的阿里云客户
isv.OUT_OF_SERVICE 业务停机
isv.PRODUCT_UNSUBSCRIBE 产品未开通
isv.ACCOUNT_NOT_EXISTS 账户不存在
isv.ACCOUNT_ABNORMAL 账户异常
isv.DISPLAY_NUMBER_ILLEGAL 号显不合法
isv.INVALID_PARAMETERS 参数异常
isp.SYSTEM_ERROR 系统错误
isv.MOBILE_NUMBER_ILLEGAL 号码格式非法
isv.BUSINESS_LIMIT_CONTROL 触发流控