「既存の WhatsApp Business アプリを接続する」オプションが表示されない

オプションを表示するかどうかは誰が決めますか？

ポップアップを起動するプラットフォームです。Meta のドキュメントでは、パートナーが Embedded Signup を起動する際に、whatsapp_business_app_onboarding を設定した featureType プロパティを追加するよう案内しています。確認方法も示されています。アカウント選択画面が、既存の WhatsApp Business アカウントの接続を提案する画面に置き換わっていれば、機能は有効です。

つまり、企業側に WhatsApp Business アカウントの選択や作成、登録する電話番号の入力といった通常の画面が表示された場合、ポップアップはその設定なしで起動されています。企業自身の Meta 設定を変更しても、これは変わりません。企業にできるのは、この機能を有効にしているプラットフォームのサインアップリンクに切り替えることだけです。

プラットフォームが対応していないのはなぜですか？

Meta は、有効化の前にプラットフォーム側が満たすべき要件を定めています。プラットフォームはすでに Solution Partner または Tech Provider であること、Cloud API の使い方を理解していること、Webhook を受信して処理できるコールバックを持っていること、そしてセッションログを有効にして Embedded Signup を実行していることが必要です。

セルフホストのツールや、Tech Provider ではない開発者アプリで構築した連携は、最初の要件を満たせません。その場合、企業側の設定変更でオプションを復活させることはできません。解決策は、この対応を済ませているプラットフォームを使うことです。

もう一つの原因はバージョンです。Embedded Signup v2 と v3 は 2026 年 10 月 15 日に廃止されます。Meta はパートナーに、それまでに v4 へ移行するよう案内しています。

オプションは表示されるのにアカウントを選べない場合は？

それは別の拒否で、原因はプラットフォームではなくアカウント側にあります。

Meta のエラーリファレンスには 3441047 が載っています。マーケティングメッセージを使用しているアカウントでは機能が利用できず、企業は別の WhatsApp Business アカウントを選択する必要があります。コード 3441042 は、その地域の電話番号では機能が利用できないことを意味します。また、バージョン 2.24.17 未満のアプリは、最新バージョンへの更新を求められて拒否されます。

これらはそれぞれ、ポップアップ内に専用のメッセージが表示されます。メッセージがまったくないままオプションが表示されない場合は、フローの起動方法に原因があります。

よくある間違い

• 企業の Meta 設定で Coexistence のスイッチを探し続けること。このオプションは、ポップアップを起動する側が設定します。
• オプションがないまま通常のフローを完了すること。Meta は電話番号を新規登録として扱うため、Coexistence にはなりません。
• 古い Embedded Signup 連携でも対象になると思い込むこと。Meta は v2 と v3 を 2026 年 10 月 15 日に廃止します。

よくある質問

続きを読む