登入開始免費試用
easyCoexistence 官方 API

Partner API 限制與規則:Meta 政策、每秒 20 則訊息及 14 天規則

透過 easyCoexistence 的 Partner API 連接的 Coexistence 號碼,每秒最多發送 20 則訊息,此速率由 Meta 訂定。若其手機約 14 天不活動,Meta 會斷開該號碼。平台代客戶連接其帳戶,因此須代其遵守各網絡的規則:在 WhatsApp 上,須於 24 小時客戶服務時段內回覆,時段以外只可使用 Meta 已批准的訊息範本,不得發送垃圾訊息,亦不得在號碼上運行通用 AI 聊天機械人。

20 mps

Meta 為同時使用 WhatsApp Business 應用程式及 Cloud API 的號碼所訂定的固定吞吐量。

80 mps

僅使用 API 的號碼預設的 Cloud API 吞吐量,可自動提升至 1,000。

About 14 days

持有 WhatsApp Business 應用程式的手機不活動後,Meta 斷開號碼的時限,原因為 PRIMARY_INACTIVITY。

24 hours

用戶的訊息所開啟的客戶服務時段;時段以外,企業只可發送已批准的訊息範本。

250

新 Business Portfolio 的訊息上限:每滾動 24 小時內,可在服務時段以外觸達的人數。

平台應遵守誰的規則?

每個網絡的規則,適用於平台所連接的每位客戶。帳戶運行於各網絡的官方 API 之上,而規則約束您的軟件透過其發送及發布的內容。在 WhatsApp 上,Meta 的執行行動會落在客戶的 WhatsApp Business 帳戶,以及號碼所連接的應用程式上,這也是違反 Meta 規則會導致平台的 API 金鑰被終止的原因。

WhatsApp 適用哪些 Meta 規則?

Meta 的訊息規則,由為企業發送訊息的軟件遵守:

  • 自由格式回覆只限於用戶最後一則訊息後 24 小時內;用戶每發一則新訊息,時段便重新開始。
  • 時段以外,只可使用 Meta 已批准的訊息範本。
  • 只可發送給已同意接收企業訊息的人。
  • 不得發送垃圾訊息,號碼上亦不得運行通用 AI 聊天機械人。
  • 時段以外的觸達數以 Business Portfolio 計算:新的 Business Portfolio 起始上限為每滾動 24 小時 250 人。

Coexistence 號碼的發送速度如何?

每秒 20 則訊息,這是 Meta 訂定的固定速率,以確保號碼與 WhatsApp Business 應用程式保持兼容。僅使用 Cloud API 的號碼起步為 80,並可自動提升至 1,000,但 Coexistence 號碼維持在 20。Business Portfolio 的訊息上限另外適用,計算在服務時段以外觸達的人數。

什麼是 14 天規則?

當持有 WhatsApp Business 應用程式的手機約 14 天不活動,Meta 便會斷開 Coexistence 號碼,原因為 PRIMARY_INACTIVITY。easyCoexistence 會監察每個號碼,並向您的 events URL 發送 connection.disconnected,當中載有該原因。解決方法是為該客戶提供新的連接連結:客戶用同一號碼再次完成流程,號碼便會重新連接。

Meta 還會回報哪些斷線原因?

Meta 結束號碼的連接時,若已知原因,connection.disconnected 會附上 Meta 的原因代碼。除 PRIMARY_INACTIVITY 外,Meta 另列出以下原因:

  • ACCOUNT_DISCONNECTED:Meta 執行,或客戶刪除了其 WhatsApp 帳戶;由用戶或系統發起。
  • CHANGE_NUMBER:客戶更改了電話號碼。
  • BUSINESS_DOWNGRADE:該號碼曾註冊於個人版 WhatsApp 應用程式。
  • USER_RE_REGISTERED:客戶在新裝置上重新註冊 WhatsApp。
  • COMPANION_INACTIVITY:已連結的裝置約 30 天未被使用。

什麼情況會令 Partner API 金鑰失效?

有三種情況。您可以輪換金鑰,即時以新金鑰取代;您可以撤銷金鑰,使帳戶沒有金鑰;或 easyCoexistence 因帳戶違反 Meta 規則而終止金鑰。金鑰本身沒有到期日,一旦被終止,之後的請求均會回傳 401 unauthorized。

連接會話有哪些限制?

一個帳戶可同時開啟 50 個連接會話,每小時最多建立 100 個。Meta 將每次首次入職都計入整個應用程式的上限,而所有 easyCoexistence 帳戶共用該上限,因此這些上限可防止某個平台的大量匯入耗盡所有人的配額。上限會回傳 429 cap_reached 或 rate_limited。

社交網絡設有哪些規則?

各網絡自行訂定的規則,適用於客戶所連接的帳戶,而其差異大致相同,可歸納為以下幾方面:

  • 訊息時段:Instagram 及 Facebook 私訊可在標準時段內回覆,通常為用戶最後一則訊息後 24 小時。
  • 每個帳戶的發布上限及 API 配額各有不同,視網絡而定。
  • 存取權杖有效期:部分網絡發出的存取權杖只維持一小時或一天,由 easyCoexistence 負責更新。
  • 同意:帳戶擁有人可隨時在該網絡的設定中撤回存取權,並會收到 channel.disconnected。
  • 功能:TikTok、YouTube 及 LinkedIn 在此不提供私訊,而 easyCoexistence 不接收來自 YouTube 或 LinkedIn 的留言事件。

常見錯誤

  • 從同一個 Coexistence 號碼成批發送。Meta 將其限定於每秒 20 則訊息,因此應以該速率為每個號碼排隊發送,而不是一次過全部發出。
  • 依賴 WhatsApp Business 應用程式發送範本。在 Coexistence 中,只有 API 能發送範本,因此任何 24 小時時段以外的訊息,都必須經由您的後端發出。
  • 儲存社交網絡的存取權杖以備日後使用。部分權杖只維持一小時或一天,因此每項任務開始時,都應向 easyCoexistence 重新提取憑證。
使用 EasyCoexistence 完成這項設定

easyCoexistence 透過各網絡的官方 API 連接您客戶的 WhatsApp 號碼,以及其 Instagram、Facebook、TikTok、YouTube 及 LinkedIn 帳戶,並可連接更多渠道。當其中一個斷開時,會以經簽署的事件通知您的平台,若已知原因,便會附上原因。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。

常見問題

COMPANION_INACTIVITY 是什麼意思?

已連結的裝置約 30 天未被使用,這是 Meta 斷開號碼的其中一個原因。

若我的平台違反 Meta 的規則,我的客戶會怎樣?

Meta 的執行行動會落在客戶的 WhatsApp Business 帳戶,以及其號碼所連接的應用程式上;easyCoexistence 亦會終止違反規則的帳戶的 API 金鑰。

14 天規則適用於社交帳戶嗎?

不適用。這是 Meta 針對在 WhatsApp Business 應用程式與 API 之間共用的號碼所訂的規則。社交帳戶在網絡拒絕其存取權杖,或擁有人撤回存取權時斷開,並會收到 channel.disconnected。

各網絡的限制是否不同?

是的。各網絡分別訂定其訊息時段、發布上限、API 配額及存取權杖有效期,並與適用於您自己帳戶的方式相同,同樣適用於您所連接的帳戶。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期