支援

解決疑難

訊息未能送達

以下情況可能會導致訊息顯示為「已傳送」而非「已送達」。根據私隱和政策要求,我們會出於以下多種原因不披露錯誤的根本原因

  • 顧客 30 天沒有上線,而我們會在此期間為離線顧客保留訊息。
  • 顧客已封鎖商家電話號碼或該商家擁有的其他商家電話號碼。

在有些情況下,API 會傳回錯誤代碼和說明錯誤性質的錯誤訊息。此類情況範例如下:

  • 要求參數無效
  • 完整性錯誤
  • 顧客尚未接受我們的新版《服務條款》和《私隱政策》。請向用戶傳送此連結以接受最新的《服務條款》:https://wa.me/tos/20210210
  • 顧客正在使用舊版 WhatsApp。顧客應使用以下或較新版本:
    • Android:2.21.15.15
    • SMBA:2.21.15.15
    • iOS:2.21.170.4
    • SMBI:2.21.170.4
    • KaiOS:2.2130.10
    • 網頁版:2.2132.6
  • 顧客屬於實驗群組。
  • 訊息未有送達以創造優質用戶體驗。請查看每位用戶的營銷範本訊息限制

可行解決方案

使用非 WhatsApp 通訊方式,請 WhatsApp 用戶執行以下操作:

  • 確認他們確實可以向您的 WhatsApp 商家電話號碼傳送訊息
  • 確認他們沒有將您的任何 WhatsApp 商家電話號碼加入已封鎖號碼清單(設定 > 私隱 > 已封鎖已封鎖聯絡人
  • 確認他們已接受我們的最新版《服務條款》(如果顧客尚未接受,設定 > 幫助設定 > 應用程式資訊將提示他們接受最新版的條款/政策)
  • 更新至 WhatsApp 用戶端的最新版本

國家/地區限制

古巴、伊��、北韓、敍利亞和烏克蘭三個受到制裁地區(克里米亞、頓內次克和盧甘斯克)的商家不符合資格使用 WhatsApp Business 平台。

位於古巴、伊朗、北韓、敍利亞和烏克蘭三個受到制裁地區(克里米亞、頓涅茨克和盧甘斯克)的 WhatsApp Messenger(即「WhatsApp」)及 WhatsApp Business 應用程式用戶不符合資格接收經由 WhatsApp Business 平台傳送的訊息。

由 2024 年 5 月 15 日起,土耳其的雲端 API 商務式訊息功能不再受限。雲端 API 企業現可使用土耳其號碼展開對話並接收 WhatsApp用戶的訊息。

Webhooks

訊息傳送狀態有所衝突

在特殊情況下,同一訊息可能同時觸發成功和失敗的訊息狀態更新 Webhooks。舉例來說,訊息可能觸發 "status":"delivered" 的訊息 Webhooks,同時觸發���一個 "status":"failed" Webhook。當顧客在多部裝置上登入 WhatsApp,而訊息僅成功送達其中一部裝置時,這種情況便可能會發生。任何訊息如觸發了 "delivered" 訊息狀態 Webhook,則已送達到用戶最少一部裝置上。

錯誤代碼 2:API 服務

更新 API 時,您可能會經歷最多 5 分鐘的停機時間。在這段時間內,服務無法使用。我們嘗試儘可能減輕此類更新對商家的干擾,但您最終仍有可能會受到影響

如何除錯

我們建議您等待 5 分鐘,然後再次發起 API 呼叫。

驗證和授權錯誤

如果您在 API 呼叫中使用的存取憑證發生問題,系統便會回傳此類錯誤。

如何除錯

您可以直接在存取憑證除錯工具貼上所用的存取憑證。然後,檢查您是否已選擇 whatsapp_business_managementwhatsapp_business_messaging 權限。

如果您的憑證無法存取權限,您需要產生新憑證。產生新憑證時,請確保您選擇以下項目:

  • 用於 API 呼叫的 Meta 應用程式
  • 以下權限:whatsapp_business_managementwhatsapp_business_messaging

常見問題

一般常見問題

WhatsApp develops and operates the WhatsApp Business API, which enables businesses to communicate with WhatsApp consumer users on the WhatsApp network. When using the Cloud API, Meta will host the WhatsApp Business API for you and provide an endpoint for the WhatsApp service for your incoming and outgoing WhatsApp communications.

Access to Cloud API is free, and we expect it to generate additional cost savings for developers, as Meta hosts and maintains the Cloud API.

We want to make it clear what it means to message with a business on WhatsApp. Some businesses may choose to use Meta or another company to help them manage and store their messages. When a business chooses to manage their messages with another company, we will let consumers know by showing a different system message. Learn more.

技術實施常見問題

The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.

Solution Partners and direct clients do not need the WebApp and CoreApp containers that are used in the On-Premises API. Meta will manage all database data and media data on behalf of the Solution Partner or direct client.

As your on-premises performance depends heavily on your hardware, software, and connectivity to WhatsApp servers, if you wish to understand these differences, you can perform your own load tests on Cloud API as you might have done for your own on-premises installation. You can also refer to our performance comparison to understand more details around how the on-premise and Cloud APIs compare.

Migrating between the on-premises and Cloud APIs is seamless, and can be done bidirectionally. See migration details for more information.

可靠度常見問題

請參閱我們的 WhatsApp Business API 狀態頁面 ,獲取雲端 API 的具體可觀測性衡量數據。

運作時間值每天更新一次。

在某些情況下,特定用戶錯誤可能會自動被錯誤計入停機時間。在這些情況下,在經過為期一週以內的詳細分析後,我們會覆寫這些停機時間為運作時間。

這可能是因為出現了一些不影響我們全球可用性的問題。在這種情況下,WhatsApp Business API 狀態頁面將顯示一個狀態,反映可能存在一些不影響全球可用性的干擾。請提交 直接支援(服務) 案件,以便我們深入調查。

在某些情況下,系統或許未能自動追蹤停機時間而判斷為有服務:

  • 網絡問題,導致要求在到達 Graph API 層(第一層)之前便已失敗。
  • 網絡問題,導致連外 Webhooks 無法到達企業的 Webhooks 端點。

於此時間點後而進入系統之前出現的所有問題,都會顯示為「錯誤」或「未能成功」。此外,系統會在第一次嘗試發出 Webhooks 遇到問題後繼續重試,直至成功傳遞至 Webhooks 端點。

執行手動偵測後,可用性管理中心內顯示的其他情況包括(非系統錯誤):

  • 合法要求只要驗證或授權失敗,系統都會將其判定為驗證憑證(帳戶安全檔案庫)等 Meta 驗證問題。
  • 拒絕合法要求的驗證。

在這兩種情況下,WhatsApp 都會在事後近乎即時偵測這些問題並找出源頭所在,但並非真的即時處理。

在運作時間和/或延遲時間方面,我們目前並未提供商用產品服務水平協議。

We will have disaster recovery and data replication across multiple regions. The expected downtime would be within our SLA and usually in the order of less than a minute to less than five minutes.