WhatsApp エラー 0:アプリユーザーを認証できません
エラーコード 0 は、Meta がアクセストークンの背後にあるアプリユーザーを認証できなかったことを意味します。Meta の説明は「We were unable to authenticate the app user.」です。トークンの有効期限切れ、トークンの無効化、またはユーザーがすべてのアプリによるデータへのアクセスをブロックしたことが原因です。対処法は再試行ではなく、新しいアクセストークンの取得です。
「We were unable to authenticate the app user.」に対応する Meta のエラーコードです。
トークンの期限切れ、トークンの無効化、またはユーザーがすべてのアプリをブロックする設定に変更したことが原因です。
期限切れのアクセストークンについては、Meta が別のエラーコードを用意しています。
WhatsApp のエラーコード 0 は何を意味しますか?
プラットフォームがリクエストを受け取ったものの、信頼できるアプリユーザーと結び付けられなかったことを意味します。
Meta は Cloud API のエラーリファレンスで、コード 0 を認可エラーに分類しており、詳細テキストは「We were unable to authenticate the app user.」です。挙げられている原因はすべてトークンに関するものです。トークンの有効期限が切れた、トークンが無効化された、またはトークンを許可した本人がすべてのアプリによるデータへのアクセスを禁止する設定に変更した、のいずれかです。
この一覧に、電話番号、WhatsApp Business アカウント、送信中のメッセージに関する項目はありません。リクエストはそれらを確認する段階まで進んでいないということです。
エラー 0 はどう直しますか?
新しいアクセストークンを取得してください。これは Meta が示している対処法であり、有効な方法はこれだけです。
ただし、交換する前に 3 つの原因のどれに当たるかを突き止めてください。原因を放置すると、同じエラーが再発するためです。有効期間の短いユーザートークンは、期限が来ればまた切れます。無効化されたトークンは、誰かが改めてアクセスを許可するまで失敗し続けます。アプリのアクセスを完全にオフにしたユーザーの場合は、まずそれをオンに戻さない限り、そのユーザーのどのトークンも使えません。
サーバー間の送信では、Meta のアクセストークンガイドが System User トークンを推奨しています。長期間有効で、ユーザー操作を必要としない自動化サービスに向いていると説明されています。
エラー 0 とエラー 190 は同じですか?
実際には重なる部分がありますが、Meta は別のコードとして掲載しています。
エラー 190 の詳細テキストは「Your access token has expired.」です。エラー 0 はより広い範囲を指し、期限切れのトークン、無効化されたトークン、アプリのアクセスを完全にブロックしたユーザーを含みます。どちらも同じ認可エラーの表に載っており、どちらも新しいトークンの取得で対処します。
実務上の違いは原因の切り分けです。190 ならトークンが期限切れになったと分かります。0 は認証に失敗したことしか分からず、理由は自分で調べる必要があります。調べずに交換すると、1 時間後にまったく同じ理由で失敗する可能性があります。
よくある間違い
- 同じリクエストを再試行すること。認証されていないトークンは認証されないままなので、再試行のたびにコード 0 が返ります。
- 番号を再接続すること。番号はそもそも確認されていないため、オンボーディングをやり直しても企業の担当者に余計な作業を頼むだけで、何も変わりません。
- バックエンドのジョブに、有効期間の短いユーザートークンを新しく発行すること。期限が来ればまた切れて、エラーが再発します。
EasyCoexistence は接続ごとに 2 つ目のトークンを保持しています。一方の認証情報が拒否されても、もう一方でアカウントを読み取り、番号自体に問題がないかを確認できます。
よくある質問
エラー 0 は番号の接続が切れたという意味ですか?
いいえ。Meta がコード 0 の原因として挙げているのは、すべてアクセストークンに関するものです。番号や、スマートフォン上の WhatsApp Business アプリは関係ありません。
エラー 0 はどこに記載されていますか?
Meta の Cloud API エラーコードのリファレンスにある、認可エラーの表に記載されています。Cloud API は Graph API を基盤としており、同じエラー形式を使います。
待てばエラー 0 は解消しますか?
いいえ。期限切れや無効化されたトークンが自然に回復することはありません。新しいトークンが必要です。
トークンで何ができるかを確認するには?
Meta のアクセストークンデバッガーか、debug_token エンドポイントを使ってください。どちらも、トークンが有効かどうか、有効期限、付与されている権限を確認できます。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日