阿里云号码隐私保护服务完全对接指南：从控制台配置到API深度集成

apphuang2026年06月26日 09:28:582

一、为什么需要号码隐私保护

在网约车、外卖配送、物流快递、在线招聘等互联网平台业务中，用户与服务提供者之间的电话沟通不可避免会暴露双方的真实手机号码。一旦号码泄露，用户可能面临骚扰电话、精准营销甚至电信诈骗等风险。阿里云号码隐私保护服务应运而生，它基于基础运营商的通信网络能力，为企业客户提供虚拟中间号服务，使得通话双方仅通过一个临时分配的隐私号码就能完成沟通，而彼此的真实号码始终处于隐藏状态。

号码隐私保护（Phone Number Protection，简称PNP）是一款SaaS化的通信能力产品。企业无需购置任何实体SIM卡或硬件设备，只需通过阿里云控制台开通服务，并调用相应的OpenAPI，即可在自身业务系统中集成隐私通话能力。该服务广泛应用于出行、外卖、物流、招聘、家装等需要临时沟通但又必须保护双方号码隐私的场景。

从技术实现层面看，号码隐私保护的核心是“中间号”机制。平台为每一次通话临时或长期绑定一个中间号码（即X号码），当A号码拨打X号码时，系统将呼叫转接至B号码；反之，B号码拨打X号码时，呼叫转接至A号码。整个过程中，A和B始终不知道对方的真实号码，所有通话记录和录音均可留存，便于企业进行服务质量管控与纠纷溯源。

需要先登录阿里云控制台，点击：阿里云控制台

二、隐私号类型选型指南

阿里云号码隐私保护提供了四种主要的隐私号类型，分别适用于不同的业务场景。正确选型是高效对接的第一步。

1. AXB中间号

AXB中间号主要应用于一对一专属服务场景。在这种模式下，用户A与服务方B通过API在平台建立绑定关系，双方均可通过中间号X联系到对方。一个X号码可以同时供最多200对绑定关系复用，只要A、B用户手机号码不重复，多组通话可以同时进行互不干扰。典型场景包括网约车司机与乘客、在线问诊医生与患者、房产经纪人带看等。

2. AXN隐私号

AXN隐私号是为保护单个用户A的号码隐私而设计的模式。系统为用户A分配一个独立的隐私号码X，其他所有用户（B1、B2……BN）均可通过拨打X号码联系到A，而A的真实号码对外完全隐藏。这种模式适用于外卖骑手联系顾客、快递员联系收件人、客服回访等场景——一方是固定的被保护对象，另一方是动态变化的众多呼叫者。

3. AXG隐私号

AXG隐私号是在AXN基础上增加了号码组G的概念，主要面向有用户分级、呼叫范围限制或抢单限制等需求的平台客户。例如在招聘平台中，可以将某个招聘团队的所有成员设为一个G组，只有该G组内的号码才能通过X号码联系到应聘者A。这种模式有效防止了非授权人员的随意拨入，适用于家装配送、大件物流、企业服务等需要管控呼叫来源的场景。

4. AXN分机号

AXN分机号是AXN的衍生模式。针对快递、外卖等行业面单量大、隐私号需求数量巨大的特点，阿里云对每一个X号码进行了扩位——其他用户在拨打X号码后，需输入分机号才能转接到被保护用户A。这种模式大幅提升了单个X号码的复用率，有效降低了号码成本。

三、控制台前置操作

在调用API之前，需要在阿里云控制台完成一系列前置配置工作。

1. 企业实名认证

号码隐私保护服务只针对企业开通此服务，需要企业实名才能开通。如果您未注册阿里云账号，请先完成账号注册和企业实名认证。如果您已有企业实名认证的阿里云账号，请直接进行下一步操作。

2. 开通号码隐私保护服务

登录阿里云控制台，在产品列表中找到“号码隐私保护”并点击开通。开通服务后，您将获得一个初始的号码池配置权限。

3. 创建号码池

