登入開始免費試用
Meta Tech Provider

一個號碼。應用程式和 API,同時使用。

Coexistence 是 Meta 的官方模式,讓 WhatsApp Business 應用程式和 Cloud API 同時在同一個號碼上運作。團隊繼續用手機回覆,對話和紀錄都不變,同時軟件在同一條線路上收發訊息。

EasyCoexistence 連接號碼後持續監察連接。

開始免費試用免費 3 天。試用結束前不收取任何費用。
+1 415 555 0188
WhatsApp Business 應用程式團隊照常用手機回覆
Cloud API您的系統或 AI 助理,使用同一條線路
兩端看到的是同一個對話。API 發送的內容會出現在應用程式中,團隊在應用程式中輸入的內容會以 smb_message_echoes 事件送達,因此軟件絕不會在已經有人回覆之後再重複回覆。
預設不儲存訊息Business 應用程式 + Cloud API供 Claude 及 ChatGPT 使用的 MCP2 分鐘內開始運作

以往必須作出的選擇,如今不再需要

Coexistence 不是一個新的 API。它移除了一個分岔路口,而正是這個分岔路口令幾乎所有小型企業都無法實現任何自動化。

以前一個號碼,只能二選一
保留應用程式

團隊用手機回覆。無法自動化、無法連接系統,也無法量度。

沒有 API
遷移到 API

軟件可以存取這個號碼。Business 應用程式在該號碼上停止運作,團隊只能轉用其他工具。

沒有應用程式
現在一個號碼,兩者兼得
一個號碼
WhatsApp Business 應用程式Cloud API

Meta 將 Cloud API 連接到一個仍在使用 WhatsApp Business 應用程式的號碼。兩端在同一條線路上同時運作,並且都能看到對方發送的內容。

誰會這樣使用號碼

兩類用戶,對同一功能有著相反的需求,因此連接本身比其上的任何控制台都更重要。

保留手機只有一個號碼的企業

一個小團隊,一個印在貨車或店面上的號碼,每晚都在回答同樣的四個問題。他們不是要取代任何人。他們希望確認訊息、提醒和下班後的第一則回覆無需人手即可完成,而手機仍然照常處理其他一切。

多個號碼,一個帳戶代理商、顧問公司或開發人員

客戶眾多,每位客戶都有一個不准遷移、也不能改動的號碼。他們需要讓自己建立的系統能夠存取這些號碼,並且無需銷售會議就能加入下一個號碼。對於客戶員工仍在人手回覆的號碼,Coexistence 是唯一的官方接入途徑。

號碼如何同時用於兩端,以及訊息事件流向何處

共四個步驟。唯一需要用到手機的是一次掃描,而決定您系統架構的是第一步。

  1. 在開始接入之前準備好端點

    Meta 在向目的地傳遞內容之前會先驗證它。它會向您的 URL 發出一個 GET 請求,其中帶有 hub.mode=subscribe、您的 hub.verify_token 和一個 hub.challenge,您的端點必須原樣傳回這個 challenge 值。

    目的地必須使用 HTTPS,而且必須提供驗證權杖。我們會在發出呼叫之前檢查這兩項,因此格式錯誤的 URL 會在我們這一關就失敗,而不會看似已經連接、實際上卻甚麼也收不到。

    前提
    一個能在 Meta 發出 GET 請求時傳回 hub.challenge 的 HTTPS 端點
    耗時
    約 1 分鐘
    結果
    號碼一連接,Meta 就能立即驗證的目的地
    此時還沒有任何連接。這一步決定訊息最終送達哪裡。
    路徑中有服務供應商儲存在他們的伺服器上
    Meta
    他們的平台接收並儲存訊息
    您一份副本,按他們的時間表送達
    EasyCoexistence只限設定
    Meta
    您的端點尚未驗證
    我們我們設定路由,但不在路由上
  2. 執行 Meta 的 Embedded Signup,並在應用程式中掃描

    Meta 自己的彈出視窗會開啟。您選擇 Business Portfolio、WhatsApp Business 帳戶,以及已經在 WhatsApp Business 應用程式中註冊的號碼,然後在手機上掃描代碼以批准連接。

    您也在這一步選擇是否分享現有對話紀錄。這是接入時的一次性決定,之後無法更改。掃描完成的一刻,Business 應用程式就會照常繼續運作。

    前提
    Business Portfolio 的存取權限,以及使用該號碼的手機
    耗時
    2 至 3 分鐘
    結果
    Cloud API 連接到一個應用程式仍在使用的號碼上
    第二端出現了,第一端並沒有被移除。
    遷移之後只有一端
    該號碼
    只有 Cloud API該號碼上的 Business 應用程式已無法使用
    使用 Coexistence 之後兩端並存
    該號碼
    WhatsApp Business 應用程式相同的對話和紀錄
    Cloud API在同一條線路上
  3. 將訊息事件指向您自己的系統

    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。因此控制台依然有用,而對話內容從不經過我們。

    前提
    第 1 步中的端點,現已通過 Meta 驗證
    耗時
    接入完成後立即生效
    結果
    訊息由 Meta 直接傳遞給您,我們不在訊息路徑上
    覆寫設定生效後,各類事件的去向。
    營運事件傳遞給我們
    account_update連接狀態變化
    phone_number_quality_update品質和吞吐量
    account_review_update審查結果
    訊息路徑傳遞給您
    messages客戶發送的所有內容
    smb_message_echoes團隊從應用程式發送的內容
    您的伺服器直接送達,從不經過我們
  4. 保持連接活躍,並在重新連接後依然有效

    主裝置連續約 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 政策而改變。
