文档>显号规则说明
显号规则说明
显号规则说明
语音（PSTN）显号服务是平台的一项增值业务，开放平台允许企业客户在符合规范业务的需求下在被叫端显示指定号码。
1.显号规则目的
为了规范回拨、落地、语音验证码显号业务流程，减少显号带来的风险。
2.显号规则总则
使用回拨、落地、语音验证码能力接口，涉及到显号业务需求时，必须按照显号规则说明使用，否则请求的业务能力将不会显号。 显号规则如下所示：
| 属性 | ||
|---|---|---|
| 直拨 | 协议用户 | 非协议用户 |
| 被叫 | 手机号（除被叫手机号） | Client绑定的手机号 |
| 官号 | 官号 | |
| 非上述号码，被叫不显号 | 非上述号码，被叫不显号 | |
| 回拨 | 协议用户 | 非协议用户 |
| 主叫 | 官号 | 官号 |
| 手机号（除主叫手号） | —————— | |
| 非上述号码，不显号 | 非官号，不显号 | |
| 被叫 | 手机号（除被叫手机号） | Client绑定的手机号 |
| 官号 | 官号 | |
| 非上述号码，被叫不显号 | 非上述号码，被叫不显号 |
3.显号使用流程
进入创建应用界面，高级配置中，会有回调地址配置选项及显号服务配置选项（个人开发者无此选项）：
注解：
• 回调地址的目的：平台会将每路通话的数据通过回调地址通知给开发者AS，方便开发者实现自主计费。
• 回调地址的作用：
- A.呼叫鉴权请求接口：开发者可以通过该接口的AS响应参数retcode、displaynumber、allowedcalltime分别控制每路通话是否允许建立通话、是否显号以及允许通话时长。
- B.呼叫建立通知接口：平台在呼叫建立时，将通过该接口通知开发者AS当前通话详情。
- C.呼叫挂机计费接口：当用户挂机或其他原因导致通话结束时，将通过该接口通知开发者AS通话结束，以及整个会话的详情，包括通话创建时间、通话结束时间以及通话时长等信息。
- • 接口或回调传值显号：开启显号并配置了所需的回调地址后，即可使用业务接口的显号服务。
备注：显号规则详情，请参考显号规则描述
4.显号规则描述
4.1 名称解释：
4.1.1 为什么要制定显号规则？
为了呼叫时被叫端能够显示开发者设置的号码，并且避免一些带有营销、广告性质的号码，我们很贴心的为广大开发者制定了显号规则。
4.1.2 显号规则针对哪几类用户？
协议用户：在企业认证审核通过后，可以申请成为协议用户。企业需要与有联云签署合作协议并交纳一定的保证金。协议用户可显示任意手机号码。
非协议用户：个人开发者和未成为协议用户的企业。
4.1.3 什么叫官方号码？
创建应用时开发者选择开启官方显号服务及开启语音验证显号服务中填写的号码均为官方号码。官方号码格式为固话或400号码，该号码最终会显示在被叫端。
4.1.4 配置了号码就可以显号了吗？
当开发者提交应用后，还需要经过我们后台人员的应用审核，来确定这些号码是否合法。审核通过后就可以显号了。
4.2 语音验证码显号规则
面向所有开发者。若需要语音验证码显号，勾选“显号服务”的同时填入固话或者400号码（在上图二配置）即可。
4.3 直拨显号规则
- A.直拨显号必须配回调地址，否则直拨将不予显号。
- B.协议用户： displaynumber的值为合法的电话号码（即11位标准的手机号码、带区号的固话号码、400号码），则displaynumber的值作为被叫侧显示号码；若displaynumber的值为空或00000000000，则被叫侧不显号。
- C.非协议用户： displaynumber的值为手机号码、400号码或固话号码，验证通过后将作为被叫侧显示号码；若displaynumber的值为空或00000000000，则被叫侧不显号。
4.4 回拨显号规则
4.4.1 协议用户
已配回调地址（在图一中配置）：
A.Sdk或Rest回拨接口中的toSerNum和fromSerNum为合法的电话号码或者为空。
B.若A传入的号码都为空，则主被叫侧都不显号。
C.开发者AS响应displaynumbe参数值为：
a：为空，不做验证判断，并且toSerNum和fromSerNum分别作为最终主被叫侧显示的号码；
b：不为空，则覆盖toSerNum号码并做为被叫侧显示号码;
c：若为00000000000，则toSerNum被叫侧不显号。
未配置回调地址：
A.Sdk或Rest回拨接口中的toSerNum和fromSerNum为合法的电话号码或者为空。
B.若A传入的号码都为空，则主被叫侧都不显号。
4.4.2 非协议用户
已配回调地址：
A.Sdk或Rest回拨接口中的toSerNum参数值若为：
a：为空，不做验证判断；
b：不为空，先验证是否是官方号码，不是则验证是否是与Client绑定的手机号码，都不是则回拨请求不会显号。
B.Sdk或Rest回拨接口中的fromSerNum参数值若为：
a：为空，不做验证判断；
b：不为空，只验证是否是官方号码，不是则回拨请求不会显号。
C.开发者AS响应displaynumbe参数值为：
a：为空，不做验证判断；
b：不为空，先验证是否是官方号码，不是则验证是否是与Client绑定的手机号码，都不是则回拨请求不会显号；
c：验证通过，则覆盖SDK或Rest回拨接口中的toSerNum号码并做为被叫侧显示号码;
d：若为00000000000，则toSerNum被叫侧不显号。
D.若A、B、C传入的号码都为空，则不做验证判断，并且主被叫侧都不显号。
未配置回调地址：
A.Sdk或Rest回拨接口中的toSerNum参数值若为：
a：为空，不做验证判断；
b：不为空，先验证是否是官方号码，不是则验证是否是与Client绑定的手机号码，都不是则回拨请求不会显号。
B.Sdk或Rest回拨接口中的fromSerNum参数值若为：
a：为空，不做验证判断；
b：不为空，只验证是否是官方号码，不是则回拨请求不会显号。
C.若A、B传入的号码都为空，则主被叫侧都不显号。