号码池是管理隐私号码的逻辑容器。您在购买隐私号时，需要为隐私号选择对应类型的号码池。登录号码隐私保护控制台，在左侧导航栏选择“号码与号码池”>“号码池管理”。在号码池管理页面，单击“添加号码池”，选择隐私号类型、填写号码池名称，然后单击“添加”。重要提示：号码池暂不支持删除。

4. 添加使用场景

在左侧导航栏选择“场景管理”，单击“添加场景”，根据页面提示信息填写场景参数。需要选择已通过审核的资质，若无合适可用的资质，请先提交企业资质通过审核。

5. 购买隐私号码

在号码池创建完成后，需要购买隐私号码。购买时需选择号码归属地的省份和城市。需要注意的是，涵盖城市列表为目前号码隐私保护支持的城市，未列出的城市暂不支持服务。此列表会根据服务扩增逐步调整。

四、OpenAPI集成详解

完成控制台前置操作后，即可进入技术集成阶段。号码隐私保护服务提供隐私号码绑定、获取录音文件、查询隐私号码等多种OpenAPI。

1. API版本与接入点

号码隐私保护服务目前支持2017-05-25版本的API列表。这个版本号代表的是API版本号而非时间概念，所展示的都是最新的API公开数据。全局接入域名为 dyplsapi.aliyuncs.com。根据相关资源所在地域，选择对应的服务接入点地址，以获得最低延迟。

2. 认证鉴权

调用OpenAPI需要拥有阿里云账号的AccessKey ID和AccessKey Secret。强烈建议您创建并使用RAM用户进行API访问或日常运维。RAM用户需具备操作权限。阿里云账号拥有所有API的访问权限，风险很高。请根据业务的实际情况按需分配权限后进行接口调用。

3. Python SDK调用示例

阿里云为开发者提供了多种编程语言的SDK，包括Java、C#、Go、Python、Node.js/TypeScript、PHP、C++等。开发者只需集成SDK，通过SDK暴露的方法直接调用OpenAPI。SDK统一封装了签名逻辑、超时机制、重试机制，并根据文档返回结构化Response对象，易于开发。

以下是以Python语言调用BindAxb接口的完整示例代码：

#!/usr/bin/env python
# -*- coding: utf-8 -*-

from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.request import CommonRequest
import json

# 初始化AcsClient
client = AcsClient(
    'your-access-key-id',
    'your-access-key-secret',
    'cn-hangzhou'
)

# 构建BindAxb请求
request = CommonRequest()
request.set_domain('dyplsapi.aliyuncs.com')
request.set_version('2017-05-25')
request.set_action_name('BindAxb')

# 设置请求参数
request.add_query_param('PoolKey', '您的号码池Key')
request.add_query_param('PhoneNoA', '13800000001')  # A号码
request.add_query_param('PhoneNoB', '13800000002')  # B号码
request.add_query_param('PhoneNoX', '隐私号码X')    # 已购买的隐私号码
request.add_query_param('Expiration', '2026-07-01 12:00:00')  # 绑定过期时间
request.add_query_param('IsRecordingEnabled', True)  # 是否开启录音
request.add_query_param('OutId', 'order_123456')     # 业务扩展字段

# 发起调用
try:
    response = client.do_action_with_exception(request)
    result = json.loads(response)
    print('绑定成功，绑定关系ID：', result.get('SubsId'))
    print('完整响应：', json.dumps(result, indent=2, ensure_ascii=False))
except Exception as e:
    print('调用失败：', str(e))

4. Java SDK调用示例

以下是Java语言调用BindAxb接口的完整示例代码：

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.dyplsapi.model.v20170525.BindAxbRequest;
import com.aliyuncs.dyplsapi.model.v20170525.BindAxbResponse;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;

