WhatsApp Business App との共存
概要
WhatsApp Coexistence（共存）機能を使用すると、すでに WhatsApp Business App で使用している番号を API に接続でき、同じ番号を API と App の両方で同時に運用できます。EngageLab WhatsApp はこの Meta の機能をベースにしており、基盤となる機能は Meta 公式ドキュメント と一致しています。
接続に成功すると、ビジネスは次のことが可能になります。
- 当社プラットフォームの Cloud API を通じて、顧客にメッセージを大規模に送信する;
- 同時に、WhatsApp Business App での 1 対 1 のメッセージ送受信機能を維持する;
- 両端（App + Cloud API）のメッセージ履歴を同期した状態に保つ。
料金
- WhatsApp Business App から送信したメッセージは引き続き無料です;
- プラットフォーム/API から送信したメッセージは、Cloud API の料金体系に基づいて課金されます。
接続フロー
開始前に確認すること
- WhatsApp Business App のバージョンが 2.24.17 以上であること;
- 接続する電話番号が、現在お使いの WhatsApp Business App で正常に使用されていること;
- 接続プロセス中は、後続のデータ同期を完了できるよう WhatsApp Business App を開いたままにしておくこと;
- 開通後の App の機能の変更点と制限を事前に把握しておくこと。
フロー概要
1. プラットフォームで接続を開始する
当社プラットフォームにログインし、接続プロセスを開始して、WhatsApp Business App Coexistence を選択します。
2. 番号を入力し、App で QR コードをスキャンする
WhatsApp Business App で使用している電話番号を入力します。システムによる検証が成功したら、WhatsApp App を使用して QR コードをスキャンします。
システムがエラーを表示した場合は、その番号がすでに WhatsApp Business App で使用されていないか確認してください。
3. WhatsApp Business App で接続を完了する
スマートフォンの WhatsApp Business App を開き、次の順序で操作します。
- 公式の Facebook Business Account からメッセージが届きます。Connect（接続） をタップします;
- Connect to the Business Platform（Business Platform に接続） ボタンをタップして、接続を続行します;
- Confirm（確認） をタップします。この時点で、チャット履歴を共有するかどうかを選択できます:
- 共有する: プラットフォームは直近 180 日間のメッセージ履歴を同期できます;
- 共有しない: プラットフォームはチャット履歴を取得しません;
4. プラットフォーム側の残りのフローを完了する
プラットフォームに戻り、接続フローの残りのステップを完了します。
5. データ同期を待つ
接続完了後、プラットフォームは自動的に連絡先とチャット履歴を同期します。
- 同期には数分かかる場合があり、所要時間はメッセージ量やネットワーク速度などによって異なります;
- 同期中は WhatsApp Business App を開いたままにしておいてください;
- 同期が完了すると、プロセスが終了したことをお知らせします。
6. 履歴データの同期
接続時にチャット履歴の共有を選択した場合は、24 時間以内に送信番号管理で履歴同期をタップする必要があります。
注意：この時間枠は Meta プラットフォームによって定められています。24 時間を超えると、プラットフォームはメッセージ履歴を同期できなくなります。
機能対照
次の表は、Cloud API に接続した後、ビジネスの WhatsApp Business App 上の各機能がどのように変化するかを説明しています。
| WhatsApp Business App の既存機能 | Cloud API 接続後の App 上での変化 | この機能は Cloud API でサポートされているか |
|---|---|---|
| 1 対 1（1:1）チャット | メッセージの編集/取り消しがサポートされるようになりました | サポート。直近 6 か月間のすべてのチャットメッセージを同期可能。送受信メッセージは Cloud API と App の間でミラー同期されます |
| 連絡先 | 変化なし | サポート。WhatsApp 番号を持つすべての連絡先を同期可能 |
| グループチャット | 変化なし | 非サポート。グループチャットは同期されません |
| 消えるメッセージ | すべての 1:1 チャットでこの機能がオフになります | 非サポート |
| 一度だけ表示メッセージ（View once） | すべての 1:1 チャットでこの機能が無効になります | 非サポート |
| リアルタイム位置情報メッセージ | すべての 1:1 チャットでこの機能が無効になります | 非サポート |
| ブロードキャストリスト（Broadcast lists） | 無効になります。新規作成はできず、既存のブロードキャストリストは読み取り専用になります | 非サポート |
| 音声/ビデオ通話 | 変化なし | 非サポート |
| ビジネスツール（カタログ、注文、ステータスなど） | 変化なし | 非サポート |
| メッセージツール（マーケティングメッセージ、あいさつメッセージ、不在メッセージ、クイック返信、ラベルなど） | 変化なし | 非サポート |
| ビジネスプロフィール（名前、住所、ウェブサイトなど） | 変化なし | 非サポート |
| チャンネル（Channels） | 変化なし | 非サポート |
制限事項
チャット履歴の同期
開通時にチャット履歴の共有に同意した場合、プラットフォームはメッセージ履歴を同期しますが、以下の制限があります。
- 接続時点から直近 180 日間（約 6 か月）以内に送受信したメッセージのみが同期されます;
- グループチャットのメッセージは同期されません;
- メディアファイル（画像/動画/ファイルなど）のダウンロード可能なリソースは、接続前 14 日以内に送信されたメディアのみが対象です。それより古いメディアはテキスト記録のみが保持されます;
- 同期を円滑に完了できるよう、同期中は WhatsApp Business App を開いたままにしておいてください;
- チャット履歴を共有しないことを選択することもできます。その場合、プラットフォームはメッセージ履歴を取得しません。
メッセージ送信
送信数
WhatsApp Business App アカウントが 1 秒あたりに送信できるメッセージの上限は 5 件です（スマートフォンの App から送信したメッセージと、プラットフォームでバインドした後に送信したメッセージを合算して計算します）。
送信速度（スループット）
WhatsApp Business App との互換性を維持するため、共存番号の送信速度は 1 秒あたり 20 件（20 mps）に固定されており、アップグレードできません。大規模な一斉送信はこの速度上限の影響を受けます。
カスタマーサービスウィンドウ
- 24 時間のカスタマーサービスウィンドウは、WhatsApp ユーザーが共存を開通した後にあなたにメッセージを送信した場合にのみ開き、その場合は通常（非テンプレート）メッセージで返信できます;
- ユーザーが開通前にメッセージを送信した場合は、その時点でカスタマーサービスウィンドウが開いていなかったため、承認済みのテンプレートメッセージでのみ返信できます;
- WhatsApp Business App から送信したメッセージは 24 時間のカスタマーサービスウィンドウの制限を受けず、いつでも 1 対 1 で返信できます。
リンク済みデバイス
- WhatsApp Business App アカウントには、最大 4 つの WhatsApp「companion」（リンク済み）クライアントをリンクできます;
- リンク済みクライアントのうち、WhatsApp for Windows と WhatsApp for WearOS はサポートされていません;
- 共存を開通した瞬間、すべてのリンク済みデバイスは自動的にリンク解除されます。その後、サポートされているデバイスを再度リンクできます;
- 相手のユーザーがサポートされていないリンク済みデバイスからあなたにメッセージを送信した場合、そのメッセージはプラットフォームに同期されず、プラットフォーム画面では確認できません;
- あなたが送信したメッセージがサポートされていないリンク済みデバイスで表示されると、プレースホルダーのテキストが表示され、メインデバイスで確認するよう案内されます。
注意事項
履歴同期の 24 時間ウィンドウ
App 側でチャット履歴の共有に同意した後、24 時間以内に送信番号管理で履歴同期をタップする必要があります。この時間枠を過ぎると、プラットフォームはメッセージ履歴を同期できなくなります。
予期しない切断を回避する
以下の状況では、アカウントと Cloud API の接続が切断されます。
| 切断の原因 | 説明 |
|---|---|
| メインデバイスが長期間非アクティブ | メインデバイスが約 14 日間活動なし |
| リンク済みデバイスが長期間非アクティブ | リンク済みデバイスが約 30 日間活動なし |
| 番号をコンシューマー版 WhatsApp で登録した | つまり、個人版 WhatsApp でその番号を再登録した |
| 電話番号を変更した | バインドした番号を変更した |
| 新しいデバイスで再登録した | 新しいデバイスでその番号を再登録した |
| ポリシー執行 / アカウントの能動的削除 | 違反により処置された、またはあなたが WhatsApp アカウントを能動的に削除した |
予期しない切断を回避するため、メインデバイスとリンク済みデバイスを通常どおりアクティブに使用し、同じ番号を個人版 WhatsApp で再登録しないことをお勧めします。
旧パートナーのクレジットライン競合
過去に他のパートナーと提携しており、以前のクレジットライン（credit line）を引き続き共有している場合、新しいプラットフォームへ切り替える際にエラーが発生することがあります。
最初のメッセージが一時的に遅延する場合がある
開通後、ユーザーが初めてあなたにメッセージを送信する際（特に「Click to WhatsApp」広告経由で入ってきた場合）、一時的なメッセージの異常が発生することがあります。通常は数秒以内に自動的に回復し、正常な現象です。
ご不明な点がございましたら、テクニカルサポートにお問い合わせください。