自由文字客戶最後一則訊息後的 0 至 24 小時只限範本之後,直至客戶再次發來訊息
客戶每發送一次訊息,計時就會重新開始。這條規則會令整合在正式環境中出問題,因為測試總是在一則訊息之後幾秒內進行,那時自由文字仍然可以發送。

哪些內容轉發給您,哪些由我們保留

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 應用程式都照常運作,所以沒有人察覺。以下是我們檢查的問題,以及檢查方式。

號碼已中斷連接Webhook,權威來源

透過 Meta 的 account_update Webhook 偵測,具體是 PARTNER_REMOVED,而不是根據某個欄位變為 false 來推斷。我們刻意不讀取 is_on_biz_app 來作判斷,因為它在非 Coexistence 號碼上本來就是 false,曾導致誤報中斷。

連接已沉寂 14 天獨立狀態

這是 Meta 的主裝置不活動規則。連接可以恢復,因此它被記錄為一種獨立狀態,而不是流失的客戶,重新連接即可恢復發送和監察。

重新連接後,您的 Webhook 路由消失了自動重新套用

目的地是我們的應用程式對該帳戶訂閱上的一項覆寫設定,因此中斷連接會將其解除安裝。重新連接後發送會恢復,但傳遞到您伺服器的訊息不會恢復。我們每次都會重新套用這項覆寫設定,因為曾有一個號碼遇到這種情況:順利重新連接,卻無聲無息地停止了傳遞。

存取權杖失效兩個權杖,一個答案

我們針對同一個帳戶同時持有客戶的權杖和我們自己的 System User token。當其中一個被拒絕時,另一個會讀取帳戶,判斷究竟是哪一個出了問題,因此被撤銷的權杖不會再被誤認為是遺失的號碼。

品質下降輪詢

定期向 Meta 輪詢。RED 評級會將連接標記為降級,每次檢查都會記錄品質、訊息級別和吞吐量級別,因此在品質下降導致發送失敗之前就能看到。

連接一個號碼和監察一個號碼是兩種不同的產品。我們正是為了後者而存在。

2 minutes

連接號碼通常所需時間,從 WhatsApp Business 應用程式掃描代碼。

24 hours

客戶回覆後,自由格式訊息回覆的工作階段可維持多久。

20 msg/s

Coexistence 號碼的傳送吞吐量,由 Meta 固定且無法提高。

6 months

號碼首次連接時,Meta 會同步多少聊天記錄至 API。

常見問題

我的團隊是否必須停止使用電話?

不用。這正是 Coexistence 的全部意義。WhatsApp Business 應用程式會在同一號碼上繼續運作,保留相同對話,而 API 同時在旁運作。

我會失去現有對話嗎?

不會。對話會留在應用程式內,而號碼連接時,Meta 會將約 6 個月的歷史記錄同步至 API,因此軟件能掌握背景,不會從空白開始。

可以取消嗎?

可以。號碼可以中斷連接,而應用程式會如常繼續運作。連接不會永久改變號碼本身。

這是否與非官方 WhatsApp API 相同?

不是,而兩者的差異會決定號碼能否保留。Coexistence 是 Cloud API 上的 Meta 官方功能。非官方閘道會把 WhatsApp Web 當作已連接裝置使用,違反條款,並導致號碼被封鎖。

準備開始嗎?

幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。

開始免費試用免費 3 天。試用結束前不收取任何費用。

繼續閱讀