Coexistence 登録後に「This authorization code has expired」と表示される

どのコードが期限切れになったのですか？

企業が Embedded Signup を完了すると、Meta はアセット ID と交換用トークンコードを、ポップアップを開いたブラウザーのウィンドウに返します。プラットフォームはそのコードを自社のサーバーに送り、サーバーがアプリ ID とアプリシークレットを使って Meta の oauth access_token エンドポイントを呼び出し、ビジネストークンに交換します。

Meta の実装ガイドでは、タイミングが明確に定められています。交換用トークンコードの有効期間は 30 秒で、プラットフォームは期限が切れる前に交換できる状態にしておく必要があります。それを過ぎて交換しようとすると拒否され、その拒否が「This authorization code has expired」と表示されます。企業側がポップアップをゆっくり完了したことが原因ではありません。コードが返された時点から時間が数えられます。

ポップアップの完了が遅れたり、2 回実行したりすると、なぜ起きるのですか？

交換が制限時間を過ぎてしまう状況はいくつかあります。

フローの完了時にブラウザーのタブがバックグラウンドにあった、またはノート PC がスリープしていた場合、コードは発行からかなり経ってからプラットフォームのサーバーに届きます。プラットフォームのサーバーが、交換をすぐに行わず他の処理の後ろに回した場合もあります。また、利用者がフローを 2 回開いて両方を完了し、2 つ目の完了後に 1 つ目のウィンドウのコードを交換した場合にも起こります。

テスト中には 4 つ目の原因があります。ブラウザーのコンソールからコードをコピーし、cURL や Postman で手作業で交換するケースです。Meta のガイドはまさにこの点に注意を促しており、開始前に交換リクエストを準備しておくよう案内しています。

接続を完了するにはどうすればよいですか？

1 つのウィンドウでフローを最初からやり直し、プラットフォームのページを前面に表示したまま完了させてください。完了のたびに新しいコードが返されるので、プラットフォームはそれをすぐに交換すれば十分です。

Coexistence の番号の場合は、速やかに行ってください。企業がフローを完了した時点で、Meta は WhatsApp Business アカウントを変換します。プラットフォームが顧客のオンボーディングを行ってから、メッセージ履歴を同期できる時間は 24 時間です。それを過ぎると、企業をいったんオフボーディングし、フローを最初からやり直す必要があります。

プラットフォーム側の恒久的な対策は、コードが届いた瞬間に、他のオンボーディング手順より先にサーバーで交換することです。

よくある間違い

• 同じコードでトークンの交換を再試行すること。コードは 30 秒で期限切れとなり、元には戻りません。
• 2 つのウィンドウで同時にサインアップを実行すること。有効なのは、交換する試行で発行されたコードだけです。
• ブラウザーからコードを交換すること。Meta は、アプリシークレットを用いたサーバー間リクエストでの交換を求めています。

よくある質問

続きを読む