ログイン無料トライアルを開始
Meta Tech Provider

ひとつの番号で。アプリと API を同時に。

Coexistence は、WhatsApp Business アプリと Cloud API をひとつの電話番号で同時に運用するための、Meta の公式モードです。チームは同じチャットと同じ履歴のままスマートフォンから対応を続け、その同じ回線でソフトウェアがメッセージを送受信します。

EasyCoexistence は番号を接続し、その接続を監視します。

無料トライアルを始める3 日間無料。トライアル終了まで料金は発生しません。
+1 415 555 0188
WhatsApp Business アプリチームはこれまでどおりスマートフォンから対応
Cloud APIお客様のシステムや AI アシスタントが同じ回線で
両方が同じスレッドを見ています。API が送信した内容はアプリに表示され、チームがアプリで入力した内容は smb_message_echoes イベントとして届きます。そのため、すでに人が返信した会話にソフトウェアが重ねて返信することはありません。
デフォルトでメッセージを保存しませんBusiness アプリ + Cloud APIClaude と ChatGPT 用 MCP2 分で利用開始

かつて必要だった選択、そして今は不要になった選択

Coexistence は新しい API ではありません。ほぼすべての小規模事業者が何ひとつ自動化できずにいた原因である、分かれ道をなくすものです。

以前ひとつの番号に、ひとつの選択
アプリを使い続ける

チームはスマートフォンから対応します。自動化も、連携も、計測もできません。

API なし
API に移行する

ソフトウェアから番号を利用できます。その番号では Business アプリが使えなくなり、チームはツールを乗り換えることになります。

アプリなし
現在ひとつの番号で、両方を
ひとつの番号
WhatsApp Business アプリCloud API

Meta は、WhatsApp Business アプリで使用中の番号に Cloud API を接続します。両方が同じ回線で同時に稼働し、それぞれが相手の送信内容を確認できます。

このように番号を運用しているのは誰か

同じ機能に正反対のことを求める 2 つのグループです。だからこそ、その上に載るダッシュボードよりも接続そのものが重要です。

スマートフォンはそのまま番号がひとつだけの企業

小さなチーム、配送車や店頭に書かれた番号、そして毎晩同じ 4 つの質問に答える時間。誰かを置き換えようとしているわけではありません。確認、リマインダー、営業時間外の最初の返信を人手なしで行いたい、そのうえでスマートフォンはほかのすべてにこれまでどおり使いたいのです。

多数の番号を、ひとつのアカウントで代理店、コンサルティング会社、開発者

多くのクライアントがいて、それぞれ誰も移行したり手を加えたりしてはいけない番号を持っています。自分たちが構築するシステムからその番号に到達できる必要があり、次の番号も営業との打ち合わせなしで追加できる必要があります。クライアントのスタッフが今も手作業で対応している番号に乗る公式の手段は、Coexistence だけです。

番号が両方で使えるようになるまでと、メッセージイベントの行き先

