Coexistence 接続の電話番号を変更するとき

番号を変更すると、接続はどうなりますか？

接続は終了します。Meta は、電話番号の変更を Coexistence 接続が切断される理由の 1 つとして挙げており、account_update Webhook の disconnection_info に理由 CHANGE_NUMBER を載せて通知します。

これは厳しい仕様というより、プラットフォームの一貫した設計によるものです。API 側が把握している情報はすべて、ビジネス用電話番号を単位に管理されています。電話番号 ID、表示名、品質評価、Webhook のサブスクリプションなどです。番号が違えば別のアセットになるため、旧番号に紐づいていたものは自動では引き継がれず、旧接続は番号を変更した時点で機能しなくなります。

新しい番号はどのように接続しますか？

初めての接続として行います。新しい番号も、Coexistence に参加する他の番号と同じ条件を満たしたうえで、最初からオンボーディングを行う必要があります。旧接続のものは何も再利用されないため、日程を決めた短いプロジェクトとして切り替えを進めると安心です。

• WhatsApp Business アプリで有効になっており、バージョンが 2.24.17 以降であること。
• ご自身が管理者である Business Portfolio に属していること。
• 他のプロバイダーに接続されていないこと。
• 他のビジネス用電話番号と同様に、登録時に表示名を提供すること。

API 側では何を更新すべきですか？

旧番号またはその ID を保存しているすべての場所です。Cloud API 経由で送信する連携は電話番号 ID を宛先に指定するため、旧 ID を指したままの CRM、自動化ワークフロー、AI エージェントは、新しい番号に切り替わらずに失敗します。

新しい接続では、オンボーディングの質問も最初からやり直しになります。チャット履歴を共有するかどうかや、同期のための 24 時間の期間も含まれます。旧接続に設定していた Webhook の送信先は、新しい接続にも設定し直してください。Portfolio の上限も確認しておきましょう。Meta は、新しい Business Portfolio に登録できるビジネス用電話番号を、認証が完了するか 2,000 件のメッセージ送信上限に達するまで 2 件までに制限しています。

プラットフォーム上の旧番号はどうなりますか？

誰かが削除するまで、WhatsApp Business アカウントのアセットとして残ります。Meta では、ビジネス用電話番号を削除できるのは Business Portfolio の管理者だけです。また、過去 30 日以内に有料メッセージの送信に使われた番号は削除できません。

削除は任意の整理作業であり、新しい番号を接続するための必須条件ではありません。ただし、古い番号をアカウントに残しておくと、システムが誤った番号を宛先にし続けやすくなります。30 日が過ぎてから削除すると、アカウントの見通しが保てます。

よくある間違い

• 再接続の計画を立てる前にアプリで番号を変更してしまうこと。旧接続はその時点で終了します。
• 連携先に旧電話番号 ID を残したままにすること。送信は新しい番号に追従せず、失敗します。
• 切り替えの直後に旧番号を削除しようとすること。30 日以内に有料メッセージを送信していた場合、Meta はブロックします。

よくある質問

続きを読む