WhatsApp Coexistence 詞彙表
WhatsApp Coexistence 相關詞彙容易混淆,實際上很多混亂源於兩人用同一個詞指不同事物。以下是本網站採用的定義,並連結至詳細說明各詞彙的頁面。
EasyCoexistence 透過 Meta 的原有流程連接號碼,然後監察連接狀態。
- Coexistence
Meta 的官方模式,讓 WhatsApp Business 應用程式和 Cloud API 同時在同一個號碼上運作。它不是另一個 API:仍是同一個 Cloud API,只是以應用程式可繼續運作的方式啟用。
WhatsApp Coexistence- Cloud API
由 Meta 託管的 WhatsApp Business Platform API。本網站上的每次發送、每個訊息範本和每個 Webhook 都經由它運作。
Cloud API 還是 Coexistence- WhatsApp Business 應用程式WhatsApp Business app
企業在手機上使用的應用程式。它有別於一般用戶使用的 WhatsApp 應用程式,號碼必須先在其中使用,Coexistence 才能連接它。
- WhatsApp Business 帳戶WABA
持有電話號碼和訊息範本的 Meta 物件,位於 Business Portfolio 之內。Webhook 覆寫設定在這個層級套用,而不是按號碼設定。
- Business Portfolio
Meta Business Manager 內公司層級的容器,持有一個或多個 WhatsApp Business 帳戶。客戶的號碼一直保留在客戶自己的 portfolio 內,而不是服務供應商的。
Meta Tech Provider- Phone number id
Meta 為一個已連接號碼分配的識別碼。發送訊息時指定的是這個識別碼,而不是號碼本身,而且每個傳入的 Webhook 負載中都會出現它。
- Embedded Signup
Meta 自家的啟用彈出視窗。用來選擇 portfolio、帳戶和號碼;在 Coexistence 中,還包括一個需要在 WhatsApp Business 應用程式內掃描的代碼。
號碼如何連接- Tech Provider
Meta 授予的身分,容許公司透過自己已獲批准的應用程式連接其他企業的號碼。取得免費,但須通過企業驗證和 App Review。這並不代表 Meta 的認可。
這代表甚麼- BSPBusiness Solution Provider
銷售訊息平台的公司,通常提供共用收件箱。與 Tech Provider 有重疊,但描述的是產品,而不是 Meta 授予的身分。
Coexistence 還是 BSP- Webhook 目的地webhook destination, webhook override
Meta 傳送 WhatsApp Business 帳戶事件的位置。它以覆寫設定的形式設於某個應用程式的訂閱上,因此移除連接時也會一併將其解除。
WhatsApp Webhook- hub.challenge
Meta 在驗證用的 GET 請求中傳送的值。端點必須將其作為原始回應內容傳回。改為傳回 JSON 是 Webhook 一直收不到任何內容的最常見原因。
Webhook 驗證- messages
承載客戶所發送內容的 Webhook 欄位。它屬於訊息路徑,而 Webhook 覆寫設定正是將這條路徑從服務供應商處轉走。
- smb_message_echoes
承載團隊從 WhatsApp Business 應用程式發送內容的 Webhook 欄位。只存在於 Coexistence 號碼上,軟件正是透過它看到真人的回覆。
- 客戶服務時段customer service window, 24 小時時段
由客戶最後一則訊息起計的 24 小時,期間自由文字訊息可以送達。時段以外,只有已獲批准的訊息範本才能送達。
錯誤 131047- 訊息範本template
預先提交給 Meta 審核的訊息。它是在客戶服務時段以外唯一能送達的內容;在 Coexistence 號碼上,只能透過 API 發送。
錯誤 132001- 品質評級quality rating
綠色、黃色或紅色,由 Meta 根據收件人的反應給出。它會在產生任何費用之前便下降,而且下降時不會有任何通知。
錯誤 131048- 訊息級別messaging tier
一個號碼每天可以主動開始對話的不重複客戶數目。可升可降。它有別於處理量,後者是一種速率。
- 處理量throughput
一個號碼每秒可以發送的訊息數目。在 Coexistence 號碼上由 Meta 固定,不會隨品質和級別提升。
錯誤 130429- 已連結裝置linked device
登入於其他地方的一般用戶版 WhatsApp 用戶端,例如 WhatsApp Web。非官方工具自動操作的正是它,WhatsApp 條款禁止的也是它,導致號碼被封鎖的也是它。
非官方 API 的風險- MCPModel Context Protocol
AI 助手存取不屬於自己的工具的方式。只有請求和回應:MCP 伺服器無法被傳入的訊息喚醒。
WhatsApp MCP 伺服器
為甚麼詞彙會造成這麼多問題?
因為當中有幾個詞彙所指的是不同層級的事物,但看起來都像處於同一層級。
Business Portfolio 內含 WhatsApp Business Account,而 WhatsApp Business Account 內含多個電話號碼,每個號碼都有 phone number id。在日常對話中,這四者都會被稱為帳戶,因此「檢查帳戶是否正常運作」一句話,可能代表四種不同的檢查。本平台的兩個二十四小時時段也有同樣問題,它們衡量互不相關的事物,卻經常被混為一談。
另一半原因是,Meta 和服務供應商對同一事物使用不同詞彙,而各服務供應商之間也沒有統一說法。本頁在有 Meta 原有詞彙時會採用該詞彙,並在詞彙由我們定義時直接說明。
哪些區分在實際使用中最重要?
有三項,而且每一項都曾令某人浪費一天時間。
客戶服務時段和同步時段都是二十四小時,但兩者完全無關。前者決定自由格式訊息能否送達,時間由客戶上次發送訊息起計。後者決定仍能否提取聊天記錄,時間則由啟用流程起計。
已連接裝置不是 API。它是登入於其他地方的消費者 WhatsApp 用戶端,也正是非官方工具自動操作的對象,並會導致號碼被封鎖。
Webhook 目的地也不是號碼上的設定,而是應用程式訂閱帳戶時的覆寫設定。因此,移除連接後它會消失,重新連接時必須再次設定。
常見問題
Coexistence 是不同於 Cloud API 的另一個 API 嗎?
不是。Coexistence 是將號碼啟用至 Cloud API 的方式,同時保留 WhatsApp Business 應用程式在該號碼上的運作。端點、訊息格式及規則完全相同。
Business Portfolio 和 WABA 有甚麼分別?
Business Portfolio 是 Meta Business Manager 內公司層級的容器。WhatsApp Business Account 位於其中,並持有電話號碼。一個 Business Portfolio 可以持有多個 WABA。
BSP 和 Tech Provider 是同一回事嗎?
兩者有重疊,但指的是不同事物。Tech Provider 是 Meta 授予的身分,容許公司透過自己的應用程式連接其他企業的號碼。BSP 通常指銷售訊息平台的公司,而該公司未必持有這項身分。
MCP 與 WhatsApp 有甚麼關係?
兩者本身沒有必然關係。MCP 是讓 AI 助手存取工具的協定,而 WhatsApp MCP 伺服器會將號碼公開為其中一項工具。它不能接收訊息,只能在收到要求時執行操作。
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用3 天內不收取任何費用。隨時取消。