Amazon SNS での SMS 送信時における「電話への接続試行中に不明なエラーが発生しました」というエラーや、Pinpoint での「不明」エラーを解決するにはどうすればよいですか?

簡単な説明

SMS メッセージは、サードパーティーのダウンストリームアグリゲータ、SMS サプライヤー、およびモバイル通信事業者を介してモバイルデバイスに配信されます。つまり、Amazon SNS、Amazon Pinpoint、または Amazon SNS か Amazon Pinpoint のいずれかと統合した 任意の AWS サービスを用いて SMS を使用する場合です。これらのダウンストリームパートナーがモバイルデバイスに接続できない場合は、「電話への接続試行中に不明なエラーが発生しました」というエラーが表示されます。
**重要:**SMS アーキテクチャは設計によって配信されます。アプリケーションの SMS メッセージ転送の信頼性とパフォーマンスについての前提条件を作らないことがベストプラクティスです。詳細については、インターネットエンジニアリングタスクフォース (IETF) の RFC 5724 を参照してください。

解決策

ユースケースに応じて以下のトラブルシューティング手順に従います。

一般的な問題を確認する

Amazon SNS や Amazon Pinpoint に関連しない一般的な問題を除外します。
次のような理由で、そのエラーを受け取ることがあります。

• 電話番号は通信事業者によってスパムとしてブロックされています。
• 送信先がブロックされています。
• メッセージ本文が無効です。
• 電話番号が「おやすみモード」リストにあります。
• 電話がローミングネットワーク内にあります。
• 電話の通信事業者がメッセージをブロックしています。
• 電話が SMS をブロックしています。
• 電話が一時的に対応範囲外になっています。
• 電話がオフになっています。
• 電話が固定電話番号です (携帯電話ではない)。
• メッセージ本文に未登録の URL があります。
• 携帯電話番号は無効です。
• ダウンストリームパートナーの所定の番号または地域番号セットのネットワーク設定が正しくありません。

SMS のベストプラクティスを確認する

SMS メッセージを送信する送信先の国または AWS リージョンの SMS のベストプラクティス、ルール、および規制に従っていることを確認します。
正しい発信 ID を使用していることを確認します。必要に応じて、ID を登録する必要があります。詳細については、「サポートされている国とリージョン (SMS チャネル)」を参照してください。
SMS メッセージを米国に送信する場合は、米国でサポートされている発信番号を使用していることを確認してください。
米国への通話料無料番号を使用する場合は、電話番号が登録されていることを確認してください。
ローカルルートを使用してインドに SMS メッセージを送信する場合は、最初に専用の英字の送信者 ID を事前登録してください。次に、DLT 登録済みテンプレートを使用します。SMS メッセージにコンテンツを追加する場合は、DLT 登録済みテンプレートのコンテンツと正確に一致することを確認してください。詳細については、「インドの送信者 ID 登録要件」を参照してください。

単一デバイスの配信に関する問題のトラブルシューティング

デバイスレベルの SMS ブロック、ローミング、カバレッジギャップなどの要因により、単一デバイスの配信の問題が発生する可能性があります。
これらの問題をトラブルシューティングするには

1. Amazon Pinpoint API を使用して電話番号を検証します。固定電話および VoIP 電話番号を使用すると、配信の問題が発生する可能性があります。
2. 別のデバイスから SMS メッセージを送信し、メッセージが配信されたかどうかを確認します。

上記の両方の手順が成功した場合は、他のデバイスでテストすることを検討してください。
問題が解決しない場合、デバイスの所有者は通信事業者に連絡してサポートを受ける必要があります。

複数のデバイス配信に関する問題のトラブルシューティング

SMS 配信の遅延が複数のデバイスに影響を与える場合、ダウンストリームアグリゲータ、サプライヤー、および通信事業者に問題がある可能性があります

潜在的なダウンストリームの問題をトラブルシューティングするには、SMS メッセージの送信に使用しているサービスのサポートケースを作成します。
サポートケースには以下の情報を提供します。

• SMS メッセージの送信に使用しているリージョン
• 問題が発生した時点のタイムスタンプ
• 3 日以内に異なる電話番号に送信されエラーとなった SMS メッセージのメッセージ ID を含む SMS ログの 3 件のサンプル
• (インドのみ) DLT に登録したエンティティ ID、テンプレート ID、および SMS メッセージの送信に使用されるコンテンツのサンプルを提供

注: 携帯電話の通信事業者は、SMS 情報を 3 日を超えて保存しない場合があります。
重要: Amazon CloudWatch Logs からの SMS 配信は、必ずしも正確な SMS 配信時間を提供するとは限りません。場合によっては、CloudWatch ログが受信される前に SMS メッセージが配信されることがあります。配信ログの dwellTimeMsUntilDeviceAck 値は、通信事業者がいつメッセージを受け付けたかを示しますが、遅れた SMS メッセージに関する情報は提供しません。詳細については、「SMS 配信用の CloudWatch のメトリクスおよびログを表示する」を参照してください。

関連情報

Amazon Pinpoint を使用して SMS のグローバル送信を管理する方法
CloudWatch を使った Amazon SNSのトピックのモニタリング