一個號碼。應用程式和 API,同時使用。
Coexistence 是 Meta 的官方模式,讓 WhatsApp Business 應用程式和 Cloud API 同時在同一個號碼上運作。團隊繼續用手機回覆,對話和紀錄都不變,同時軟件在同一條線路上收發訊息。
EasyCoexistence 連接號碼後持續監察連接。
以往必須作出的選擇,如今不再需要
Coexistence 不是一個新的 API。它移除了一個分岔路口,而正是這個分岔路口令幾乎所有小型企業都無法實現任何自動化。
團隊用手機回覆。無法自動化、無法連接系統,也無法量度。
沒有 API軟件可以存取這個號碼。Business 應用程式在該號碼上停止運作,團隊只能轉用其他工具。
沒有應用程式Meta 將 Cloud API 連接到一個仍在使用 WhatsApp Business 應用程式的號碼。兩端在同一條線路上同時運作,並且都能看到對方發送的內容。
誰會這樣使用號碼
兩類用戶,對同一功能有著相反的需求,因此連接本身比其上的任何控制台都更重要。
一個小團隊,一個印在貨車或店面上的號碼,每晚都在回答同樣的四個問題。他們不是要取代任何人。他們希望確認訊息、提醒和下班後的第一則回覆無需人手即可完成,而手機仍然照常處理其他一切。
客戶眾多,每位客戶都有一個不准遷移、也不能改動的號碼。他們需要讓自己建立的系統能夠存取這些號碼,並且無需銷售會議就能加入下一個號碼。對於客戶員工仍在人手回覆的號碼,Coexistence 是唯一的官方接入途徑。
號碼如何同時用於兩端,以及訊息事件流向何處
共四個步驟。唯一需要用到手機的是一次掃描,而決定您系統架構的是第一步。
在開始接入之前準備好端點
Meta 在向目的地傳遞內容之前會先驗證它。它會向您的 URL 發出一個 GET 請求,其中帶有 hub.mode=subscribe、您的 hub.verify_token 和一個 hub.challenge,您的端點必須原樣傳回這個 challenge 值。
目的地必須使用 HTTPS,而且必須提供驗證權杖。我們會在發出呼叫之前檢查這兩項,因此格式錯誤的 URL 會在我們這一關就失敗,而不會看似已經連接、實際上卻甚麼也收不到。
此時還沒有任何連接。這一步決定訊息最終送達哪裡。 路徑中有服務供應商儲存在他們的伺服器上他們的平台接收並儲存訊息您一份副本,按他們的時間表送達EasyCoexistence只限設定您的端點尚未驗證我們我們設定路由,但不在路由上執行 Meta 的 Embedded Signup,並在應用程式中掃描
Meta 自己的彈出視窗會開啟。您選擇 Business Portfolio、WhatsApp Business 帳戶,以及已經在 WhatsApp Business 應用程式中註冊的號碼,然後在手機上掃描代碼以批准連接。
您也在這一步選擇是否分享現有對話紀錄。這是接入時的一次性決定,之後無法更改。掃描完成的一刻,Business 應用程式就會照常繼續運作。
第二端出現了,第一端並沒有被移除。 遷移之後只有一端只有 Cloud API該號碼上的 Business 應用程式已無法使用使用 Coexistence 之後兩端並存WhatsApp Business 應用程式相同的對話和紀錄Cloud API在同一條線路上將訊息事件指向您自己的系統
Meta 容許應用程式覆寫某個 WhatsApp Business 帳戶傳遞 Webhook 的位置。我們將這項覆寫設定指向您的 URL,從而讓 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 覆寫設定隨應用程式一併被解除安裝向您傳遞訊息無聲無息地停止我們重新套用每次重新連接時
為甚麼團隊會這樣使用號碼
- 保留已經印在貨車、收據和網站上的號碼,以及圍繞它的手機工作流程。
- 加入 API 發送、Webhook 處理和訊息範本,無需讓任何人轉用新工具。
- 讓訊息流量不經過服務供應商的共用收件匣,這樣對話就不會存放在別人的平台上。
- 讓代理商可以在一個帳戶中管理眾多客戶的號碼,每個號碼都連接在客戶自己的 Business Portfolio 中。
資格要求與實際限制
- 號碼必須已經在 WhatsApp Business 應用程式中啟用。使用一般 WhatsApp 應用程式的號碼需要先轉移到 WhatsApp Business 應用程式。
- 是否分享現有對話紀錄是在接入過程中作出的一次性選擇,之後無法更改。
- 在所有服務供應商中,Coexistence 號碼的群組對話都不在 API 範圍內。
- 主裝置需要定期活動。如果連續約 14 天沒有活動,Meta 會中斷連接。
- Coexistence 號碼的 Meta 驗證和徽章流程有所不同,各地區的可用性亦會隨 Meta 政策而改變。
哪些內容轉發給您,哪些由我們保留
Meta 容許應用程式覆寫 WhatsApp Business 帳戶傳遞 Webhook 的位置。我們將這項覆寫設定指向您的 URL,從而把事件分成兩部分。
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 應用程式都照常運作,所以沒有人察覺。以下是我們檢查的問題,以及檢查方式。
透過 Meta 的 account_update Webhook 偵測,具體是 PARTNER_REMOVED,而不是根據某個欄位變為 false 來推斷。我們刻意不讀取 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 天。試用結束前不收取任何費用。