

**终止支持通知：** AWS 将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后，您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源（端点、分段、活动、旅程和分析）。有关更多信息，请参阅 [Amazon Pinpoint 终止支持](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：** APIs 与短信相关、语音、移动推送、OTP 和电话号码验证不受此更改的影响，并受 AWS 最终用户消息的支持。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon Pinpoint 语音渠道
<a name="channels-voice"></a>

**注意**  
Amazon Pinpoint 已更新其用户指南文档。要获取有关如何创建、配置和管理 AWS 最终用户消息 SMS 和语音资源的最新信息，请参阅新的《[https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html)。  
以下主题已移至新的[《AWS 用户指南》**](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html)。  
[Amazon Pinpoint 语音沙盒](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-voice)
[支持的国家/地区和区域（语音渠道）](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-voice-support-by-country.html)
[在 Amazon Pinpoint 中管理池](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-pool.html)
[语音渠道的最佳实践](https://docs.aws.amazon.com//sms-voice/latest/userguide/best-practices.html#voice-best-practices)

您可以使用语音渠道根据文本脚本创建语音消息，然后通过电话将这些消息发送给客户。语音渠道是联系那些电话号码无法接收短信的客户（例如，使用固定电话或 VoIP 服务的客户）的一种好办法。

要使用 Amazon Pinpoint 发送语音消息，必须先在项目中启用语音渠道，并租赁用于发送消息的专用电话号码。根据您如何使用 Amazon Pinpoint 发送语音消息，您可能还需要更改账户的某些设置。例如，您可能希望请求生产访问权限以增加可发送的语音消息数。

**Topics**
+ [设置 Amazon Pinpoint 语音渠道](channels-voice-setup.md)
+ [管理 Amazon Pinpoint 语音渠道](channels-voice-manage.md)
+ [语音渠道故障排除](channels-voice-troubleshooting.md)

# 设置 Amazon Pinpoint 语音渠道
<a name="channels-voice-setup"></a>

要使用 Amazon Pinpoint 发送语音消息，请先创建一个新的 Amazon Pinpoint 项目。然后，为该项目启用语音渠道，并请求专用的电话号码（称为*长代码*）以发送语音消息。*长代码* 是一个标准电话号码，最多包含 15 位数字，具体取决于它所在的国家或地区。这些电话号码是*专用的*，也就是说，它们只保留给您的 Amazon Pinpoint 账户使用。您可以租用各个国家或地区的本地电话号码。

**提示**  
您也可以为现有的项目启用语音渠道。为此，请使用 Amazon Pinpoint 控制台上的**短信和语音**设置页面。有关更多信息，请参阅 [管理 Amazon Pinpoint 语音渠道](channels-voice-manage.md)。

请注意，您为语音通道选择的设置也适用于项目的 SMS 通道。如果要从项目中发送语音和 SMS 消息，请选择支持两个通道的目标的设置。要了解启用和使用短信渠道的更多信息，请参阅 [Amazon Pinpoint 短信渠道](channels-sms.md)。

**为新项目设置语音渠道**

1. 打开亚马逊 Pinpoint 控制台，网址为。[https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. 在**所有项目**页面上，选择**创建项目**。

1. 对于**项目名称**，请输入名称，然后选择**创建**。
**注意**  
项目名称最多可包含 64 个字母数字字符。它也可以包含以下字符：逗号 (,)、句号 (.)、at 符号 (@)、下划线 (\$1)、等号 (=) 和加号 (\$1)。

1. 在 **Project features (项目功能)** 下的 **SMS and voice (SMS 和语音)** 部分中，选择 **Configure (配置)**。

1. 选择**为此项目启用语音渠道**。

1. 展开**高级配置**部分，然后选择**申请电话号码**。

1. 在**定义您的电话号码**页面上，对于**国家/地区**，请选择收件人所在的国家/地区。您一次只能选择一个国家/地区，但如有必要，可以稍后再选择其他国家/地区。

1. 指定电话号码的用例。您可以选择以下选项之一：
   + **促销** - 选择此选项可发送营销消息或宣传您的业务或服务的消息。
   + **事务性** - 选择此选项可发送对时间敏感的消息，例如密码重置或事务提醒。

   在某些国家/地区和区域，您选择的值可能会决定您为发送的每条消息支付的价格。事务性消息针对高送达率进行了优化，因此在许多国家/地区需要支付较高的成本。促销信息针对成本效益进行了优化。有关短信定价的更多信息，请参阅 [Amazon Pinpoint 定价](https://aws.amazon.com/pinpoint/pricing/)。

1. **摘要**部分显示有关该号码的信息。**每月价格**显示单个号码的费用。

1. 对于**数量**，选择要购买的号码数量。在单个申请中，最多可以购买 10 个号码。您可以日后再购买其他号码。**小计**更新为显示对应您要购买的电话号码数量的每月总成本。

1. （可选）如果您想购买其他电话号码，请选择**添加国家或地区**，然后重复前面的步骤，直到为所有您需要其长代码的国家/地区定义了请求为止。

1. 购买完电话号码后，选择**下一步**。

1. **审查并申请**页面显示每个目的地国家/地区的号码申请详情。

1. **总成本**显示您选择的所有国家/地区的所有号码的总成本。

1. 如果您准备就绪，请选择**请求**。否则，请选择**上一步**，返回并进行任何更改。选择**请求**后，您将无法再进行更改。

# 管理 Amazon Pinpoint 语音渠道
<a name="channels-voice-manage"></a>

您可以使用 Amazon Pinpoint 控制台为项目启用语音渠道，以及管理应用于您的 Amazon Pinpoint 账户的语音渠道的设置。例如，您可以为您的账户请求生产访问权限，或者请求专用的电话号码以发送语音消息。

## 启用语音渠道
<a name="channels-voice-manage-enable"></a>

您必须先为一个或多个项目启用语音渠道，然后才能使用 Amazon Pinpoint 发送语音消息。要了解如何创建新的项目并为其启用语音渠道，请参阅[设置 Amazon Pinpoint 语音渠道](channels-voice-setup.md)。要为现有的项目启用语音渠道，请完成以下步骤。

请注意，您为语音通道选择的设置也适用于项目的 SMS 通道。如果要从项目中发送语音和 SMS 消息，请选择支持两个通道的目标的设置。要了解更多信息，请参阅[Amazon Pinpoint 短信渠道](channels-sms.md)。

**为现有的项目启用语音渠道**

1. 打开亚马逊 Pinpoint 控制台，网址为。[https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. 在**所有项目**页面上，选择要为其启用语音渠道的项目。

1. 在导航窗格中的 **Settings (设置)** 下，选择 **SMS and voice (SMS 和语音)**。

1. 在**短信和语音**页面上，在**短信设置**旁边，选择**编辑**。

1. 选择**为此项目启用语音渠道**。

1. 选择**保存更改**。

1. 在**短信和语音**页面上，**号码设置**下，请参考该表以确定是否可以使用已与您的账户关联的任何电话号码发送语音消息。如果具有此类号码，**语音**列将在每个可用于发送语音消息的电话号码旁边显示**已启用**。如果没有显示，请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的[申请电话号码](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-request.html)。

# 语音渠道故障排除
<a name="channels-voice-troubleshooting"></a>

有关 Amazon Pinpoint 语音消息的日志记录，请参阅[如何为 Amazon Pinpoint SMS 和 Voice API 第 1 版的 Amazon Pinpoint 语音消息设置日志记录？](https://repost.aws/knowledge-center/pinpoint-voice-message-logging-setup)。

## 语音
<a name="troubleshooting-voice"></a>

****问题和解决方案****
+ 默认情况下，Amazon Pinpoint 项目的语音渠道是关闭的。要查看您的项目是否已开启语音，请选择项目下的**设置**页面。在短信和语音的**特征**下，您将看到它们是关闭还是开启的。您可以在**管理**选项下打开短信功能，并且可以通过运行以下命令来打开语音渠道：

  ```
  aws pinpoint update-voice-channel --application-id AppId --voice-channel-request Enabled=true
  ```
+ TooManyRequests 例外
  + 如果您的账户位于沙盒中，则它具有 24 小时内 20 条消息的限制。您可以提高此限制，请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的[语音沙盒](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-voice)。
  + Amazon Pinpoint 语音渠道的硬性限制为 24 小时内每位收件人最多五条消息。这是一项硬性限制，无法增加。