history Webhook 的運作原理
history 會將 Coexistence 號碼現有對話一次性傳送至 API。當您在啟用流程中接受分享歷史記錄後,它會於完成註冊後送達,是整合唯一得知傳送已完成的訊號。
傳送哪些內容
它會傳送號碼在 WhatsApp Business 應用程式中已有的一對一訊息記錄,讓軟件在企業使用多年後的號碼上運作時,不會毫無背景。
群組對話不會隨之傳送,因為 Coexistence 號碼完全不能在 API 使用群組對話;應用程式本身的工具也不會傳送,包括標籤、快速回覆、問候訊息及離開訊息。這些功能沒有 API 對應項目,會保留在裝置上。
此欄位只存在於 Coexistence 號碼。以一般方式完成註冊的號碼沒有可供傳送的應用程式歷史記錄,因此沒有內容可傳送。
為何只會觸發一次
因為傳送是啟用流程的一部分,而不是持續提供的功能。
企業擁有人會在 Embedded Signup 期間被詢問是否分享現有對話。回答「是」才會允許同步執行;之後沒有任何設定可以重新開啟,也沒有端點可以再次執行。第二次嘗試會傳回 2593107,而不是等待後便會清除的限流錯誤。
此外還有期限。同步必須在完成註冊後 24 小時內開始,較後嘗試會傳回 2593108。錯過任何一項,都必須中斷號碼連接,重新執行整個流程。
處理程式應如何處理
將它視為只會送達一次、可能容量很大的批次,而不是訊息路徑上的額外流量。
- 快速確認接收並以非同步方式處理,與其他傳送相同。
- 按訊息 ID 去重:history 與即時訊息可能在完成註冊前後重疊。
- 預期它可能不存在。擁有人拒絕分享歷史記錄的號碼不會在此傳送任何內容,整合必須在兩種情況下都能運作。
- 不要以它完成為啟用流程的條件。傳送完成前,連接已可使用。
常見錯誤
- 建立必須有歷史記錄才能運作的整合。許多號碼連接時並沒有歷史記錄。
- 在 2593107 後重試同步。這是一次性事件,因此重試會傳回相同錯誤。
- 等到整合工作開始後才決定是否分享歷史記錄,而那通常已經超過 24 小時期限。
EasyCoexistence 會在連接時間線記錄啟用流程及歷史記錄選擇,因此號碼是否同步及在哪一天同步,都是有日期的事實,不必日後重新推斷。
常見問題
會傳送多少歷史記錄?
近期一對一對話的時段,由 Meta 設定,而不是由供應商設定。
群組聊天會傳送過來嗎?
不會。Coexistence 號碼完全不能在 API 使用群組對話。
稍後可以再次要求嗎?
不可以。每次啟用流程只會執行一次,再次執行必須中斷並重新連接號碼。
如果擁有人拒絕分享歷史記錄,會怎樣?
此欄位不會傳送任何內容,API 只會看到號碼連接後收到的訊息。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期