ステップは 4 つです。スマートフォンで行うのはスキャン 1 回だけで、システム構成を決めるのは最初のステップです。

  1. オンボーディングを始める前にエンドポイントを用意する

    Meta は配信を始める前に送信先を確認します。hub.mode=subscribe、お客様の hub.verify_token、そして hub.challenge を付けた GET をお客様の URL に送り、エンドポイントはその challenge の値をそのまま返す必要があります。

    送信先は HTTPS でなければならず、確認用トークンも必須です。私たちは呼び出しの前にこの 2 つを検証します。そのため、形式の正しくない URL は当社の段階で失敗し、接続済みに見えるのに何も届かないという状態にはなりません。

    必要なもの
    Meta の GET に対して hub.challenge を返す HTTPS エンドポイント
    所要時間
    約 1 分
    得られるもの
    番号が接続された瞬間に Meta が確認できる送信先
    まだ何も接続されていません。ここでメッセージの届く先が決まります。
    経路上にプロバイダーがいる場合相手のサーバーに保存
    Meta
    プロバイダーのプラットフォームメッセージを受信して保存
    お客様相手の都合で届くコピー
    EasyCoexistence設定のみ
    Meta
    お客様のエンドポイントまだ確認されていません
    当社経路は設定しますが、経路上にはいません
  2. Meta の Embedded Signup を実行し、アプリでスキャンする

    Meta 自身のポップアップが開きます。Business Portfolio、WhatsApp Business アカウント、そしてすでに WhatsApp Business アプリに登録されている番号を選び、スマートフォンでコードをスキャンして接続を承認します。

    既存のチャット履歴を共有するかどうかも、ここで選びます。これはオンボーディング時に一度だけ行う選択で、あとから変更することはできません。スキャンが完了した時点から、Business アプリはそのまま使い続けられます。

    必要なもの
    Business Portfolio へのアクセス権と、その番号を使っているスマートフォン
    所要時間
    2〜3 分
    得られるもの
    アプリで使用中の番号に接続された Cloud API
    2 つ目の窓口が加わります。1 つ目はなくなりません。
    移行した場合窓口は 1 つ
    番号
    Cloud API のみこの番号では Business アプリが使えなくなる
    Coexistence の場合窓口は 2 つ
    番号
    WhatsApp Business アプリ同じチャットと履歴
    Cloud API同じ回線で
  3. メッセージイベントの送信先を自社のシステムにする

    Meta では、特定の WhatsApp Business アカウントの Webhook を配信する先をアプリが上書きできます。私たちはこのオーバーライドをお客様の URL に設定し、メッセージ経路の 2 つのフィールド、messages と smb_message_echoes が Meta からお客様へ直接届くようにします。

    運用系のフィールド、つまり account_update、phone_number_quality_update、account_alerts、account_review_update、business_capability_update、phone_number_name_update は当社が受け取ります。監視はこれらで成り立っているためです。こうして、ダッシュボードは役に立つまま、会話の内容が当社に届くことはありません。

    必要なもの
    ステップ 1 のエンドポイント(Meta による確認済み)
    所要時間
    オンボーディング完了と同時に適用
    得られるもの
    メッセージは Meta からお客様へ届き、当社はメッセージ経路の外にいる状態
    オーバーライドが有効になったあと、各イベントがどこに届くか。
    運用イベント当社に配信
    account_update接続状態の変化
    phone_number_quality_update品質とスループット
    account_review_update審査の結果
    メッセージ経路お客様に配信
    messages顧客が送信するすべての内容
    smb_message_echoesチームがアプリから送信する内容
    お客様のサーバー直接届き、当社を経由しない
  4. 接続を維持し、再接続にも耐える

    メインの端末で約 14 日間アクティビティがないと、Meta は Coexistence の番号を切断します。この切断は再接続が可能なため、私たちは顧客の解約として扱うのではなく、独立した状態として記録します。

    見落とされやすいのは、切断が経路に与える影響です。Meta は送信先を、アカウントに対する当社アプリのサブスクリプション上のオーバーライドとして保存しています。そのため PARTNER_REMOVED が起きるとアプリがアンインストールされ、オーバーライドも一緒に消えます。再接続すると送信と監視は戻りますが、お客様の送信先は戻りません。私たちはこれを自動で設定し直しています。このルールに最初に該当した番号が、問題なく再接続したあと、気づかれないまま顧客のサーバーへの配信を止めていたためです。

    必要なもの
    メインの端末でときどきアプリを開くこと
    所要時間
    継続的
    得られるもの
    見守られた接続と、再接続後も残る経路
    再接続で自動的に戻るものと、設定し直す必要があるもの。
    Meta が復元自動
    送信Cloud API が再び使える
    運用イベント監視が再開
    アプリとともに失われる再適用が必要
    お客様の Webhook オーバーライドアプリとともにアンインストール
    お客様へのメッセージ配信気づかれないまま停止
    当社が再適用再接続のたびに

チームがこのように番号を運用する理由

  • 配送車、領収書、Web サイトにすでに記載されている番号と、それを中心としたモバイルでの業務フローをそのまま維持できます。
  • 誰も新しいツールに移行させることなく、API による送信、Webhook の処理、メッセージテンプレートを追加できます。
  • メッセージのトラフィックをプロバイダーの共有受信箱に通さないため、会話が他社のプラットフォーム上に置かれることはありません。
  • 代理店は多数のクライアントの番号をひとつのアカウントで管理でき、各番号はクライアント自身の Business Portfolio で接続されます。

