# Alibaba Cloud Voice Messaging Service API

> Alibaba Cloud Voice Messaging Service API on Apizie: 7 endpoints (Initiates a voice group call to multiple phone numbers. The content of the group call is that of approved…, Sends a voice verification code and voice notification with variables to a phone number, Initiates multiple voice calls to specified numbers. Supports voice file templates or text-to-speech…, Sends a voice verification code or a voice notification with parameter variables to a specified phone…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-dyvmsapi-intl`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/dyvmsapi-intl
- Page: https://apizie.tech/api/cloud/aliyun-dyvmsapi-intl
- OpenAPI: https://apizie.tech/api/cloud/aliyun-dyvmsapi-intl/openapi.json

Alibaba Cloud OpenAPI for Voice Messaging Service (dyvmsapi-intl, version 2021-10-15). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Initiates a voice group call to multiple phone numbers. The content of the group call is that of approved…
`POST https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/backend-call-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dyvmsapi-intl.ap-southeast-1.aliyuncs.com |
| CalledNumber | string | no | The called numbers. You can specify up to 50,000 phone numbers (JSON-encoded) |
| CallerIdNumber | string | no | The calling number. If you do not specify this parameter, the system uses a local random number as the display number. If you use a… |
| CountryId | string | no | The ISO2 country code |
| PlayTimes | integer | no | The number of times the audio file is played. Valid values: 1 to 3 |
| SendType | integer | no | The delivery type. Valid values: 1 and 2. 1: The audio file is delivered immediately. 2: The audio file is delivered at a scheduled time.… |
| Speed | integer | no | The playback speed. Valid values: -500 to 500. You must specify this parameter when the audio type is text-to-speech (TTS). You do not… |
| TaskName | string | no | The task name |
| TimingStart | string | no | The time when the audio file is scheduled to be delivered |
| TtsCode | string | no | The voice template ID of the audio file. You can log on to the VMS console and choose Voice Call Template > Audio File to view the… |
| VoiceCode | string | no | The TTS template ID. You can log on to the VMS console and choose Voice Call Template > TTS Template to view the template ID. You must… |
| Volume | integer | no | The playback volume of the audio file. Valid values: 0 to 100. Default value: 100 |
| OutId | string | no | The ID reserved for the caller. This ID is returned to the caller in a receipt message. The value must be of the STRING type and 1 to 15… |

### Sends a voice verification code and voice notification with variables to a phone number
`POST https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/backend-call-signal` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dyvmsapi-intl.ap-southeast-1.aliyuncs.com |
| CalledNumber | string | no | The phone number that receives the voice notification. You must add the country code to the beginning of the phone number. Example:… |
| CallerIdNumber | string | no | The calling number. If you do not specify this parameter, the system uses a local random number as the display number. If you use a… |
| CountryId | string | no | The ISO2 country code |
| PlayTimes | integer | no | The number of times the voice notification is played back in a call. Valid values: 1 to 3. Default value: 3 |
| Speed | integer | no | The playback speed. Valid values: -500 to 500 |
| TtsCode | string | no | The ID of the approved voice verification code template. You can log on to the VMS console and choose Voice Call Template to view the… |
| TtsParam | string | no | The variables in the template, in the JSON format |
| Volume | integer | no | The playback volume of the voice notification. Valid values: 0 to 100. Default value: 100 |
| OutId | string | no | The ID reserved for the caller. This ID is returned to the caller in a receipt message. The value must be of the STRING type and 1 to 15… |

### Initiates multiple voice calls to specified numbers. Supports voice file templates or text-to-speech…
`POST https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/group-call` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dyvmsapi-intl.ap-southeast-1.aliyuncs.com |
| Signature | string | no | The Signature |
| Timestamp | string | no | The Timestamp |
| SignatureNonce | string | no | The SignatureNonce |
| CalledNumber | string | no | The called numbers. A maximum of 50,000 numbers are supported (JSON-encoded) |
| CallerIdNumber | string | no | The calling number. If you do not specify this parameter, the system uses a random local number as the display number. If you use a… |
| CountryId | string | no | The ISO 3166-1 alpha-2 country or region code |
| PlayTimes | integer | no | The number of times the voice file is played. Valid values: 1 to 3 |
| SendType | integer | no | The send type. Valid values: 1 and 2. 1: starts the task immediately. 2: starts the task at a scheduled time. If you set this parameter to… |
| Speed | integer | no | The speech rate. Valid values: -500 to 500. This parameter is required when the audio type is TTS. This parameter is optional for recorded… |
| TaskName | string | no | The task name |
| TimingStart | string | no | 2022-05-01T08:00:00+08:00 |
| TtsCode | string | no | The template ID for text-to-speech. Log on to the International Voice Service console and choose Voice Template Management >… |
| VoiceCode | string | no | The template ID for the voice file. Log on to the International Voice Service console and choose Voice Template Management > Voice File to… |
| Volume | integer | no | The volume for voice file playback. Valid values: 0 to 100. Default value: 100 |
| OutId | string | no | The ID reserved for the caller. This ID is returned to the caller in the receipt message. The value is a string of 1 to 15 bytes in length |
| TtsParam | string | no | The variable parameters in the template, in JSON format |

### Sends a voice verification code or a voice notification with parameter variables to a specified phone…
`POST https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/signal-call` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dyvmsapi-intl.ap-southeast-1.aliyuncs.com |
| Signature | string | no | The Signature |
| Timestamp | string | no | The Timestamp |
| SignatureNonce | string | no | The SignatureNonce |
| CallerIdNumber | string | no | The calling number. If you do not specify this parameter, the system uses a random local number as the display number. If you use a… |
| CalledNumber | string | no | The phone number that receives the voice notification. Format: country code + phone number. Example: 85200****00 |
| TtsCode | string | no | The voice ID of the text-to-speech template. You can log on to the International Voice Service console and choose Voice Template… |
| TtsParam | string | no | The variable parameters in the template, in JSON format |
| VoiceCode | string | no | The template ID of the voice file. You can log on to the International Voice Service console and choose Voice Template Management > Voice… |
| PlayTimes | integer | no | The number of times the voice notification content is played in a single call. Valid values: 1 to 3. Default value: 3 |
| Volume | integer | no | The playback volume of the voice notification. Valid values: 0 to 100. Default value: 100 |
| Speed | integer | no | The speech rate control. Valid values: -500 to 500 |
| CountryId | string | no | The ISO2 two-letter country or region code |
| TaskName | string | no | The task name |
| SendType | integer | no | The send type. Valid values: 1 and 2. 1: starts the send task immediately without waiting. 2: starts the send task at a scheduled time. If… |
| TimingStart | string | no | The scheduled send time |
| OutId | string | no | The ID reserved for the caller. This ID is returned to the caller in the receipt message. The value is a string of 1 to 15 bytes in length |

### Sends a voice notification to multiple phone numbers. A voice file or text-to-speech (TTS) template is…
`POST https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/voice-group-call` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dyvmsapi-intl.ap-southeast-1.aliyuncs.com |
| CallerIdNumber | string | no | The calling number. If you do not specify this parameter, the system uses a local random number as the display number. If you use a… |
| CalledNumber | string | no | The called numbers. You can specify up to 50,000 numbers (JSON-encoded) |
| TtsCode | string | no | The ID of the TTS template. You can log on to the VMS console and go to the TTS templates page to view the template ID. You must specify… |
| TtsParam | string | no | The variables in the template, in the JSON format |
| VoiceCode | string | no | The ID of the voice file template. You can log on to the VMS console and go to the voice file templates page to view the template ID. You… |
| PlayTimes | integer | no | The number of times the voice notification is played in the call. Valid values: 1 to 3 |
| Volume | integer | no | The playback volume of the voice file. Valid values: 0 to 100. Default value: 100 |
| Speed | integer | no | The playback speed. Valid values: -500 to 500. This parameter is required when a TTS template is used. You do not need to specify this… |
| TaskName | string | no | The task name |
| SendType | integer | no | The delivery type. Valid values: 1 and 2. 1: immediately delivers the task. 2: delivers the task at a scheduled time. If you set this… |
| TimingStart | string | no | The time when the task is scheduled to be delivered |
| OutId | string | no | The ID reserved for the caller. This ID is returned to the caller in a receipt message. The value must be a string that is 1 to 15 bytes… |
| CountryId | string | no | The ISO2 country/region code |

### Sends a voice verification code or voice notification with variables to a phone number. A voice file or…
`POST https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/voice-single-call` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dyvmsapi-intl.ap-southeast-1.aliyuncs.com |
| CallerIdNumber | string | no | The calling number. If you do not specify this parameter, the system uses a local random number as the display number. If you use a… |
| CalledNumber | string | no | The phone number that receives the voice notification. You must add the country/region dialing code to the beginning of the phone number.… |
| TtsCode | string | no | The ID of the TTS template. You can log on to the VMS console and go to the TTS templates page to view the template ID. You must specify… |
| TtsParam | string | no | The variables in the template, in the JSON format |
| VoiceCode | string | no | The ID of the voice file template. You can log on to the VMS console and go to the voice file templates page to view the template ID. You… |
| PlayTimes | integer | no | The number of times the voice notification is played in the call. Valid values: 1 to 3. Default value: 3 |
| Volume | integer | no | The playback volume of the voice notification. Valid values: 0 to 100. Default value: 100 |
| Speed | integer | no | The playback speed. Valid values: -500 to 500 |
| TaskName | string | no | The task name |
| SendType | integer | no | The delivery type. Valid values: 1 and 2. 1: immediately delivers the task. 2: delivers the task at a scheduled time. If you set this… |
| TimingStart | string | no | The time when the task is scheduled to be delivered |
| OutId | string | no | The ID reserved for the caller. This ID is returned to the caller in a receipt message. The value must be a string that is 1 to 15 bytes… |
| CountryId | string | no | The ISO2 country/region code |

### version
`POST https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dyvmsapi-intl.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/backend-call-group" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Voice Messaging Service API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-dyvmsapi-intl/backend-call-group with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Voice Messaging Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Voice Messaging Service itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Voice Messaging Service API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-dyvmsapi-intl.

### What is the status of the Alibaba Cloud Voice Messaging Service API?
Needs your own provider key (bring your own key)