**终止支持通知：** 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 短信渠道
**注意**
Amazon Pinpoint 已更新其用户指南文档。要获取有关如何创建、配置和管理您的短信和语音资源的最新信息，请参阅新的[《AWS End User Messaging SMS 用户指南》](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html)。
以下主题已移至新的[《AWS End User Messaging SMS 用户指南》](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html)。
[关于短信/彩信和语音沙盒](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html)
[选择电话号码或发件人 ID](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-number-types.html)
[短信和彩信限额和限制](https://docs.aws.amazon.com//sms-voice/latest/userguide/sms-limitations.html)
[请求短信、彩信和语音消息收发支持](https://docs.aws.amazon.com//sms-voice/latest/userguide/awssupport.html)
[监控短信、彩信和语音消费活动 AWS End User Messaging SMS](https://docs.aws.amazon.com//sms-voice/latest/userguide/monitor-spending.html)
[用户初次使用教程](https://docs.aws.amazon.com//sms-voice/latest/userguide/getting-started-tutorial.html)
[关键词](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-keywords.html)
[双向短信收发](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-two-way-sms.html)
[短信和彩信国家/地区能力和限制](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-sms-support-by-country.html)
[电话池](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-pool.html)
[最佳实践](https://docs.aws.amazon.com//sms-voice/latest/userguide/best-practices.html)
[了解短信账单和使用情况报告](https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-billing.html)
您可以在 Amazon Pinpoint 中使用短信渠道将短信（文本消息）发送到客户的移动设备。Amazon Pinpoint 可以向 200 多个国家/地区的收件人发送短信。在某些国家/地区，您还可以使用双向短信功能接收来自客户的消息。当您创建新的 Amazon Pinpoint 账户时，您的账户被放在短信沙盒中。这最初会限制您的每月支出以及您可以向谁发送消息。有关更多信息，请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的[短信沙盒](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-sms)。
要使用 Amazon Pinpoint 发送文本消息，您必须[在项目中启用短信渠道](channels-sms-setup.md)。根据您使用 Amazon Pinpoint 发送短信的方式，您可能还需要向 支持 发起请求，以请求针对您的账户启用或修改某些短信选项。例如，您可以请求提升您的短信支出限额，请求从沙盒环境移至生产环境，或请求用于发送和接收消息的短代码。
要使用 Amazon Pinpoint 接收文本消息，需要先获得一个专用的短代码或长代码。获得专用号码后，您可以启用双向 SMS。最后，您可以指定 Amazon Pinpoint 在收到传入消息时发送给客户的消息。
在 Amazon Pinpoint 控制台的短信和语音设置部分，您可以管理使用案例和预算的短信渠道设置。例如，您可以设置您的每月短信支出限额，或更改您的默认消息类型。
**注意**
当您在 Amazon Pinpoint 中配置短信渠道设置时，您的更改将应用到发送短信的其他 AWS 服务 ，如 Amazon SNS。
**Topics**
+ [
# 设置 Amazon Pinpoint 短信渠道
](channels-sms-setup.md)
+ [
# 管理 Amazon Pinpoint 短信渠道
](channels-sms-manage.md)
+ [
# 消息路线
](channels-sms-limitations-routes.md)
+ [
# 消息回退
](channels-sms-limitations-fallback.md)
+ [
# 短信渠道故障排除
](channels-sms-troubleshooting.md)
# 设置 Amazon Pinpoint 短信渠道
要使用 Amazon Pinpoint 发送短信，您需要有一个 Amazon Pinpoint 项目，并且该项目中启用了短信渠道。
您还可以在 Amazon Pinpoint 控制台上使用**短信和语音**设置页面为现有项目启用短信渠道。有关更多信息，请参阅 [管理 Amazon Pinpoint 短信渠道](channels-sms-manage.md)。
## 使用 Amazon Pinpoint 控制台创建新项目
在 Amazon Pinpoint 中设置短信渠道的第一步是创建一个新项目。接下来，为该项目启用短信渠道。
**创建新的 Amazon Pinpoint 项目并启用短信渠道**
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. 在**账户级设置**下，您可以选择更改以下设置：
+ **默认消息类型** – 您计划发送的消息的类别。对于时效性内容（例如提醒和一次性密码），选择**事务性**，对于营销相关内容，选择**促销**。
+ **账户支出限额** – 您希望每个日历月为发送短信支付的最高金额（以美元为单位）。如果您的每月支出超过此值，Amazon Pinpoint 和其他公司将 AWS 服务 停止从您的账户发送短信。
**注意**
如果您尚未使用 Amazon Pinpoint 或 Amazon SNS 从您的 AWS 账户发送短信，则您的账户的默认支出限额为 1.00 美元（USD）。您可以请求提升此账户范围内的限额。有关更多信息，请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的[请求提升您的每月短信或语音支出限额](https://docs.aws.amazon.com//sms-voice/latest/userguide/awssupport-spend-threshold.html)。
+ **默认发件人 ID** – 收件人收到消息时显示在其设备上的身份。对发件人 ID 的支持因国家和/或地区有所不同。
**重要**
这些设置会应用于您的整个 AWS 账户。当您更改这些设置时，它们将应用于您账户中的所有其他 Amazon Pinpoint 项目，以及您 AWS 服务 用来发送短信的其他项目，例如 Amazon SNS。
1. 完成后，选择**保存更改**。
## 后续步骤
您创建了一个已启用短信收发的项目。现在，您可以使用 Amazon Pinpoint 发送短信。
在您联系 支持之前，某些短信选项（例如专用的发件号码或发件人 IDs）不可用。有关更多信息，请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的[请求短信和语音消息收发支持](https://docs.aws.amazon.com//sms-voice/latest/userguide/awssupport.html)。
要使受众分段与短信活动互动，请参阅[Amazon Pinpoint 活动](campaigns.md)。
要将短信直接发送到限定受众而无需创建活动，请参阅[使用 Amazon Pinpoint 发送测试消息](messages.md)。
# 管理 Amazon Pinpoint 短信渠道
您可以直接在 Amazon Pinpoint 控制台中管理短信设置，例如您的默认消息类型（事务性或促销）和每月支出限额。
## 更新短信渠道设置
您可以更改多个与短信相关的设置。这些设置大多适用于您的整个项目 AWS 账户，但有些设置适用于特定项目。
**编辑项目的短信设置**
1. 登录 AWS 管理控制台 并打开 Amazon Pinpoint 控制台，网址为。[https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)
1. 在**所有项目**页面上，选择要为其编辑短信设置的项目。
1. 在导航窗格中的 **Settings (设置)** 下，选择 **SMS and voice (SMS 和语音)**。
1. 在**短信设置**部分，选择**编辑**。
1. 根据需要更改项目的短信设置。您可以更改以下设置：
+ **为此项目启用短信渠道**
选择此选项可为项目启用或禁用短信渠道。如果未启用此设置，则无法从此项目发送短信。此设置仅适用于当前项目。
+ **账户级别设置** – 更改这些设置以修改您的 AWS 账户的短信设置。这些设置适用于您的整个亚马逊 Pinpoint 账户以及可用于发送短信的所有内容 AWS 服务 ，例如亚马逊简单通知服务 (Amazon SNS) Simple Notification Service。您可以更改以下设置：
+ **默认消息类型** – 选择您计划从此账户发送的短信的类别。如果您发送与账户相关的消息或对时间敏感的消息（例如一次性密码），请选择**事务性**。如果您计划发送包含营销材料或其他促销内容的消息，请选择**促销**。此设置适用于您的整个 AWS 账户。
+ **账户支出限额** – 您每月可用于发送消息的最大金额（以美元为单位）。您可以使用此设置来确保短信发送不会超过您的预算，或者将其用作防止支出意外增加的一种方式。发送短信的价格因该消息的目的地国家/地区而异。有关当前定价，请参阅 [Amazon Pinpoint 定价](https://aws.amazon.com/pinpoint/pricing/#SMS_text_messages)。此设置适用于您的整个 AWS 账户。
+ **账户发件人 ID** – 当您从账户发送消息时要使用的字母发件人 ID。此设置适用于您的整个 AWS 账户。
**注意**
仅 IDs 某些国家和支持字母发件人。如果您不是向其移动运营商支持发件人 ID 的国家发送消息，则无需在此字段中指定任何内容。美国、加拿大和巴西等常见邮件目的地 IDs 不支持发件人。
此外，一些要求发件人必须 IDs 向政府机构或行业组织进行预登记。
有关支持字母发件人的列表 IDs，请参阅《*AWS 最终用户消息 SMS 用户指南》中的 “支持的国家和地区（短信*[渠道）](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-sms-by-country.html)”。
1. 完成后，选择**保存更改**。
# 消息路线
您的消息使用的路线取决于为消息设置的类型，它们或者是**促销**类型，或者是**事务性**类型。当您使用 Amazon Pinpoint 控制台购买新号码时，系统会提示您选择路线类型。
促销路线通常是与营销或销售相关的消息。有些国家或地区具有安静时间，此时不允许您发送促销消息。事务性路线适用于对时间敏感度较高的消息，例如密码重置或一次性密码。这可以在您购买新号码时应用于该号码，也可以在 Amazon Pinpoint API 的 SendMessages 操作中作为可选参数传递。当使用该号码作为发起方发送消息时，Amazon Pinpoint 会选择适用的促销或事务性路线。
您可以使用 Amazon Pinpoint API 的 [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages) 操作将路线类型作为可选参数传递。在某些情况下，您可能使用 SenderID 作为发起方，或者可能有一个共享的号码池。如果您的事务性号码和促销号码都与目标国家/地区的账户相关联，Amazon Pinpoint 会默认选择事务性号码。根据所选号码，送达回执和送达控制面板将路线显示为促销路线或事务性路线。
# 消息回退
使用 Amazon Pinpoint API 发送消息时，可以在请求中传递三个可选参数：`originationNumber`、`registeredKeyword` 和 `senderID`。如果 Amazon Pinpoint 遇到 `originationNumber` 错误（例如无效字符），并且该错误可以重试，则 Amazon Pinpoint 会使用回退流程为请求选择有效的号码。回退功能按以下顺序检查有效数字。在此过程中的任何时候，Amazon Pinpoint 都会选择它找到的第一个有效号码作为发起号码。
1. 发起号码。检查任何其他有效的发起号码。
1. 关键字。扫描注册的关键字并与任何专用号码进行匹配。
1. 发件人 ID。检查任何其他有效的发件人 ID。
**注意**
如果发送的消息中包含您的账户中不存在的 `originationNumber`，则没有回退流程，而是返回一个异常消息。
如果请求中未传递上述任何参数，Amazon Pinpoint 会查看您的账户并按以下顺序检查是否存在有效号码：
1. 专用号码。按以下顺序检查与您的账户关联的任何专用号码：短代码、10DLC、长代码/免费电话号码。先检查国内号码，再检查国际号码。如果您的账户中同时有事务性和促销长代码，Amazon Pinpoint 会默认选择事务性号码。
1. 默认发件人 ID。
1. 共享路线。
**注意**
Amazon Pinpoint 将尝试在不需要发起身份的国家/地区发送消息。
# 短信渠道故障排除
确认日志记录开启，以帮助您确定失败原因。有关更多信息，请参阅[监控和日志记录](troubleshooting.md#troubleshooting-logging)。要开启 AWS 最终用户消息短信和语音 v2 API 的日志记录，请参阅[如何为亚马逊 Pinpoint 短信和语音 v2 API 设置亚马逊 Pinpoint 语音留言的日志](https://repost.aws/knowledge-center/pinpoint-voice-message-logging-setup-v2)记录？ 。
## 短信传输失败
****问题和解决方案****
+ 使用 [Amazon Pinpoint 号码验证器](https://docs.aws.amazon.com/pinpoint/latest/developerguide/validate-phone-numbers.html)确认号码是否有效。只有“移动”phoneType 支持短信传输。尽力尝试向“VOIP”号码发送短信。
+ 确认您的每月短信支出限额没有耗尽。有关更多信息，请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的[监控短信、彩信和语音支出活动](https://docs.aws.amazon.com//sms-voice/latest/userguide/monitor-spending.html)。
+ 如果传输问题仅出现在一、两台设备上，则排除与设备相关的问题。验证当出现故障时号码能否在 Amazon Pinpoint 之外接收短信。
+ 开启短信事件日志记录以帮助确定故障原因。
+ 查看[消息状态](https://docs.aws.amazon.com//pinpoint/latest/developerguide/event-streams-data-sms.html#event-streams-data-sms-attributes-attrs)。
+ 查看如何解决[尝试联系电话时发生未知错误](https://repost.aws/knowledge-center/sns-unknown-error-phone-sms)。
+ 记录特殊要求和规定。请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的[支持的国家/地区和区域（短信渠道）](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-sms-by-country.html)，并确认将满足这些要求。
## 双向短信故障排除
SNS 主题和/或订阅者收不到双向短信回复。
****问题和解决方案****
+ 确认在支持双向短信功能的国家/地区，您的号码启用了该功能。请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的[支持的国家/地区和区域（短信渠道）](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-sms-by-country.html)和[双向短信收发](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-two-way-sms.html)。
+ 确认发件人号码与 Amazon Pinpoint 中支持双向短信的号码来自同一个国家/地区。
+ 使用 [Amazon Pinpoint 电话号码验证器 API](https://docs.aws.amazon.com/pinpoint/latest/developerguide/validate-phone-numbers.html) 确认用户号码为有效的手机号码而非虚拟号码。尽最大努力在两个虚拟号码（例如 Amazon Pinpoint 中的虚拟号码）之间进行通信。
+ 查看[亚马逊 SNS CloudWatch 指标](https://docs.aws.amazon.com/sns/latest/dg/sns-monitoring-using-cloudwatch.html#sns-metrics)以了解`NumberOfMessagesPublished``NumberOfNotificationsDelivered`、和`NumberOfNotificationsFailed`以验证 Amazon SNS 主题是否能够接收入站短信。
+ 如果在入站短信时间戳时有 `NumberOfMessagesPublished` 数据点，则说明已成功收到来自下游的收件人响应。请在 Amazon SNS 主题上为所使用的传输协议启用日志记录。请参阅 [Amazon SNS 消息传输状态](https://docs.aws.amazon.com/sns/latest/dg/sns-topic-attributes.html).
+ 如果在入站短信时间戳时没有 `NumberOfMessagesPublished` 指标的数据点，请执行以下操作：
+ 查看 Amazon SNS 主题策略，确认该策略允许 Amazon Pinpoint 服务将消息发布到 Amazon SNS 主题。有关策略示例，请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的[双向短信收发](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-two-way-sms.html)。
+ 如果链接到双向短信号码的 Amazon SNS 主题是加密的，则执行以下操作：
+ 确认使用的密钥是对称的。
+ 确认密钥策略已修改为允许 Amazon Pinpoint 使用密钥，请参阅《AWS 终端用户消息发送 SMS 服务用户指南》**中的 [Amazon SNS 主题的 Amazon SNS 主题策略](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-two-way-sms.html#phone-number-two-way-sms-iam-policy-auto)。