利用条件と実際の制限

  • 番号はすでに WhatsApp Business アプリで有効になっている必要があります。通常の WhatsApp アプリで使っている番号は、先に移行する必要があります。
  • 既存のチャット履歴を共有するかどうかは、オンボーディング中に一度だけ行う選択で、あとから変更することはできません。
  • Coexistence の番号では、どのプロバイダーでもグループチャットは API の対象外です。
  • メインの端末には定期的なアクティビティが必要です。約 14 日間アクティビティがないと、Meta は接続を切断します。
  • Coexistence の番号では Meta の認証やバッジの取得方法が異なり、地域ごとの提供状況は Meta のポリシーによって変わります。
自由なテキスト顧客の最後のメッセージから 0〜24 時間テンプレートのみそれ以降、顧客が再びメッセージを送るまで
顧客が何かを送信するたびに、時間はリセットされます。これは本番環境で連携を壊すルールです。テストは必ずメッセージの数秒後に行われ、その時点ではまだ自由なテキストが送れるからです。

お客様に転送するもの、当社が受け取るもの

Meta では、WhatsApp Business アカウントが Webhook を配信する先をアプリが上書きできます。私たちはこのオーバーライドをお客様の URL に設定しており、それによってイベントが 2 つに分かれます。

お客様のエンドポイントに直接配信メッセージの経路です。デフォルトでは、当社を経由することはありません。
  • messages顧客がその番号に送信したすべての内容
  • smb_message_echoesチームが WhatsApp Business アプリから送信した内容
当社に配信運用の経路です。監視はこれで成り立っています。
  • account_update接続状態:削除、オフボード、再接続、制限
  • phone_number_quality_update品質評価とスループットの変化
  • account_alertsMeta がアカウントに対して発行するアラート
  • account_review_updateMeta による審査の結果
  • business_capability_updateメッセージ上限と機能の変化
  • phone_number_name_update表示名の承認と却下

番号にオーバーライドが設定されていない場合、そのメッセージイベントは当社のデフォルトのコールバックに届き、ハンドラーが保存せずに破棄します。これはポリシーで約束しているのではなく、コードで強制しています。会話の内容が保存される経路はそもそも存在しません。

14 日ルールと、誰も触れないその副作用

メインの端末で約 14 日間アクティビティがないと、Meta は Coexistence の接続を切断します。再接続は可能なため、私たちはこれを解約した顧客として数えるのではなく、独立した状態として記録します。

本当に損失を生むのはその先です。メッセージの送信先は番号の設定ではなく、WhatsApp Business アカウントに対する当社アプリのサブスクリプションに設定されたオーバーライドです。切断されるとアプリがアンインストールされ、オーバーライドも一緒に消えます。再接続すると送信も監視も再び動きますが、どこにもエラーが出ないまま、メッセージはお客様のサーバーに届かなくなります。

私たちは再接続のたびにオーバーライドを再適用しています。この動作は実際に起きたことから生まれました。ある番号がこのルールに該当し、問題なく再接続したあと、気づかれないまま配信が止まったのです。

その時点でハンドシェイクが失敗した場合(サーバーが停止していた、トークンが変わったなど)、失敗は接続のタイムラインに記録され、送信先は破棄されずに保持されます。そのため、もう一度保存するだけで修正できます。

静かに壊れるもの、そしてそれを検知する方法

以下のほぼすべての障害の間も WhatsApp Business アプリは動き続けるため、誰も気づきません。私たちが確認している項目と、その方法です。

番号が切断されたWebhook、信頼できる情報源

フィールドが false になったことから推測するのではなく、Meta の account_update Webhook、具体的には PARTNER_REMOVED から検知します。この判定にはあえて is_on_biz_app を読みません。Coexistence ではない番号では正当に false になり、誤った切断判定の原因になっていたためです。

接続が 14 日間途絶えた独立した状態

Meta のメイン端末の非アクティブルールです。再接続が可能なため、解約した顧客ではなく独立した状態として記録され、再接続すれば送信と監視が復旧します。

