Amazon SNS または AWS End User Messaging 経由の SMS から「Unknown error attempting to reach phone」エラーが返される場合の解決方法を教えてください。

所要時間2分

モバイルテキストメッセージ (SMS メッセージ) が Amazon Simple Notification Service (Amazon SNS) または AWS End User Messaging 経由で配信されません。SMS メッセージに関する Amazon CloudWatch ログには、「Unknown error attempting to reach phone (電話へのアクセス時に不明なエラーが発生しました)」というエラーが表示されています。

簡単な説明

複数の要因で、SMS メッセージに関する CloudWatch Logs に「Unknown error attempting to reach phone」というエラーが表示される可能性があります。SMS メッセージに関する CloudWatch ログを有効にして確認する方法については、「CloudWatch ログを確認する」を参照してください。

他の種類の SMS エラーメッセージのトラブルシューティングについても、「Amazon SNS でのモバイルテキストメッセージ (SMS) に関する障害をトラブルシューティングする方法を教えてください」を参照してください。

重要: 仕様では、SMS アーキテクチャは分散型です。SMS メッセージ転送の信頼性とパフォーマンスについて、アプリケーションが推定を行わないようにすることをおすすめします。詳細については、インターネットエンジニアリングタスクフォース (IETF) の RFC 5724 を参照してください。

解決策

一般的な問題が起こっていないか確認する

次の条件に起因する問題が発生していないかどうかを確認します。

その電話番号は通信事業者によってスパムとしてブロックされている。
送信先がブロックされている。
メッセージ本文が無効である。
その電話番号は着信拒否 (Do Not Disturb、「DND」) リストに登録されている。
その電話がローミングネットワークに属している。
通信事業者によりメッセージがブロックされた。
電話により SMS がブロックされた。
電話が一時的に対応エリア外に位置している。
電話がオフになっています。
電話が携帯電話番号ではなく、固定電話番号である。
メッセージ本文に未登録の URL が含まれている。
その携帯電話番号は無効である。
ダウンストリームパートナーの所定の番号または地域番号セットのネットワーク設定が正しくありません。

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

SMS メッセージを送信する送信先の国または AWS リージョンにおける、SMS のベストプラクティス、ルール、および規制に従っていることを確認します。

正しい発信元 ID を使用していることを確認します。必要な場合は、ID を登録してください。詳細については、「AWS End User Messaging SMS による SMS メッセージがサポートされている国と地域」を参照してください。

SMS メッセージを米国に送信する場合は、米国でサポートされている発信番号を使用していることを確認してください。

米国でフリーダイヤル番号を使用する場合は、その電話番号が登録されていることを確認してください。

ローカルルート経由でインドに SMS メッセージを送信する場合は、登録プロセスの完了後にエンティティ ID とテンプレート ID の値を指定します。指定するテンプレート ID がメッセージテンプレートと完全に一致することを確認してください。

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

デバイスレベルの SMS ブロック、ローミング、カバレッジギャップなどの要因で、単一デバイスの配信に関する問題が発生する可能性があります。

次の手順を実行します。

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

両方の手順で正常に配信できた場合は、他のデバイスでテストします。

問題が解決しない場合、デバイスの所有者は通信事業者に問い合わせ、サポートを受ける必要があります。

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

SMS 配信の遅延が複数のデバイスで発生する場合、下流のアグリゲーター、サプライヤー、プロバイダーや通信事業者に問題がある可能性があります。

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

サポートケースには以下の情報を提供してください。

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

注: 携帯電話の通信事業者は、SMS の情報を 3 日を超えて保存しない場合があります。

重要: CloudWatch Logs からの SMS 配信では、正確な SMS 配信時間を取得できない可能性があります。CloudWatch Logs を受信する前に SMS メッセージが配信される場合があります。配信ログの dwellTimeMsUntilDeviceAck 値は、通信事業者がメッセージを受信したタイミングを示しますが、SMS メッセージの遅延に関する情報は提供しません。詳細については、「CloudWatch ログを確認する」を参照してください。