登入開始免費試用
Meta Tech Provider

history Webhook 的運作原理

history 會將 Coexistence 號碼現有對話一次性傳送至 API。當您在啟用流程中接受分享歷史記錄後,它會於完成註冊後送達,是整合唯一得知傳送已完成的訊號。

EasyCoexistence 會在連接時間線記錄啟用流程及向 Meta 要求歷史記錄的日期,因此何時要求同步是有日期的事實,不必日後重新推斷。

24 hours

完成註冊後必須開始同步的時限。

2593107

同步已使用時傳回的錯誤。

2593108

在時限外嘗試時傳回的錯誤。

傳送哪些內容

它會傳送號碼在 WhatsApp Business 應用程式中已有的一對一訊息記錄,讓軟件在企業使用多年後的號碼上運作時,不會毫無背景。

群組對話不會隨之傳送,因為 Coexistence 號碼完全不能在 API 使用群組對話;應用程式本身的工具也不會傳送,包括標籤、快速回覆、問候訊息及離開訊息。這些功能沒有 API 對應項目,會保留在裝置上。

此欄位只存在於 Coexistence 號碼。以一般方式完成註冊的號碼沒有可供傳送的應用程式歷史記錄,因此沒有內容可傳送。

為何只會觸發一次

因為傳送是啟用流程的一部分,而不是持續提供的功能。

企業擁有人會在 Embedded Signup 期間被詢問是否分享現有對話。回答「是」才會允許同步執行;之後沒有任何設定可以重新開啟,也沒有端點可以再次執行。第二次嘗試會傳回 2593107,而不是等待後便會清除的限流錯誤。

此外還有期限。同步必須在完成註冊後 24 小時內開始,較後嘗試會傳回 2593108。錯過任何一項,都必須中斷號碼連接,重新執行整個流程。

處理程式應如何處理

將它視為只會送達一次、可能容量很大的批次,而不是訊息路徑上的額外流量。

  • 快速確認接收並以非同步方式處理,與其他傳送相同。
  • 按訊息 ID 去重:history 與即時訊息可能在完成註冊前後重疊。
  • 預期它可能不存在。擁有人拒絕分享歷史記錄的號碼不會在此傳送任何內容,整合必須在兩種情況下都能運作。
  • 不要以它完成為啟用流程的條件。傳送完成前,連接已可使用。

常見錯誤

  • 建立必須有歷史記錄才能運作的整合。許多號碼連接時並沒有歷史記錄。
  • 在 2593107 後重試同步。這是一次性事件,因此重試會傳回相同錯誤。
  • 等到整合工作開始後才決定是否分享歷史記錄,而那通常已經超過 24 小時期限。
使用 EasyCoexistence 完成這項設定

常見問題

會傳送多少歷史記錄?

近期一對一對話的時段,由 Meta 設定,而不是由供應商設定。

群組聊天會傳送過來嗎?

不會。Coexistence 號碼完全不能在 API 使用群組對話。

稍後可以再次要求嗎?

不可以。每次啟用流程只會執行一次,再次執行必須中斷並重新連接號碼。

如果擁有人拒絕分享歷史記錄,會怎樣?

此欄位不會傳送任何內容,API 只會看到號碼連接後收到的訊息。

繼續閱讀

準備開始嗎?

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

開始免費試用

驗證日期