Meta が 14 日後に切断した番号を再接続 (PRIMARY_INACTIVITY)
プライマリ端末の WhatsApp Business アプリが約 14 日間開かれないと、Meta は Coexistence 番号の Cloud API 側を終了し、理由として PRIMARY_INACTIVITY を報告します。再接続するには、その端末でアプリを開いて同期させ、同じ番号で Embedded Signup フローを再度実行してください。アプリ、そのチャット、番号自体は影響を受けません。
easyCoexistence は、Meta が切断を報告した瞬間にオーナーへメールを送り、番号のページには理由を表示します。
PRIMARY_INACTIVITY の切断理由の原因となるプライマリ端末の非アクティブ状態。
PRIMARY_INACTIVITY の場合の Meta の PARTNER_REMOVED ペイロード例における initiated_by の値。人ではなくプラットフォームが終了させたことを示す。
事業者がオフボーディング後に同じパートナーへ再オンボーディングした際に Meta が送信する account_update イベント。
連絡先とチャット履歴を同期するための、オンボーディング後の期間。オンボーディングごとに 1 回利用できます。
ダッシュボードがプライマリ端末でアプリを開くよう案内する頻度。Meta のルールよりも短い間隔で、余裕を持たせています。
PRIMARY_INACTIVITY とは何を意味しますか?
これは、プライマリ端末が活動しなくなったために Meta が Coexistence 番号から API を削除する際に示す理由です。Meta は PARTNER_REMOVED イベントを含む account_update Webhook を送信し、disconnection_info の中で理由が PRIMARY_INACTIVITY と表示されます。Meta のドキュメントでは、プライマリ端末が約 14 日間非アクティブであることを意味します。Meta の例のペイロードでは、initiated_by は SYSTEM です。
プライマリ端末とは、WhatsApp Business アプリで番号を保持している電話機のことです。その端末上では何も変わりません。顧客はメッセージを送り続け、チームは返信を続け、チャットはそのまま残ります。止まるのは API 側のすべてです。Cloud API 経由の送信は失敗し、Webhook は届かなくなり、再接続されるまで、その番号の自動化、AI による返信、連携システムは停止します。
なぜ誰もこの切断に気づかないのですか?
番号を実際に使っている人は電話を使っており、その電話は動き続けるからです。API 側が終了しても、アプリにバナーは表示されません。そのため店舗は、自動化が返信していると思い込んだまま数日を過ごすことがあり、顧客は誰かが電話を取ったときにだけ返信を受け取ります。
よくあるパターンは次の通りです。事業者は番号を接続し、AI による返信や自社システムへの Webhook を設定した後、メイン端末を引き出しにしまったまま、チームが WhatsApp Web や別の端末で作業を続けます。リンク済みデバイスを使っても、プライマリ端末は活動中とはみなされません。さらに WhatsApp は、プライマリ端末が長期間非アクティブだと、そのアカウントの連携デバイスからもログアウトさせると案内しています。そのため、引き出しの中の端末が、最終的にはそれら連携デバイスも一緒に停止させることになります。
再接続後に何を再設定する必要がありますか?
再接続は Embedded Signup による新しいオンボーディングなので、いくつかの項目は引き継がれず、改めて設定が必要になります。
- Webhook の送信先。Meta はそれをプロバイダーのアプリ購読に対する上書きとして保存しており、
PARTNER_REMOVEDによってアプリとともに削除されます。再度適用する必要があります。 - チャット履歴。アプリは共有するかどうかを改めて尋ね、連絡先と履歴を同期するための新しい 24 時間の期間が開きます。
- 古い接続で発行されたトークンは動作しない可能性があります。再接続後に認証情報を取得し直してください。
- Meta は Coexistence 用の既存の Messaging アカウント ID を維持するため、WhatsApp Business Account は以前と同じものです。
ギャップ中に送信されたメッセージはどうなりましたか?
それらは他のメッセージと同様に、端末上の WhatsApp Business アプリに届いたため、事業者にとって何も失われてはいません。ただし、プロバイダーのアプリがアカウントからアンインストールされていたため、自社のシステムはその期間中に何も受け取っていません。自動化はそれらのチャットに返信できず、AI エージェントも一度も見ていません。
再接続後は、ギャップ中に届いたチャットをアプリで確認し、まだ返信待ちのものに返信してください。自社システムにそれらのメッセージが必要な場合は、新しいオンボーディングで提供される履歴同期が唯一の取り込み方法です。事業者が共有に同意し、再接続から 24 時間以内に直接の Webhook 送信先を保存していれば、最大 6 か月分の 1 対 1 チャットを取り込めます。自動化がオンになっている番号は、このインポートの対象になりません。
今後同じことが起きないようにするには?
プライマリ端末をオンラインにした状態で、WhatsApp Business アプリを定期的に開いて同期させてください。Meta のルールはプライマリ端末を基準にしており、弊社の監視では、API 経由で送受信したメッセージはその端末の活動としてカウントされないことがわかっています。Meta が公開しているのは約 14 日という目安で、正確な時刻ではありません。そのため週 1 回の習慣であれば十分な余裕が残ります。
事業者が実際に行っている対策には次のようなものがあります。端末を管理する担当者向けの定期的なカレンダーのリマインダー、引き出しにしまわずに受付に置いておくこと、そして WhatsApp Web だけでなく一部のチャットは端末から返信することです。切断をその日のうちに報告する監視があれば、音沙汰のない 1 週間が、数分の停止で済むようになります。
他の切断とはどう違いますか?
理由フィールドによって、端末が静かなだけの状態と、番号が本当に失われた状態が区別され、それぞれ修正方法が異なります。
PRIMARY_INACTIVITY: アプリが約 14 日間開かれていません。アプリを開いてから、同じ番号を再接続してください。COMPANION_INACTIVITY: リンク済みデバイスが約 30 日間使われていません。その端末でアプリを開いてから、再接続してください。USER_RE_REGISTERED: 番号が新しいデバイスに登録されました。現在その番号を持っている端末から再接続してください。CHANGE_NUMBERまたはBUSINESS_DOWNGRADE: 別の番号に変更されたか、コンシューマー向けアプリに戻っています。新しい接続が必要です。- 制限は切断ではなく、執行上の判断です。再接続しても解除されません。
設定方法
- Open the app on the primary phoneOpen WhatsApp Business on the phone that holds the number, with mobile data or Wi-Fi on, and wait until the chats finish syncing.
- Start the connect flow againOn the number's page in the dashboard, click "Reconnect this number", or start Embedded Signup from your provider, and log in with a Meta account that administers the business portfolio.
- Choose the same portfolio and numberPick the same business portfolio and WhatsApp Business Account. In our experience Meta recognizes the number and offers, pre-checked, to restore what it had before.
- Confirm on the phoneScan Meta's QR code from inside the WhatsApp Business app, confirm the connection and decide whether to share chat history.
- Check delivery end to endConfirm the webhook destination is set, send a test message from a customer phone, and check that your automation or system answered it.
よくある間違い
- 電話がオフラインのままか、アプリを開かないまま接続フローを実行すること。先にアプリを開いて同期させてください。そうしないと、電話の手順で再接続が失敗することがあります。
- 接続と一緒に Webhook の送信先も戻ると思い込むこと。Meta はアプリとともにそれを削除するため、設定し直すまで自社のシステムは無反応のままです。
- PARTNER_REMOVED と PRIMARY_INACTIVITY の組み合わせを、顧客が離脱したと扱うこと。これは最も復旧しやすい切断です。
- WhatsApp Web の利用で番号を有効に保てると考えること。このルールはプライマリ端末を監視しており、非アクティブなプライマリ端末は連携デバイスからもログアウトさせます。
「Meta は、端末上の WhatsApp Business アプリが約 14 日間開かれなかったため、この番号を切断しました」と表示され、その隣には「この番号を再接続する」ボタンがあります。再接続後は、保存されていたメッセージの送信先が自動的に戻り、自動化は再び返信します。接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
ちょうど 14 日間ですか?
Meta は、プライマリ端末の非アクティブが約 14 日間であると文書化しており、正確な時刻は公表していません。少なくとも 10 日ごと、または週に 1 回アプリを開けば、境界に近づくことを避けられます。
顧客は切断に気づきますか?
直接には気づきません。メッセージは通常どおり端末のアプリに届きます。顧客が気づくのは、番号が再接続されるまで自動返信が止まることです。
代理店や開発者が代わりに再接続できますか?
Business Portfolio を管理する Meta ログインを使えば、ブラウザ上の作業は代行できます。ただし確認は WhatsApp Business アプリで行われるため、端末を持つ人が手続きに参加する必要があります。
番号が停止している間も料金は発生しますか?
easyCoexistence では、この切断を検知することが監視の役割であるため、番号は停止中もプランに残ります。再接続しても追加料金は発生しません。課金を止めるには番号を削除してください。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日