number format specification guide
This document specifies the format for the CalledNumber parameter in Alibaba Cloud Voice Service API calls. These specifications help you correctly distinguish between domestic and international numbers to prevent call failures or blocking by carriers due to incorrect number formats.
Domestic Voice Number Recognition Rules
The Domestic Voice Service identifies domestic and international calls using the following two methods. Ensure that numbers are passed according to the following specifications:
Category | Number Parameter Format Type | Number Format Example | Recognition Result Description |
Domestic Call | With country code prefix |
| Clearly identified as a Chinese mainland number |
Without international prefix |
| Defaulted as a domestic mobile or landline number | |
International Call | 00 + international code |
| International call (United States) |
+ international code |
| International call (United States) | |
00 + satellite phone prefix (such as 8703, 8818, 8819) |
| International call (satellite phone) | |
+ satellite phone prefix (such as 8703, 8818, 8819) |
| International call (satellite phone) |
Important Notes
Product Capabilities
The domestic Voice Service product does not support international calls. If the `CalledNumber` parameter contains an international number, you may encounter the following risks. To make international calls, log on to the International Voice console to enable this feature.
Risks of Non-Compliant Number Parameter Input
Risk Item | Description |
Carrier blocking | Numbers without international long-distance capability are easily blocked by carriers when dialing international numbers, causing call failures. |
Cost risk | International call rates are much higher than domestic calls. Incorrect identification can lead to unexpectedly high costs. |
Compliance risk | International voice calls must comply with the communication regulations of the destination country. Non-compliance with local regulations can lead to the suspension of calling privileges. |
FAQ
Why did my domestic number call fail?
Check whether the number was incorrectly identified as an international number due to its format. If a number starts with 00 or + but is not in the 0086 or +86 format, it may be identified as an international call and blocked by domestic carriers.
What if I need to dial an international number?
Alibaba Cloud Voice Service (China Region) does not allow you to add numbers with international calling capabilities. If you have international calling requirements, go to the International Voice Console to apply.
How do I correctly pass landline numbers?
For landline numbers, you must include the area code, such as 0108888**** for Beijing or 0216666**** for Shanghai. You can add the +86 or 0086 prefix, but it is not required.