easyCoexistence
登入開始免費試用
Meta Tech Provider

history Webhook 的運作原理

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

24 hours

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

2593107

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

2593108

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

傳送哪些內容

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

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

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

為何只會觸發一次

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

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

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

處理程式應如何處理

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

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

常見錯誤

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

EasyCoexistence 會在連接時間線記錄啟用流程及歷史記錄選擇,因此號碼是否同步及在哪一天同步,都是有日期的事實,不必日後重新推斷。

常見問題

會傳送多少歷史記錄?

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

群組聊天會傳送過來嗎?

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

稍後可以再次要求嗎?

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

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

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

繼續閱讀

準備開始嗎?

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

開始免費試用

驗證日期

history Webhook 的運作原理