WhatsApp Business App 共存
概述
WhatsApp Coexistence 功能支援將已經在 WhatsApp Business App 中使用的號碼接入 API，允許同一號碼在 API 和 App 上同時執行。EngageLab WhatsApp 基於 Meta 該功能接入，底層能力與 Meta 官方文件 一致。
接入成功後，商家可以：
- 使用我們平臺透過 Cloud API 規模化地向其客戶傳送訊息；
- 同時保留使用 WhatsApp Business App 進行一對一訊息收發的能力；
- 兩端（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 Code
輸入你 WhatsApp Business App 正在使用的電話號碼。系統驗證成功後，使用 WhatsApp App 掃描 QR Code。
若系統報錯，請檢查該號碼是否已經在 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）聊天 | 現在支援訊息編輯/撤回 | 支援。最近 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 帳號每秒可傳送訊息上限為 5 條（包括手機端 app 傳送的訊息以及透過平臺繫結後發出的訊息，一起計算）
傳送速度（吞吐量）
為保持與 WhatsApp Business App 的相容性，共存號碼的傳送速度固定為 20 條/秒（20 mps），無法升級。大規模群發會受此速度上限影響。
客服視窗
- 只有當 WhatsApp 使用者在你開通共存之後給你發訊息，才會開啟 24 小時客服視窗，此時你可以用普通（非範本）訊息回覆；
- 如果使用者是在你開通之前發的訊息，由於當時未開啟客服視窗，你只能用已稽核透過的範本訊息回覆；
- 透過 WhatsApp Business App 傳送的訊息不受 24 小時客服視窗限制，可隨時一對一回覆。
關聯裝置
- 你最多可將 4 個 WhatsApp「companion」（關聯）客戶端連結到 WhatsApp Business App 帳號；
- WhatsApp for Windows 和 WhatsApp for WearOS 這兩類關聯客戶端不受支援；
- 開通共存的那一刻，所有關聯裝置會被自動解綁，之後你可以重新連結受支援的裝置；
- 如果對方使用者使用不受支援的關聯裝置給你發訊息，該訊息不會同步到平臺，你在平臺介面上看不到；
- 你發出的訊息若在不受支援的關聯裝置上檢視，會顯示佔位提示文字，引導使用者到主裝置檢視。
注意事項
歷史同步 24 小時視窗
在 App 端同意共享聊天記錄後，您需 24 小時內在傳送號管理點選歷史同步，超過時間視窗平臺將無法同步您的歷史訊息。
避免意外斷開連線
以下情形會觸發帳號與 Cloud API 斷開：
| 斷開原因 | 說明 |
|---|---|
| 主裝置長期不活躍 | 主裝置約 14 天無活動 |
| 關聯裝置長期不活躍 | 關聯裝置約 30 天無活動 |
| 用號碼註冊了消費者版 WhatsApp | 即用個人版 WhatsApp 重新註冊了該號碼 |
| 更換電話號碼 | 你更改了繫結號碼 |
| 在新裝置上重新註冊 | 在新裝置重新註冊了該號碼 |
| 政策執行 / 主動刪除帳號 | 因違規被處置，或你主動刪除了 WhatsApp 帳號 |
為避免意外掉線，建議保持主裝置與關聯裝置的正常活躍使用，且不要用個人版 WhatsApp 重新註冊同一號碼。
舊合作夥伴信用額度衝突
如果你過去曾與其他合作夥伴合作，且仍在共享之前的信用額度（credit line），切換到新平臺時可能會報錯。
首次訊息可能短暫延遲
開通後，使用者首次給你發訊息（尤其是透過「點選到 WhatsApp」廣告進來時），可能出現短暫的訊息異常，通常幾秒內自動恢復，屬正常現象。
如有更多疑問，請聯絡技術支援。