public class BindAxbDemo {
    public static void main(String[] args) {
        // 创建DefaultAcsClient实例
        DefaultProfile profile = DefaultProfile.getProfile(
            "cn-hangzhou",
            "your-access-key-id",
            "your-access-key-secret"
        );
        IAcsClient client = new DefaultAcsClient(profile);

        // 构建BindAxb请求
        BindAxbRequest request = new BindAxbRequest();
        request.setPoolKey("您的号码池Key");
        request.setPhoneNoA("13800000001");  // A号码
        request.setPhoneNoB("13800000002");  // B号码
        request.setPhoneNoX("隐私号码X");     // 已购买的隐私号码
        request.setExpiration("2026-07-01 12:00:00");  // 绑定过期时间
        request.setIsRecordingEnabled(true);  // 是否开启录音
        request.setOutId("order_123456");     // 业务扩展字段

        try {
            BindAxbResponse response = client.getAcsResponse(request);
            System.out.println("绑定成功，绑定关系ID：" + response.getSubsId());
            System.out.println("完整响应：" + response.getRequestId());
        } catch (ServerException e) {
            System.out.println("服务端异常：" + e.getErrCode() + " - " + e.getErrMsg());
        } catch (ClientException e) {
            System.out.println("客户端异常：" + e.getErrCode() + " - " + e.getErrMsg());
        }
    }
}

5. 在线调试

号码隐私保护服务在OpenAPI门户提供API调试等功能。登录阿里云OpenAPI门户，在号码隐私保护服务页面左侧导航栏选择BindAxb接口。在中间参数配置面板中，选择服务地址为华东2（上海），依次填写PoolKey（号码池Key）、PhoneNoA（A号码）、PhoneNoB（B号码）、PhoneNoX（X号码）、Expiration（过期时间）、ExpectCity（指定城市选号）、IsRecordingEnabled（是否录音）等请求参数，然后单击“发起调用”完成在线调试。右侧文档区可查看接口说明及请求参数详情，QPS限制为5000次/秒。

五、绑定关系管理

1. 查询绑定详情

可以通过QuerySubscriptionDetail接口查询号码绑定详情。登录号码隐私保护控制台，在号码管理页面筛选号码，点击详情查看号码的绑定关系ID，或者在调用BindAxb等号码绑定API时查看返回参数中的SubsId。在填写绑定关系ID时，注意填写与PhoneNoX参数关联的绑定关系ID。

2. 修改绑定关系

可以通过UpdateSubscription接口修改已绑定的号码。登录号码隐私保护控制台，在号码管理页筛选号码，点击详情查看号码的绑定关系ID。

3. 解绑号码

当业务完成、不再需要隐私通话时，应及时解绑号码以释放资源并停止计费。解绑操作可以通过调用对应的解绑API完成，也可以在控制台号码管理页面手动操作。

六、通话录音与状态查询

1. 录音功能

号码隐私保护服务支持通话录音功能。在调用绑定接口时，通过设置IsRecordingEnabled参数为true即可开启录音。录音文件可用于服务质量分析、纠纷溯源等场景。录音转文字功能也已集成，可以将录音文件线上转译成文字，便于客户存储和处理。

2. 呼叫状态查询

企业可以通过回执消息机制获取通话状态、录音文件等信息。号码隐私保护服务支持通过轻量消息队列（原MNS）拉取回执消息。开发者需要部署消息队列的消费端，以便及时接收通话记录和录音文件下载地址。

七、错误码与排障指南

在调用API过程中，可能会遇到各类错误码。以下是常见错误码及处理建议：

isp.RAM_PERMISSION_DENY：RAM权限被拒绝。请检查RAM用户的授权策略是否正确。
isv.OUT_OF_SERVICE：业务停机。请检查账户余额是否充足，服务是否被暂停。
isv.PRODUCT_UN_SUBSCRIPT：未开通云通信产品。请检查当前AccessKey对应账号是否已经开通阿里云号码隐私保护。
isv.ACCOUNT_NOT_EXISTS：账户不存在。请检查AccessKey是否正确。
号码状态异常：调用接口时指定的X号码因投诉或号码状态异常被加入了黑名单。请联系阿里云技术支持处理。

八、计费模式与成本优化

1. 计费方式

号码隐私保护服务支持按量计费和号码隐私保护套餐包两种模式。按量付费是后付费模式，套餐包是预付费模式。资源包相对于按量付费更优惠。

2. 费用构成

号码隐私保护服务的费用主要包括以下几个方面：