再接続時に Webhook の経路が消えた自動で再適用

送信先はアカウントに対する当社アプリのサブスクリプション上のオーバーライドとして存在するため、切断されるとアンインストールされます。再接続すると送信は戻りますが、お客様のサーバーへの配信は戻りません。私たちは毎回オーバーライドを再適用しています。実際にある番号で、問題なく再接続したのに気づかれないまま配信が止まったことがあったためです。

アクセストークンが使えなくなった2 つのトークン、ひとつの答え

私たちは同じアカウントに対して、クライアントのトークンと当社の System User token の両方を保持しています。一方が拒否されると、もう一方でアカウントを読み取り、実際にどちらが壊れたのかを判定します。そのため、取り消されたトークンが番号の喪失に見えることはなくなりました。

品質が低下したポーリング

Meta から定期的にポーリングします。RED 評価になると接続は劣化状態としてマークされ、品質、メッセージングのティア、スループットのレベルを毎回のチェックで保存するため、送信に影響が出る前に低下が見えるようになります。

番号を接続することと、番号を見守ることは別の製品です。私たちが存在する理由は後者にあります。

2 minutes

番号の接続にかかる通常の時間。WhatsApp Business アプリでコードをスキャンします。

24 hours

顧客の返信後、フリーテキスト返信のセッションが開いたままになる時間。

20 msg/s

Coexistence の番号で送信できる量。Meta が固定しており、引き上げはできません。

6 months

番号を初めて接続するときに Meta が API と同期するチャット履歴の量。

よくある質問

チームは電話の利用をやめる必要がありますか?

いいえ。それが Coexistence の目的です。WhatsApp Business アプリは同じ番号で、同じ会話を使って動作し続け、API も並行して動作します。

既存の会話は失われますか?

いいえ。会話はアプリに残り、番号の接続時に Meta が約 6 か月分の履歴を API と同期します。そのため、ソフトウェアも文脈を把握した状態で始められます。

元に戻せますか?

はい。番号の接続を解除できます。アプリはこれまでどおり動作し、接続によって番号自体が恒久的に変更されることもありません。

これは非公式の WhatsApp API と同じですか?

いいえ。その違いが番号を維持できるかどうかを左右します。Coexistence は Cloud API 上の Meta 公式機能です。非公式ゲートウェイは WhatsApp Web をリンク済みデバイスとして操作するため、規約違反となり、番号が利用停止になる可能性があります。

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

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

無料トライアルを始める3 日間無料。トライアル終了まで料金は発生しません。

続きを読む

ガイドClaude、ChatGPT、Cursor向け WhatsApp MCP サーバーMCP サーバーを使うと、AI アシスタントから WhatsApp を直接操作できます。番号の一覧表示、メッセージやテンプレートの送信、接続状態の確認、Webhook の接続先設定が可能です。EasyCoexistence は Meta の公式 Cloud API 上で MCP サーバーを提供するため、顧客がすでにメッセージを送っている番号を公式のまま利用でき、接続方法によってリスクにさらされることはありません。ガイド非公式 WhatsApp API で実際に番号が停止される理由非公式 WhatsApp API は、リンク済みデバイスとしてサインインし、WhatsApp Web のセッションを自動化して動作します。これは WhatsApp の規約違反であり、Meta がそのパターンを検知すると、番号が停止されます。公式の Cloud API は、企業がすでに使っている番号上で、Meta がサポートするインターフェースを通じて同じ処理を行います。連携公式 Cloud APIでWhatsAppをn8nに接続Webhookの送信先をn8n Webhookノードに指定すると、その番号へのすべてのメッセージがワークフローのトリガーとして届きます。返信は Cloud API経由、またはn8nがOAuth2対応のMCP Client Toolから接続できるMCPサーバー経由で送信できます。電話もそのまま使えます。連携カスタムコネクタで WhatsApp を Claude に接続Claude に https://easycoexistence.com/api/mcp をカスタムコネクタとして追加し、サインインしてください。Meta の公式 Cloud API 上で、Claude から番号の一覧表示、接続状態の確認、メッセージやテンプレートの送信、Webhook の送信先指定ができます。リンク済みデバイスのセッションは使用しません。