このドキュメントは、Alibaba Cloud の国際 SMS を使用する際に発生するエラーを迅速に特定、診断、解決するためのものです。初期の API 呼び出しから最終的な配信通知までのエラーコードを網羅し、各段階での実用的な解決策を提供します。
エラーコードの概要と分類
このドキュメントは長文です。特定のコードを検索するには、
Ctrl/Command+Fを使用してください。送信された各メッセージのエラーコードとその説明は、[配信履歴] ページで確認できます。
問題を特定するには、まず SMS 配信ライフサイクルのさまざまな段階で発生する可能性のあるエラーコードの種類を理解する必要があります。
共通エラーコード：これらのコードは、
SendMessageToGlobeなどの API オペレーションを呼び出すと、HTTP 応答ですぐに返されます。このタイプのエラーコードは、無効なパラメーターや不十分な権限など、リクエスト自体に問題があることを示します。また、プラットフォームがリクエストを受け付けなかったことを意味する場合もあります。配信通知状態コード：プラットフォームが SMS メッセージを受け付けた後、これらのコードは非同期の配信通知で返されるか、
SmsReportAPI オペレーションを呼び出すことで取得できます。このタイプの状態コードは、成功、失敗、または傍受など、キャリアからユーザーの電話へのメッセージの最終的な配信結果を示します。SMPP 配信通知エラーコード：これらのコードは、Short Message Peer-to-Peer (SMPP) プロトコルを使用する接続でのみ表示されます。これらは SMPP コマンドの実行結果またはメッセージの最終ステータスを示します。これらのコードは、SMPP 3.4 プロトコル仕様に厳密に従っています。
共通エラーコード
API エラーコード | 説明 | 解決策 |
OK | リクエストは成功しました。 | - |
INVALID_SENDERID | SenderID が無効か、承認されていません。 |
|
FORBIDDEN_ACTION | ユーザー API が機能低下しています。 | チケットを送信して、通常の API 呼び出し機能を復元してください。 |
OUT_OF_SERVICE | Short Message Service (SMS) がサービス停止中です。 | - |
ACCOUNT_NOT_EXISTS | アカウント情報が存在しません。 | SMS を有効化し、本人確認に合格していることを確認してください。 |
SMS_CONTENT_CODE_ILLEGAL | メッセージ本文が無効です。存在しないか、ブラックリストに登録されている可能性があります。 | SMS コンソールにログインします。左側のナビゲーションウィンドウで、 を選択します。承認ステータスを確認します。ステータスが「拒否」の場合は、新しいコンテンツを作成する をクリックします。 |
SMS_SIGN_NAME_ILLEGAL | 署名が無効です。存在しないか、ブラックリストに登録されている可能性があります。 | SMS コンソールにログインします。左側のナビゲーションウィンドウで、 を選択します。使用している署名名が承認されたものと同一であることを確認します。署名のステータスが「拒否」の場合は、理由を確認して新しい署名を申請してください。 |
MOBILE_NUMBER_ILLEGAL | 電話番号のフォーマットが正しくありません。 | 電話番号のフォーマットを確認して、再度送信してください。 |
MOBILE_COUNT_OVER_LIMIT | 電話番号の数が 1,000 を超えています。 | BatchSendMessageToGlobe API への 1 回のリクエストに含まれる電話番号の数は 1,000 を超えることはできません。リクエストをバッチで送信してください。 |
CONTENT_MISSING_PARAMETERS | テンプレート変数に値がありません。 |
|
INVALID_PARAMETERS | 入力パラメーターが無効です。 | パラメーターの構成を確認し、正しいことを確認してください。 |
INVALID_JSON_PARAM | パラメーターが空か、パラメーターの JSON 文字列の解析に失敗しました。 | パラメーターの構成を確認し、正しいことを確認してください。 |
PARAM_LENGTH_LIMIT | テンプレート変数の長さが制限されています。 |
|
AMOUNT_NOT_ENOUGH | アカウント残高またはリソースプランが不足しています。 | プリペイドパッケージを購入するか、アカウント残高にチャージしてください。 |
SYSTEM_ERROR | 内部システムエラーが発生しました。 | Alibaba Cloud プラットフォームで一時的なエラーが発生しました。しばらくしてからもう一度お試しください。問題が解決しない場合は、チケットを送信し、RequestId を提供してください。 |
DATA_NOT_EXIST | クエリされた SMS レコードが存在しません。 | しばらくしてからもう一度お試しください。 |
QPS_LIMIT_CONTROL | 秒間クエリ数 (QPS) のシステム制限に達しました。 | 単一ユーザーの QPS 制限に達しました。API 呼び出しの頻度に基づいて QPS を調整してください。 |
ONLINE_BILLING_FAILED | SMS のオンライン課金に失敗したか、内部システムエラーが発生しました。 | SMS のオンライン課金システムがビジー状態です。しばらくしてからもう一度お試しください。 |
QUERY_DATE_ILLEGAL | クエリ時間が無効です。 | パラメーターの構成を確認し、正しいことを確認してください。 |
RAM_PERMISSION_DENY | RAM 認証に失敗しました。ユーザーの権限が不十分です。 | RAM ユーザーに API を呼び出すための完全な権限を付与し、再度試してください。 |
PRODUCT_NOT_SUBSCRIBED | SMS が有効化されていません。 | SMS コンソールにログインし、SMS を有効化してください。 |
SMS_SECURITY_INTERCEPTED | メッセージは SMS のリスクコントロールポリシーによってブロックされました。 | - |
SMS_CONTENT_ILLEGAL | メッセージ本文が無効です。 | メッセージ本文が関連法規に準拠しているか確認してください。 |
ACCOUNT_ILLEGAL | アカウントは違法なコンテンツを送信したため、ブラックリストに登録されています。 | - |
BLACK_KEY_CONTROL_LIMIT | テンプレート変数にブラックリストに登録されたキーワードが含まれています。 | 変数の内容がプラットフォームのセキュリティポリシーをトリガーしました。変数内の機密情報や非準拠のコンテンツを確認し、修正してください。 |
NOT_SUPPORTED_COUNTRY | この国への SMS メッセージの送信はサポートされていません。 | - |
SENDERID_BLACKLISTED | SenderID はリスクコントロールポリシーによってブロックされました。 | - |
IMDA_COMPANY_REQUIRE_LOA | SenderID はシンガポール情報通信メディア開発庁 (IMDA) に登録する必要があります。 | 速やかに IMDA に登録してください。 |
SYSTEM_LIMIT_CONTROL | 1 日のシステム送信制限に達しました。 | - |
FREQUENCY_LIMIT_DAY | 1 つの電話番号に対する 1 日のメッセージ送信制限に達しました。 | コンソールで を選択して、1 つの電話番号に対する 1 日のメッセージ送信制限をリセットします。最大値は 20 です。 |
ALERT_LIMIT_DAY | ご利用のアカウントの 1 日のメッセージ送信制限に達しました。 | コンソールで を選択して、1 日のメッセージ総数をリセットします。 |
ALERT_LIMIT_MONTH | ご利用のアカウントの 1 か月のメッセージ送信制限に達しました。 | コンソールで を選択して、1 か月のメッセージ総数をリセットします。 |
COUNTRY_TRAFFIC_LIMIT | 宛先の国またはリージョンへの 1 日のメッセージ送信制限に達しました。 | コンソールで を選択して、宛先の 1 日のメッセージ総数をリセットします。 |
CONTENT_EXCEED_LIMIT | メッセージ本文がシステムの最大制限を超えています。 | メッセージ本文を調整してください。サイズは 512 KB に制限されています。 |
QUANTITY_INCONSISTENT | 電話番号の数 (To フィールド内) がメッセージの数 (Message フィールド内) と一致しません。 | 電話番号の数がメッセージの数と一致することを確認してください。 |
Specified AccessKeyId is not found | AccessKeyId が存在しません。 | コードに設定されている AccessKeyId が正しく、有効で、無効になっていないことを確認してください。 |
REJECTED_SENDERID_NOT_AVAILABLE | リクエストで定義された SenderID は、ご利用のアカウントに登録されていません。 |
|
LENGTH_LIMIT | コンテンツが長さの制限を超えています。 | メッセージ本文が長さの制限を超えています。コンテンツを 1,500 文字以下に短縮してください。 |
BILLING_DEDUCTION_ERROR | システムがアカウントからサービス料金を引き落とすのに失敗しました。 | システムがアカウントからサービス料金を引き落とすのに失敗しました。しばらくしてからもう一度お試しください。 |
配信レシートの状態コード
エラーコード | 説明 |
success | メッセージは正常に送信されました。 |
IN_SMS_CONTENT | メッセージ本文または長さが無効です。 |
INVALID_NUM | 受信者の電話番号が無効です。 |
INVALID_SENDERID | Sender ID が無効です。 |
OPERATOR_NOT_SUPPORT | キャリアがその電話番号をサポートしていません。 |
PHONE_NOT_AVAILABLE | 電話番号または携帯電話が利用できないか、電話のストレージがいっぱいです。 |
PORTED_NUM | 電話番号のキャリアが変更されました。 |
RECEIVER_BLACKLIST | 受信者の電話番号がブラックリストに登録されており、キャリアによってブロックされています。 |
SYSTEM_ERR | プロバイダー側でシステムエラーが発生しました。 |
SP_UNKNOWN_ERROR | メッセージの送信に失敗しました。 |
URL_FAILURE | URL がブラックリストに登録されています。 |
expired | 受信者の電話が長時間電源オフまたはサービスエリア外だったため、メッセージを送信できませんでした。 |
NO_VALID_SUPPLIER | シンガポール情報通信メディア開発庁 (IMDA) に準拠したサプライヤーが利用できません。 |
DELIVERED_TO_HANDSET | メッセージは受信者のモバイルデバイスに配信されました。 |
REJECTED_RAM_PERMISSION_DENY | RAM サブアカウントには、この操作を実行するために必要な権限がありません。メインアカウントの管理者に連絡して、必要な権限を付与してください。 |
REJECTED_PREPAID_PACKAGE_EXPIRED | プリペイドパッケージの有効期限が切れています。サービスを継続して使用するには、パッケージを更新するか、新しい SMS パッケージを購入してください。 |
REJECTED_ACCOUNT_NOT_EXISTS | モバイルアカウントが存在しないか、無効になっています。電話番号情報を確認してください。 |
UNDELIVERED_OPERATOR_REJECTED | キャリアがメッセージを拒否しました。考えられる理由には、番号のフォーマットが間違っている、番号が一時停止またはキャンセルされているなどがあります。電話番号の有効性を確認してください。 |
UNDELIVERED_NOT_DELIVERED | メッセージの配信に失敗しました。これは、ネットワークの問題または受信者のデバイスの問題が原因である可能性があります。しばらくしてからもう一度お試しください。 |
UNDELIVERED_INVALID_NUMBER | 電話番号が無効か、存在しません。番号のフォーマットを確認し、その有効性を確認してください。 |
SMS_FLOODING | 高い送信頻度が検出され、スパム対策機能がトリガーされました。短時間で多くのメッセージを送信しないように、送信頻度を減らしてください。 |
REJECTED_SYSTEM_ERROR | 内部システムエラーによりメッセージが失敗しました。しばらくしてからもう一度お試しください。問題が解決しない場合は、テクニカルサポートに連絡してください。 |
REJECTED_SENDERID_NOT_AVAILABLE | 送信者 ID が利用できないか、承認されていません。署名の構成を確認し、それが承認されており、宛先の国またはリージョンに適用可能であることを確認してください。 |
REJECTED_ROUTE_NOT_AVAILABLE | SMS ルートが一時的に利用できません。これは、宛先キャリアのネットワークの問題が原因である可能性があります。しばらくしてからもう一度試すか、テクニカルサポートに連絡してください。 |
REJECTED_NOT_ENOUGH_CREDITS | アカウントの残高が不足しているため、メッセージを送信できません。アカウントに資金を追加して、もう一度お試しください。 |
REJECTED_MOBILE_COUNT_OVER_LIMIT | 1 つの電話番号に送信されたメッセージの数が制限を超えました。1 つの番号に送信するメッセージの頻度を減らしてください。 |
REJECTED_ILLEGAL_CONTENT | メッセージ本文に違法または機密情報が含まれているため、システムによってブロックされました。現地の規制に準拠するようにコンテンツを修正し、再送信してください。 |
REJECTED_FORBIDDEN_ACTION | 現在のアクションは禁止されています。モバイルアカウントのステータスを確認するか、電話がメッセージを拒否したかどうかを確認してください。 |
REJECTED_FLOODING_CONTROL_AL | 高い送信頻度が検出され、スパム対策メカニズムがトリガーされました。短時間で多くのメッセージを送信しないように、送信頻度を減らしてください。 |
REJECTED_FLOODING_CONTROL | 高い送信頻度が検出され、スパム対策メカニズムがトリガーされました。短時間で多くのメッセージを送信しないように、送信頻度を減らしてください。 |
EXPIRED_EXPIRED | メッセージの有効期限が切れており、配信できませんでした。受信者の電話のステータスを確認し、メッセージを再送信してください。 |
EXPIRED_DLR_UNKOWN | メッセージの配信ステータスが確認できず、有効期限が切れている可能性があります。しばらくしてからもう一度お試しください。 |
DON'T DISTURB | 受信者は「おやすみモード」期間中です。「おやすみモード」期間が終了するまでメッセージは送信されません。 |
DELIVERED_TO_OPERATOR | メッセージはキャリアのネットワークに正常に送信されました。 |
DELIVERED | メッセージは正常に配信されました。 |
SMPP メッセージの状態
SMPP メッセージの状態 | 最終メッセージの状態 | 説明 |
DELIVERED | DELIVRD | メッセージは宛先に配信されました。 |
EXPIRED | EXPIRED | メッセージの有効期限が切れました。 |
DELETED | DELETED | メッセージは削除されました。 |
UNDELIVERABLE | UNDELIV | メッセージは配信不能です。 |
ACCEPTED | ACCEPTD | メッセージは受け付けられました。 |
UNKNOWN | UNKNOWN | メッセージの状態は不明です。 |
REJECTED | REJECTD | メッセージは拒否されました。 |
詳細については、「SMPP Protocol Specification V3.4」をご参照ください。