ひとつの番号で。アプリと API を同時に。
Coexistence は、WhatsApp Business アプリと Cloud API をひとつの電話番号で同時に運用するための、Meta の公式モードです。チームは同じチャットと同じ履歴のままスマートフォンから対応を続け、その同じ回線でソフトウェアがメッセージを送受信します。
EasyCoexistence は番号を接続し、その接続を監視します。
かつて必要だった選択、そして今は不要になった選択
Coexistence は新しい API ではありません。ほぼすべての小規模事業者が何ひとつ自動化できずにいた原因である、分かれ道をなくすものです。
チームはスマートフォンから対応します。自動化も、連携も、計測もできません。
API なしソフトウェアから番号を利用できます。その番号では Business アプリが使えなくなり、チームはツールを乗り換えることになります。
アプリなしMeta は、WhatsApp Business アプリで使用中の番号に Cloud API を接続します。両方が同じ回線で同時に稼働し、それぞれが相手の送信内容を確認できます。
このように番号を運用しているのは誰か
同じ機能に正反対のことを求める 2 つのグループです。だからこそ、その上に載るダッシュボードよりも接続そのものが重要です。
小さなチーム、配送車や店頭に書かれた番号、そして毎晩同じ 4 つの質問に答える時間。誰かを置き換えようとしているわけではありません。確認、リマインダー、営業時間外の最初の返信を人手なしで行いたい、そのうえでスマートフォンはほかのすべてにこれまでどおり使いたいのです。
多くのクライアントがいて、それぞれ誰も移行したり手を加えたりしてはいけない番号を持っています。自分たちが構築するシステムからその番号に到達できる必要があり、次の番号も営業との打ち合わせなしで追加できる必要があります。クライアントのスタッフが今も手作業で対応している番号に乗る公式の手段は、Coexistence だけです。
番号が両方で使えるようになるまでと、メッセージイベントの行き先
ステップは 4 つです。スマートフォンで行うのはスキャン 1 回だけで、システム構成を決めるのは最初のステップです。
オンボーディングを始める前にエンドポイントを用意する
Meta は配信を始める前に送信先を確認します。hub.mode=subscribe、お客様の hub.verify_token、そして hub.challenge を付けた GET をお客様の URL に送り、エンドポイントはその challenge の値をそのまま返す必要があります。
送信先は HTTPS でなければならず、確認用トークンも必須です。私たちは呼び出しの前にこの 2 つを検証します。そのため、形式の正しくない URL は当社の段階で失敗し、接続済みに見えるのに何も届かないという状態にはなりません。
まだ何も接続されていません。ここでメッセージの届く先が決まります。 経路上にプロバイダーがいる場合相手のサーバーに保存プロバイダーのプラットフォームメッセージを受信して保存お客様相手の都合で届くコピーEasyCoexistence設定のみお客様のエンドポイントまだ確認されていません当社経路は設定しますが、経路上にはいませんMeta の Embedded Signup を実行し、アプリでスキャンする
Meta 自身のポップアップが開きます。Business Portfolio、WhatsApp Business アカウント、そしてすでに WhatsApp Business アプリに登録されている番号を選び、スマートフォンでコードをスキャンして接続を承認します。
既存のチャット履歴を共有するかどうかも、ここで選びます。これはオンボーディング時に一度だけ行う選択で、あとから変更することはできません。スキャンが完了した時点から、Business アプリはそのまま使い続けられます。
2 つ目の窓口が加わります。1 つ目はなくなりません。 移行した場合窓口は 1 つCloud API のみこの番号では Business アプリが使えなくなるCoexistence の場合窓口は 2 つWhatsApp Business アプリ同じチャットと履歴Cloud API同じ回線でメッセージイベントの送信先を自社のシステムにする
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 は当社が受け取ります。監視はこれらで成り立っているためです。こうして、ダッシュボードは役に立つまま、会話の内容が当社に届くことはありません。
オーバーライドが有効になったあと、各イベントがどこに届くか。 運用イベント当社に配信メッセージ経路お客様に配信messages顧客が送信するすべての内容smb_message_echoesチームがアプリから送信する内容お客様のサーバー直接届き、当社を経由しない接続を維持し、再接続にも耐える
メインの端末で約 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 のポリシーによって変わります。
お客様に転送するもの、当社が受け取るもの
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 アプリは動き続けるため、誰も気づきません。私たちが確認している項目と、その方法です。
フィールドが false になったことから推測するのではなく、Meta の account_update Webhook、具体的には PARTNER_REMOVED から検知します。この判定にはあえて is_on_biz_app を読みません。Coexistence ではない番号では正当に false になり、誤った切断判定の原因になっていたためです。
Meta のメイン端末の非アクティブルールです。再接続が可能なため、解約した顧客ではなく独立した状態として記録され、再接続すれば送信と監視が復旧します。
送信先はアカウントに対する当社アプリのサブスクリプション上のオーバーライドとして存在するため、切断されるとアンインストールされます。再接続すると送信は戻りますが、お客様のサーバーへの配信は戻りません。私たちは毎回オーバーライドを再適用しています。実際にある番号で、問題なく再接続したのに気づかれないまま配信が止まったことがあったためです。
私たちは同じアカウントに対して、クライアントのトークンと当社の System User token の両方を保持しています。一方が拒否されると、もう一方でアカウントを読み取り、実際にどちらが壊れたのかを判定します。そのため、取り消されたトークンが番号の喪失に見えることはなくなりました。
Meta から定期的にポーリングします。RED 評価になると接続は劣化状態としてマークされ、品質、メッセージングのティア、スループットのレベルを毎回のチェックで保存するため、送信に影響が出る前に低下が見えるようになります。
番号を接続することと、番号を見守ることは別の製品です。私たちが存在する理由は後者にあります。
番号の接続にかかる通常の時間。WhatsApp Business アプリでコードをスキャンします。
顧客の返信後、フリーテキスト返信のセッションが開いたままになる時間。
Coexistence の番号で送信できる量。Meta が固定しており、引き上げはできません。
番号を初めて接続するときに Meta が API と同期するチャット履歴の量。
よくある質問
チームは電話の利用をやめる必要がありますか?
いいえ。それが Coexistence の目的です。WhatsApp Business アプリは同じ番号で、同じ会話を使って動作し続け、API も並行して動作します。
既存の会話は失われますか?
いいえ。会話はアプリに残り、番号の接続時に Meta が約 6 か月分の履歴を API と同期します。そのため、ソフトウェアも文脈を把握した状態で始められます。
元に戻せますか?
はい。番号の接続を解除できます。アプリはこれまでどおり動作し、接続によって番号自体が恒久的に変更されることもありません。
これは非公式の WhatsApp API と同じですか?
いいえ。その違いが番号を維持できるかどうかを左右します。Coexistence は Cloud API 上の Meta 公式機能です。非公式ゲートウェイは WhatsApp Web をリンク済みデバイスとして操作するため、規約違反となり、番号が利用停止になる可能性があります。
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める3 日間無料。トライアル終了まで料金は発生しません。