号码首购费用：新购号码须一次性支付相当于三个月月租的首购费用。虚商号码首购费用为30.00元/次，运营商号码首购费用为45.00元/次。
号码月租费用：第二、第三月不再支付月租费用，第四个月恢复按月支付。虚商号码月租费用为10.00元/月，运营商号码月租费用为15.00元/月。
通话时长费用：采用阶梯用量计费，按月计算，下月清零。0-1万分钟为0.060元/分钟，1-10万分钟为0.055元/分钟，10-50万分钟为0.050元/分钟，50-100万分钟为0.045元/分钟，100-200万分钟为0.040元/分钟，200-500万分钟为0.035元/分钟，500万分钟以上为0.030元/分钟。
录音时长费用：0.010元/分钟。
录音转文字费用：0.060元/分钟。
智能状态码费用：按实际使用量计费。

3. 套餐包优惠

号码隐私保护提供多种套餐包选项：

通话时长套餐包：500分钟28.50元/年，5000分钟261.25元/年，5万分钟2375元/年，50万分钟21375元/年。
录音时长套餐包：500分钟4.75元/年，5000分钟45.12元/年，5万分钟441.75元/年，50万分钟4275.00元/年。
号码月租套餐包：120次号码月租541.50元/年，1200次号码月租5130.00元/年。

4. 成本优化建议

根据业务量预估选择合适的套餐包，预付费套餐包比按量付费更优惠。
合理规划号码的使用周期，不需要时及时解绑注销，避免产生不必要的月租费用。
对于面单量大的场景（如快递、外卖），优先考虑AXN分机号模式以降低号码成本。
监控通话时长和录音时长用量，及时调整套餐包规格。

九、合规要求与最佳实践

1. 企业资质要求

号码隐私保护服务只针对企业开通此服务，需要企业实名才能开通。同时，AXN隐私号依据《工信部网安函（2016）452号》的要求进行实名制管理。为确保使用隐私号服务的企业和用户均已实名可溯源，运营商对现有服务号码使用单位企业实名报备和号码实际使用人个人实名报备要求进行了升级。

2. 号码使用限制

号码隐私保护服务适用于出行、物流、外卖等多种订单类型的业务场景，非订单型业务目前暂不支持接入使用。由于通信运营商管控规则升级，号码隐私保护服务不再支持00开头的号码进行绑定。

3. 安全建议

使用RAM用户进行API调用，避免使用主账号AccessKey。
为RAM用户授予最小权限原则，仅授予必需的API操作权限。
定期轮换AccessKey，降低密钥泄露风险。
开启通话录音功能，便于服务质量管控和纠纷溯源。

4. 号码注销注意事项

购买的号码若不需要使用，可登录号码隐私保护控制台，在号码管理页面注销号码。注销当月仍会产生费用。若注销购买的号码，号码首购费用和号码注销当月的月租费用不予退还。

十、常见问题问答

问1：一个X号码可以绑定多少对A、B号码？

答：AXB模式下，一个X号码可以同时供最多200对绑定关系复用，只要A、B用户手机号码不重复，多组通话可以同时进行互不干扰。

问2：绑定关系有有效期吗？

答：绑定关系通过Expiration参数设置过期时间。到达过期时间后，绑定关系自动失效，通话将无法通过隐私号码转接。建议根据业务实际需要设置合理的过期时间。

问3：开通号码隐私保护服务需要什么条件？

答：号码隐私保护服务只针对企业开通此服务，需要企业实名才能开通。同时需要完成控制台的前置配置，包括创建号码池、添加使用场景、购买隐私号码等。

问4：如何获取通话录音文件？

答：在调用绑定接口时设置IsRecordingEnabled为true即可开启录音。录音文件可以通过轻量消息队列（原MNS）回执消息获取下载地址。

问5：号码隐私保护支持哪些编程语言的SDK？

答：阿里云为开发者提供了多种编程语言的SDK，包括Java、C#、Go、Python、Node.js/TypeScript、PHP、C++等。

问6：号码注销后还会产生费用吗？

答：注销当月仍会产生费用。若注销购买的号码，号码首购费用和号码注销当月的月租费用不予退还。建议在不需要使用时及时注销，避免持续产生月租费用。