このトピックは、Alibaba Cloud Short Message Service (SMS) のエラーを迅速に特定、診断、解決するのに役立ちます。API 呼び出しやメッセージ配信から配信レシートまで、メッセージのライフサイクル全体のエラーコードを網羅しています。また、対応する実用的な解決策も提供します。
エラーコードの分類
このドキュメントは広範囲にわたります。特定のエラーコードを検索するには、Ctrl+F (または Command+F) を使用できます。
問題を正確に特定するには、メッセージのライフサイクル中に発生するさまざまなタイプのエラーコードを理解する必要があります。
共通エラーコード:
SendMessageToGlobeなどの API を呼び出すときに HTTP 応答で返されます。これらのコードは、リクエスト自体の問題 (たとえば、無効なパラメーターや権限不足) を示すか、プラットフォームがリクエストを拒否したことを示します。配信レシートステータスコード: プラットフォームがメッセージを受け入れた後、非同期コールバックを介して、または
SmsReportAPI を呼び出すことによって返されます。これらのコードは、成功、失敗、ブロックなど、キャリアから受信者のデバイスへの最終的な配信結果を反映します。SMPP エラーコードとメッセージステータス: Short Message Peer-to-Peer (SMPP) プロトコルを使用する場合にのみ利用可能です。これらは、SMPP Protocol Specification V3.4 に準拠して、SMPP コマンドの結果またはメッセージの最終ステータスを示します。
共通エラーコード
エラーコード | SMPP エラーコード | 説明 | 解決策 |
OK | 20 | リクエストは成功しました。 | - |
INVALID_SENDERID | 25 | 送信者 ID が無効か、承認されていません。 |
|
FORBIDDEN_ACTION | 26 | アカウントの API 呼び出し権限がスペックダウンされました。 | API 呼び出しアクセスを復元するためにチケットを送信します。 |
OUT_OF_SERVICE | 27 | SMS サービスは一時停止されています。 | - |
ACCOUNT_NOT_EXISTS | 29 | アカウントが存在しません。 | SMS をアクティブ化し、ID 認証を完了します。 |
SMS_CONTENT_CODE_ILLEGAL | 31 | メッセージテンプレートが無効であるか、存在しないか、拒否されています。 | SMS コンソールにログインします。左側のナビゲーションウィンドウで、 を選択します。承認ステータスを確認します。ステータスが [拒否済み] の場合は、[テンプレートの作成] をクリックします。 |
SMS_SIGN_NAME_ILLEGAL | 32 | 署名が無効であるか、存在しないか、拒否されています。 | SMS コンソールにログインします。左側のナビゲーションウィンドウで、 を選択します。渡された署名が承認されたものと完全に一致するかどうかを確認します。ステータスが [拒否済み] の場合は、理由を確認して新しい署名を申請してください。 |
MOBILE_NUMBER_ILLEGAL | 33 | 携帯電話番号のフォーマットが正しくありません。 | 電話番号のフォーマットを確認し、リクエストを再送信します。 |
MOBILE_COUNT_OVER_LIMIT | 34 | 携帯電話番号の数が上限の 1,000 を超えています。 | BatchSendMessageToGlobe 操作は、リクエストごとに最大 1,000 の受信者をサポートします。より大きなリストは複数のリクエストに分割してください。 |
CONTENT_MISSING_PARAMETERS | 35 | メッセージテンプレートの変数に値がありません。 |
|
INVALID_PARAMETERS | 36 | 1 つ以上のパラメーターが無効です。 | パラメーター構成をチェックして、すべての値が正しいことを確認してください。 |
INVALID_JSON_PARAM | 42 | パラメーターが空であるか、JSON 文字列を解析できませんでした。 | パラメーター構成をチェックして、すべての値が正しいことを確認してください。 |
PARAM_LENGTH_LIMIT | 44 | テンプレート変数値の長さが上限を超えています。 |
|
AMOUNT_NOT_ENOUGH | 45 | アカウントの残高またはリソースパッケージが不足しています。 | リソースプランを購入するか、残高を補充してください。 |
SYSTEM_ERROR | 46 | 内部システムエラーが発生しました。 | Alibaba Cloud プラットフォームで一時的なエラーが発生しました。後でもう一度お試しください。問題が解決しない場合は、チケットを送信し、RequestId を提供してください。 |
DATA_NOT_EXIST | - | クエリされたメッセージレコードが存在しません。 | 後でもう一度お試しください。 |
QPS_LIMIT_CONTROL | 48 | メッセージ送信の QPS 上限に達しました。 | アカウントの QPS 上限内に収まるように、API 呼び出しの頻度を減らしてください。 |
ONLINE_BILLING_FAILED | 49 | オンライン課金に失敗したか、内部システムエラーが発生しました。 | オンライン課金システムがビジー状態です。後でもう一度お試しください。 |
QUERY_DATE_ILLEGAL | 52 | クエリの時間範囲が無効です。 | パラメーター構成をチェックして、すべての値が正しいことを確認してください。 |
RAM_PERMISSION_DENY | 55 | 権限が不十分なため、Resource Access Management (RAM) の検証に失敗しました。 | RAM ユーザーに API を呼び出すために必要な権限を付与し、再試行してください。 |
PRODUCT_NOT_SUBSCRIBED | 57 | SMS がアクティブ化されていません。 | SMS コンソールにログインし、サービスをアクティブ化してください。 |
SMS_SECURITY_INTERCEPTED | 61 | メッセージはリスク管理ポリシーによってブロックされました。 | - |
SMS_CONTENT_ILLEGAL | 62 | メッセージの内容が非準拠です。 | メッセージの内容が、適用されるすべての法律および規制に準拠していることを確認してください。 |
ACCOUNT_ILLEGAL | 63 | 非準拠のコンテンツを送信したため、アカウントがブラックリストに登録されました。 | - |
BLACK_KEY_CONTROL_LIMIT | 64 | メッセージコンテンツの変数にブラックリストに登録されたキーワードが含まれています。 | 変数の値がプラットフォームのセキュリティポリシーをトリガーしました。変数内の機密性の高い、または非準拠のコンテンツを確認し、変更してください。 |
NOT_SUPPORTED_COUNTRY | 65 | この国またはリージョンへのメッセージの送信はサポートされていません。 | - |
SENDERID_BLACKLISTED | 67 | リスク管理ポリシーが送信者 ID をブロックしました。 | - |
IMDA_COMPANY_REQUIRE_LOA | 68 | 送信者 ID は、Infocomm Media Development Authority (IMDA) に登録する必要があります。 | IMDA に送信者 ID を登録してください。 |
SYSTEM_LIMIT_CONTROL | 81 | システムの 1 日あたりの送信上限に達しました。 | - |
FREQUENCY_LIMIT_DAY | 83 | 1 つの番号に対する 1 日あたりの送信上限に達しました。 | コンソールで、 に移動し、1 つの番号に対する 1 日あたりの送信上限をリセットします。デフォルトの上限: 1 日あたり 20 メッセージ。 |
ALERT_LIMIT_DAY | 84 | アカウントの 1 日あたりの送信上限に達しました。 | コンソールで、 に移動し、1 日あたりの上限をリセットします。 |
ALERT_LIMIT_MONTH | 85 | アカウントの月間送信上限に達しました。 | コンソールで、 に移動し、月間上限をリセットします。 |
COUNTRY_TRAFFIC_LIMIT | 86 | 特定の宛先の国またはリージョンに対する 1 日あたりの送信上限に達しました。 | コンソールで、 に移動し、その宛先の 1 日あたりの送信上限をリセットします。 |
CONTENT_EXCEED_LIMIT | - | メッセージコンテンツが 512 KB のサイズ上限を超えています。 | メッセージサイズを 512 KB の上限内に収めてください。 |
QUANTITY_INCONSISTENT | - | 受信者の数 ( | 受信者の数とメッセージの数が一致していることを確認してください。 |
Specified AccessKeyId is not found | - | 指定された AccessKeyId が存在しません。 | コードに構成されている AccessKeyId が正しく、有効で、無効になっていないことを確認してください。 |
配信レシートステータスコード
ステータスコード | SMPP エラーコード | 説明 |
success | 0 | メッセージは正常に送信されました。 |
IN_SMS_CONTENT | 201 | メッセージの内容または長さが無効です。 |
INVALID_NUM | 202 | 受信者の電話番号が無効です。 |
INVALID_SENDERID | 203 | 送信者 ID が無効です。 |
OPERATOR_NOT_SUPPORT | 204 | キャリアが電話番号をサポートしていません。 |
PHONE_NOT_AVAILABLE | 205 | 電話番号または受信者のデバイスが利用できないか、デバイスのストレージがいっぱいです。 |
PORTED_NUM | 206 | 電話番号のキャリアが変更されました。 |
RECEIVER_BLACKLIST | 207 | 受信者の番号はキャリアのブラックリストに登録されています。 |
SYSTEM_ERR | 208 | キャリアのシステムエラーが発生しました。 |
SP_UNKNOWN_ERR | 209 | 不明な理由でメッセージの配信に失敗しました。 |
URL_FAILURE | 210 | メッセージコンテンツ内の URL がブラックリストに登録されています。 |
expired | 211 | 受信者のデバイスが長期間電源オフまたはサービスエリア外であったため、メッセージを配信できませんでした。 |
NO_VALID_SUPPLIER | 212 | シンガポールで利用可能な IMDA 準拠のキャリアがありません。 |
SMPP メッセージステータス
SMPP メッセージステータス | 最終メッセージステータス | 説明 |
DELIVERED | DELIVRD | メッセージは宛先に配信されました。 |
EXPIRED | EXPIRED | メッセージの有効期間が切れました。 |
DELETED | DELETED | メッセージは削除されました。 |
UNDELIVERABLE | UNDELIV | メッセージは配信不能です。 |
ACCEPTED | ACCEPTD | メッセージは受理状態です。 |
UNKNOWN | UNKNOWN | メッセージは無効な状態です。 |
REJECTED | REJECTD | メッセージは拒否状態です。 |
詳細については、「SMPP Protocol Specification V3.4」をご参照ください。