实在云号接口管理

发刊日期：

2025/10/10

编辑团队：

实在学院

使用须知

云手机号是一个虚拟手机号，无实体卡片，能正常接收短信。用来在RPA流程、Agent智能体中搭配使用。其短信可以通过Api的方式从运营商那里推送到服务上，其较传统的手机App读取短信，更稳定，更安全，且隐私性更好，不存在手机内容泄露的风险。但是其使用需要满足如下几个条件：

使用者需要有实在智能Agent/取数宝的账号
云手机号需要在云号平台上进行开号获取
云手机号的获取与正常的手机号申请并没有区别。依然需要身份证信息、实名认证激活，且云手机号会占用运营商的持有手机号数量（当前运营商规则是一个人/身份证只能持有5个联通手机号，并且在所有运营商持有的号码不得超过10个）
云手机号的申请需要有相关授权（商业合同约定）或者自助购买（自行付费）后才能进行申请，且申请的时候，不能超过相应的授权数量
云手机号申请后请在第一时间实名认证激活，超过15天，系统会自动回收此云号
云手机号在过期7天/停用/申请注销后，会进入账号注销流程。一旦注销，将无法恢复，请谨慎操作，并及时续费。
云手机号每月接收额度存在上限，目前是单月1000条。请在接收达到上限后联系实在智能进行处理。

云手机号的申请

云号申请地址

云手机号申请后如何使用

云手机号申请并激活后，请静待系统刷新。一般4小时内，会更新云手机号的状态为已激活，这个时候就可以使用云手机号进行业务的开发调整了。具体使用场景如：Agent流程通过云手机号等进行拼多多商家后台登录，或者人机校验等场景。

在使用中，我们模拟正常的手机号接收短信，在进行短信发送后，可以通过如下接口进行手机号短信的获取：

POST 短信查询

POST https://shizaiyunhao.ai-indeed.com/cloud-phone/cloud/phone/sms/v1/page

Body 请求参数

{
  "current": 1,
  "size": 10,
  "receivePhone": "13100000000（必填）",
  "smsSignatureLike": "拼多多（非必填）",
  "eventTimeStart": 短信接收时间（毫秒级时间戳，非必填）,
  "eventTimeEnd": 短信接收时间（毫秒级时间戳，非必填）
}

请求参数

名称	位置	类型	必选	说明
Authorization	header	string	是	Agent或者取数宝登录后的token信息。可以从流程上下文中获取到
TokenSource	header	string	是	Agent的流程此处固定传0，取数宝流程次数固定传1
body	body	string	是	none

返回示例

200 Response

{
  "code": "",
  "msg": "",
  "data": {
    "total": 10,
    "pages": 2,
    "size": 10,
    "current": 10,
    "records": [
      {
                "cloudPhoneSmsId": "65",
                "tenantUid": "7147d3e2be744881a7b549b85aec6869",
                "tenantName": "电商计费测试",
                "sendPhone": "10630818100002000",
                "receivePhone": "13100000000",
                "smsContent": "【拼多多】验证码：xxxx，您正在申请修改拼多多管理后台的绑定手机号，请于10分钟内完成验证，若非本人操作，请忽略此短信。",
                "direction": "MT",
                "eventTime": 1758789617000,
                "createTime": 1758789618000
            }
    ]
  },
  "success": false
}