WhatsApp エラー 190: アクセストークンの期限切れ
エラー 190は、リクエストに使ったアクセストークンの期限切れ、または無効化を意味します。すべての呼び出しが同じように失敗するため、番号が消えたように見えます。しかし実際には認証情報の問題で、番号は通常そのままです。
期限切れまたは無効化されたアクセストークンを示す Meta のコードです。
認証失敗として報告される同じ状態を示す Meta のコードです。
EasyCoexistence は接続ごとに認証情報を保持するため、拒否の原因を診断できます。
期限切れのトークンが、なぜ番号を失ったように見えるのですか？
すべてのリクエストが同じように失敗するためです。
番号の読み取り、接続状態の確認、メッセージテンプレートの一覧表示、メッセージ送信が一度に停止します。外部から見ると、番号がアカウントから削除された状態と区別できません。認証情報を 1 つしか使わない連携では、2 つを見分ける方法もありません。そのため、実際には切断されていないのに、切断されたと判断する人が多くなります。
この違いは重要です。壊れた認証情報は交換できますが、削除された番号は再接続が必要で、企業の所有者と電話が必要になります。
違いをどう見分ければよいですか？
同じアカウントを読み取れる 2 つ目の認証情報を用意します。
EasyCoexistence は、各接続について顧客のトークンと独自の System User トークンを保持します。一方が拒否されたとき、もう一方で WhatsApp Business アカウントを読み取り、どちらが壊れたのかを判定できます。顧客のトークンが拒否されても、2 つ目の読み取りが成功すれば、期限切れは認証情報側で、番号は正常です。両方が失敗する場合は、番号自体に問題が起きています。
2 つ目の読み取り手段がなければ、区別するには企業の所有者に確認してもらうしかありません。これは、監視で避けるべき中断そのものです。
トークンはどのように無効化されますか？
いくつかの方法があり、その多くは意図的な操作ではありません。
トークンには有効期間があり、自動的に期限切れになります。Meta アカウントのパスワード変更でも無効化されます。誰かがビジネス設定でアプリのアクセス権を削除した場合や、Meta が侵害されたと判断してトークンを取り消した場合も同様です。これらは事前に警告されず、電話の WhatsApp Business アプリから確認することもできません。
そのため、トークンの有効性はエラーハンドラーではなく監視で確認すべきです。エラーハンドラーが検知する頃には、送信はすでに失敗しています。
よくある間違い
- トークンが問題なのに番号を再接続する。不要な作業を企業の所有者に求めることになります。
- 一時的な問題と考えて再試行する。無効化されたトークンは自然には復旧しません。
- 認証情報を 1 つだけ使う。認証情報の失敗と番号の喪失を区別できません。
EasyCoexistence は各接続に 2 つのトークンを保持するため、拒否された認証情報を推測ではなく診断できます。壊れたトークンを降格し、番号は削除しません。
よくある質問
番号はまだ使えますか？
通常は使えます。WhatsApp Business アプリには影響せず、番号自体も intact です。停止したのは API アクセスです。
エラー 0 も同じですか？
実質的には同じです。Meta はエンドポイントによって、この状態を 2 つのコードで報告します。
再接続すれば直りますか？
直りますが、軽い問題に対して企業の所有者と電話が必要になる大がかりな対応です。新しい認証情報だけで解決できます。
トークンを期限切れにしない方法はありますか？
System User トークンは長期間有効にできるため、2 つ目のトークンを保持する価値があります。
続きを読む
始める準備はできましたか？
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日