本トピックでは、Alibaba Cloud Short Message Service (SMS) のエラーを迅速に特定、診断、および解決する方法について説明します。API 呼び出し、メッセージ配信、配信レシートに至るまで、メッセージのライフサイクル全体にわたるエラーコードをカバーしています。また、各エラーに対応する具体的な対応策も提供します。
エラーコードの分類
本ドキュメントは大規模です。特定のエラーコードを検索するには、Ctrl+F(Windows)または Command+F(macOS)をご利用ください。
問題を正確に特定するには、メッセージのライフサイクル中に発生するさまざまなタイプのエラーコードを理解する必要があります。
共通エラーコード:
SendMessageToGlobeなどの API を呼び出した際の HTTP 応答として返されます。これらのコードは、リクエスト自体の問題(例:無効なパラメーター、権限不足)や、プラットフォームによるリクエスト拒否を示します。配信レシートのステータスコード: プラットフォームがメッセージを受け入れた後に、非同期コールバックまたは
SmsReportAPI の呼び出しによって返されます。これらのコードは、キャリアから受信者端末への最終的な配信結果(例:成功、失敗、ブロック)を反映します。SMPP エラーコードおよびメッセージ状態: Short Message Peer-to-Peer (SMPP) プロトコルを使用する場合にのみ利用可能です。SMPP コマンドの実行結果またはメッセージの最終ステータスを、SMPP Protocol Specification V3.4 に準拠して示します。
共通エラーコード
エラーコード | SMPP エラーコード | 説明 | ソリューション |
OK | 20 | リクエストは正常に完了しました。 | - |
INVALID_SENDERID | 25 | 送信者 ID が無効または未承認です。 |
|
FORBIDDEN_ACTION | 26 | アカウントの API 呼び出し権限がスペックダウンされています。 | API 呼び出しアクセスの復元を依頼するため、チケットを送信してください。 |
OUT_OF_SERVICE | 27 | SMS サービスが一時停止されています。 | - |
ACCOUNT_NOT_EXISTS | 29 | アカウントが存在しません。 | SMS の有効化および本人確認を完了してください。 |
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 回のリクエストにつき最大 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 制限に達しました。 | API 呼び出し頻度を減らし、アカウントの QPS 制限内に収まるようにしてください。 |
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) に登録する必要があります。 | 送信者 ID を IMDA に登録してください。 |
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 | アカウントの 1 ヶ月あたりの送信上限に達しました。 | コンソールで、 へ移動し、1 ヶ月あたりの上限をリセットしてください。 |
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」をご参照ください。