WhatsApp エラー 133004: サーバーが一時的に利用できない状態

WhatsApp エラー 133004 は何を意味しますか？

サーバーが利用できなかったため、その時点ではプラットフォームがリクエストを処理できなかったことを意味します。

Meta は Cloud API のエラーリファレンスで 133004 を挙げ、details の説明文を「Server is temporarily unavailable.」としています。ポイントは「一時的」という点です。アクセストークンも電話番号もメッセージも拒否されているわけではなく、少し時間を置けば同じリクエストが成功することがあります。

このコードは 133 番台に含まれます。133 番台の多くは電話番号の登録と登録解除に関するもので、登録の呼び出し時によく見かけます。ただし Meta は登録時だけに限定していません。どこで表示されても、サーバー側の状態として扱ってください。

再試行の前に何を確認すべきですか？

確認するのは次の 2 点です。どちらも Meta 自身の対処方法に書かれています。

1 つ目は、metastatus.com にある WhatsApp Business Platform のステータスページです。Meta が障害を公表している間は、解消されるまで再試行しても意味がありません。自社のログを調べるより、このページのほうが早く答えが分かります。

2 つ目は、レスポンスの `error_data` に含まれる `details` の値です。Meta のエラーリファレンスでは、`details` はエラーの最も可能性の高い理由であり、対処方法が添えられることもあると説明されています。このコードについては、再試行の前に確認するよう Meta が明記しています。ステータスページに障害がなく、`details` にも待ち時間の指示がない場合は、すぐに再試行せず、間隔を徐々に延ばしながら再試行してください。

133004 は他の一時的なエラーとどう違いますか？

Meta は、一時的に利用できない状態を示すコードをいくつか挙げています。ログ上では区別しておくと便利です。

コード 1 は無効なリクエストまたはサーバーエラーの可能性、コード 2 はダウンタイムや過負荷による一時的な問題、131016 はサービスが一時的に利用できない状態と説明されています。133004 はサーバーを名指ししています。

どのコードでも対処はほぼ同じです。プラットフォームの状態を確認し、`details` の値を読み、間隔を空けてから再試行します。それでも正確なコードは記録してください。ある時間帯に同じコードが集中していれば、「API が止まっていた」という漠然としたメモよりも、Meta のサポートにはるかに有益な情報になります。

よくある間違い

• 短い間隔で即座に再試行を繰り返すこと。停止中のサーバーは、次のミリ秒も停止したままです。
• `details` の値を読み飛ばすこと。Meta は再試行の前に読むよう案内しており、理由が書かれている場合があります。
• 回避しようとしてリクエストの内容を変えること。エラーの原因はリクエストにはありません。

よくある質問

続きを読む