

**终止支持通知：** 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 最终用户消息的支持。

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

# 短信渠道故障排除
<a name="channels-sms-troubleshooting"></a>

确认日志记录开启，以帮助您确定失败原因。有关更多信息，请参阅[监控和日志记录](troubleshooting.md#troubleshooting-logging)。要开启 AWS 最终用户消息短信和语音 v2 API 的日志记录，请参阅[如何为亚马逊 Pinpoint 短信和语音 v2 API 设置亚马逊 Pinpoint 语音留言的日志](https://repost.aws/knowledge-center/pinpoint-voice-message-logging-setup-v2)记录？ 。

## 短信传输失败
<a name="troubleshooting-sms-delivery-failures"></a>

****问题和解决方案****
+ 使用 [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)，并确认将满足这些要求。

## 双向短信故障排除
<a name="troubleshooting-sms-two-way"></a>

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)。