Meta Tech Provider

WhatsApp Business アプリで Coexistence の QR コードのスキャンに失敗する

Coexistence の登録中にコードのスキャンが失敗する場合、確認すべき原因は電話側にあります。WhatsApp Business アプリが古い、別のアプリや端末でスキャンした、スキャン後に表示される案内に応答していない、のいずれかです。対処法は、アプリを更新し、番号を持つ電話の WhatsApp Business アプリでスキャンして、すべての案内を最後まで完了することです。

2.24.17

Meta がこのオンボーディングに求める WhatsApp Business アプリの最小バージョンです。

4563015

WhatsApp Business アプリを最新バージョンに更新するようユーザーに求める Meta のコードです。

PHONE_NUMBER_VERIFICATION

電話での認証画面でフローを中断したときに Meta が報告するステップです。

4 companions

Business アプリのアカウントにリンクできる端末です。番号を API に接続すると、すべてのリンクが解除されます。

電話側では何が起きるはずですか？

Meta のドキュメントでは、電話側の手順を次の 4 つで説明しています。まず、WhatsApp Business アプリ内で公式の Facebook ビジネスアカウントからメッセージが届き、企業側が「接続」をタップします。次に、ビジネスプラットフォームへの接続をタップします。続いて「確認」をタップし、ここでチャット履歴を共有するかどうかを選びます。最後に認証コードの手順を完了し、ブラウザに戻ってフローを終えます。

ブラウザに表示されるコードは、アプリ内でのこのやり取りを始めるためのものです。そのため、スキャンしても何も起きない場合や、スキャンした瞬間に電話にエラーが出る場合は、これらの手順のどれかを開始できなかったことを意味します。それより前のブラウザ側の手順は、すでに正常に完了しています。

なぜスキャンに失敗するのですか？

確認すべき原因は 4 つあります。次の順に見てください。

アプリが古い場合です。Meta は WhatsApp Business アプリのバージョン 2.24.17 以降を求めています。また、Embedded Signup にはアプリを最新バージョンに更新するよう伝えるだけのエラー 4563015 があります。

別のアプリでスキャンした場合です。コードは、メインの電話で番号を持つ WhatsApp Business アプリで処理する必要があります。一般向けの WhatsApp、電話のカメラアプリ、WhatsApp Web や WhatsApp Desktop などのリンク済み端末では処理できません。

案内を完了していない場合です。スキャンは手順を開くだけです。「接続」、ビジネスプラットフォームへの接続、「確認」を順にタップして初めて先に進みます。

ポップアップを閉じた場合です。ブラウザのウィンドウがなくなると、電話側で進めていたフローも一緒に失われます。

きれいにやり直すにはどうすればよいですか？

まずアプリストアで WhatsApp Business アプリを更新し、開き直してください。手元の電話が番号を持つ端末であること、ロックが解除されていてオンラインであることを確認します。

次に、ブラウザで登録フローを最初からやり直し、既存の WhatsApp Business アプリのアカウントを接続するオプションを選びます。電話で作業している間は、ポップアップを開いたままにしてください。コードは WhatsApp Business アプリの中で処理し、表示される案内に一つずつ応答して、ブラウザに戻って完了させます。

接続が完了すると、リンク済み端末はログアウトされます。Meta は番号が API に接続された時点ですべてのコンパニオンアプリのリンクを解除しますが、あとで再度リンクできます。

よくある間違い

電話のカメラアプリでスキャンすること。コードは番号を持つ WhatsApp Business アプリで処理する必要があります。
電話で作業中にブラウザのポップアップを閉じること。電話側の手順は、それを開始したフローがないと進みません。
リンク済み端末のログアウトを失敗とみなすこと。Meta は接続時にコンパニオンアプリのリンクを解除しますが、再度リンクできます。

EasyCoexistence で実現する

EasyCoexistence は Meta の Embedded Signup を実行し、試行がどこで止まったかを記録します。電話側の手順で失敗しても、理由の分からないままポップアップが閉じるのではなく、接続のタイムラインに表示されます。

よくある質問

企業の代わりに別の人がスキャンできますか？

番号を持つ電話であれば可能です。この手順は、その端末の WhatsApp Business アプリで行います。

WhatsApp Web でスキャンできますか？

できません。リンク済み端末はアカウントのコンパニオンです。電話側の手順は、メインの電話の WhatsApp Business アプリで行うものです。

スキャンに失敗すると電話の状態は変わりますか？

変わりません。フローが完了するまで番号は接続されず、アプリはこれまでどおり使えます。

アプリは最新と表示されます。次はどうすればよいですか？

バージョン番号が 2.24.17 以降であることを確認し、フローを最初からやり直して、すべての案内を完了してください。

続きを読む

"Update your WhatsApp Business App" during Coexistence signupMeta refuses Coexistence when the WhatsApp Business app is below the minimum version. The version required, how to check it, and how to retry after updating."This authorization code has expired" after Coexistence signupWhy a platform reports that the authorization code has expired after Meta's signup popup finishes, the 30 second limit behind it, and how to complete the connection."Your app is missing required Graph API permissions for Cloud API companion pairing"What the companion pairing permissions error means in Coexistence signup, which WhatsApp permissions need Advanced access, and why the platform has to fix it.Connecting a number, step by stepWhat happens when you connect a number through Coexistence, what the business owner has to do, and what is decided once and cannot be changed.What changes in the WhatsApp Business app after connectingEverything that stays the same on the phone after a number is connected through Coexistence, and the three things that genuinely change.

始める準備はできましたか？

WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。

無料トライアルを始める

確認日 2026-10-11