內部部署 API 變更記錄封存

WhatsApp Business API 用戶端

2023 年

2023 年 9 月 26 日（v2.49.5）

2.49.5 版本現已推出，當中包含下列變更：

• 修復導致傳送媒體訊息時，無法清除 /tmp 資料夾內容的問題。

2023 年 9 月 15 日（v2.49.4）

2.49.4 版本現已推出，當中包含下列變更：

• 修復傳送範本訊息時出現的效能降低問題。此問題只影響使用 v2.49.1、v2.49.2 及 v2.49.3，而且擁有大量範本的帳戶；v2.47.x 系列則不受此問題影響。

2023 年 8 月 11 日（v2.49.3）

2.49.3 版本現已推出，當中包含下列變更：

• 修復系統為不應該建立 Webhooks 的訊息產生空白 Webhook 通知的問題。
• 解決核心應用程式卡頓的問題。

2023 年 7 月 31 日（v2.49.2）

2.49.2 版本現已推出，當中包含下列變更：

• 修復阻止垃圾回收器刪除已處理訊息的問題。
• 修復 24 小時訊息收發階段延遲開始的問題。

2023 年 7 月 11 日（v2.49.1）

2.49.1 版本現已推出，當中包含下列變更：

• 改進了垃圾回收器，現可清除未使用的傳出和傳入媒體。
• 引入用於儲存傳入媒體的新端點。此端點允許在收到媒體訊息時，下載未下載（或下載失敗）的媒體
• 如果不允許使用參數，則嘗試傳送現有驗證類別範本時會傳回錯誤代碼 1009。詳情請查閱驗證類別範本。
• 文件訊息現在支援說明文字。
• 增加對位置訊息的支援。
• 修復阻止系統在 Webhooks 上發佈電話號碼變更通知的問題。

2023 年 7 月 28 日（v2.47.8）

2.47.8 版本現已推出，當中包含下列變更：

• 修復多個記憶體死機問題。
• 修復傳送「產品」類型互動式訊息的問題。
• 修復用戶更改電話號碼時無法收到通知的問題。

2023 年 7 月 4 日（v2.47.7）

2.47.7 版本現已推出，當中包含下列變更：

• 修復在特定場景下商家無法正確接收訊息的問題（用戶在自己裝置僅看到 1 個剔號）。

2023 年 6 月 21 日（v2.47.6）

2.47.6 版本現已推出，當中包含下列變更：

• 修復免費進入點對話的超收費用問題。此修補程式之前的所有 v2.47 版本都無法識別免費進入點對話，因此將這類對話分類為服務對話。此問題還影響免費進入點對話的時長，導致系統誤將其視為持續 24 小時，而非 72 小時。
• 修復多個記憶體死機問題。
• 修復在特定情況下收不到送達證明的問題。

2023 年 5 月 22 日（v2.47.3）

2.47.3 版本現已推出，當中包含下列變更：

• 修復在收到無效訊息時可能出現的不常見當機問題。
• 修復未註冊核心應用程式的 100% CPU 使用率問題。
• 修復記憶體流失問題。

2023 年 5 月 22 日（v2.45.5）

2.45.5 版本現已推出，當中包含下列變更：

• 修復記憶體流失問題。

2023 年 5 月 15 日（v2.47.2）

2.47.2 版本現已推出，當中包含下列變更：

• 修復可能導致核心應用程式停止運作並出現故障的當機問題。
• 修復在同時收到大量訊息時可能導致 Webhook 本體無內容的問題。

2023 年 5 月 15 日（v2.45.4）

2.45.4 版本現已推出，當中包含下列變更：

• 修復了可能導致核心應用程式停止運作並出現故障的當機問題。

2023 年 4 月 11 日（v2.47.1）

2.47.1 版本現已推出，當中包含下列變更：

• 媒體上載可靠程度

  • 改善了媒體上載流程，修復了傳送媒體訊息時發生的數個已知邊緣案例。
• 在 WhatsApp 上收款（此功能僅在新加坡提供）

  • 商家現可在 WhatsApp 向訂單顧客收取 Stripe 付款。請參閱我們的開發人員文件以了解更多資訊。

2023 年 3 月 24 日（v2.45.3）

2.45.3 版本現已推出，當中包括以下更新：

• 修復了阻止多連接設定從 v2.41 版升級至 v2.43 版的錯誤。升級現已成功。完成升級後，運行狀況端點會傳回所有已啟動的核心應用程式的狀態。
• 修復了網頁應用程式，可以支援 IPv6 網絡。（在網頁應用程式容器設定 ENABLE_IPV6=false 環境變數以停用）。
• 修復以下錯誤：在開啟 show_security_notifications 選項時，我們可能收到 unknown_system 訊息，而非收到通知展示身分有變的用戶其資訊。

2023 年 3 月 17 日（v2.43.3）

2.43.3 版本現已推出，當中包括以下變更：

• 修復了阻止多連接設定從 v2.41 版升級至 v2.43 版的錯誤。升級現已成功。完成升級後，運行狀況端點會傳回所有已啟動的核心應用程式的狀態

2023 年 3 月 9 日（v2.45.2）

2.45.2 版本現已推出，當中包含下列變更：

• 修復高可用性設定問題。

  • 啟動新的高可用性設定（即新容器和新資料庫）時，現在可使用個別核心應用程式上的運行狀況端點，而無需先註冊商家電話號碼。
• 修復了 /v1/payments 端點的問題。

  • 高可用性設定中現可使用 /v1/payments 端點；其不會再傳回「WhatsApp 伺服器中斷」的錯誤。
• 支援最新版本 Docker

  • 核心應用程式和網頁容器可能無法使用 containerd.io-v1.6.18 來啟動
  • 疑難排解詳情

2023 年 1 月 10 日（v2.45.1）

我們的 Business API 用戶端 2.45.1 版本現已推出，當中包含下列變更：

• 安全改善

  • 我們已更新內部部署用戶端和監察堆疊的重要依賴項目，以修復重大漏洞並使 Prometheus 監察透過安全通訊協定進行的資料傳輸。我們引入了 2 個環境變數，以用於啟用 SSL 連線的安全功能，並確保驗證網頁應用程式憑證。這些新環境變數如下：

    • WA_SKIP_SSL_VERIFICATION 將用於啟用和停用 SSL 驗證。有效值為 TRUE 或 FALSE。
    • WA_SSL_CA_PATH 提供憑證路徑，可用於驗證商家所用的網頁應用程式憑證。如果商家使用自我簽署的憑證，或者有關憑證是由商家自己的認證機構所簽署，便適合使用此變數。此處指定的路徑應能夠從容器存取，因此需要將其加為磁碟區。如果 WA_SKIP_SSL_VERIFICATION 設定為 TRUE，則可略過此值。
• 服務可靠度

  • 在尚未載入 HSM 套件的情況下嘗試傳送範本訊息時，有時會產生「無效命名空間」之類的錯誤。我們已修復此錯誤，現在如果商家在用戶端未完全準備好之前就嘗試使用通訊端點時，會遇到新錯誤「核心應用程式未準備就緒」。
• 資料庫效能改善

  • 我們透過減少用戶端和資料庫伺服器之間的來回行程，改善了資料庫查詢的執行時間。此外，我們加入了一些新的資料庫索引，以改善訊息傳送路徑上一些繁重查詢的效能。
• 穩定性和錯誤修復

  • 「已刪除訊息」Webhook 現再次投入使用。如果商家在向消費者傳送訊息後將訊息刪除，便會收到 Webhook。
  • out_message_persisted Prometheus 衡量數據經已修復並再次投入使用
  • 修復影片縮圖問題。以往在傳送影片時，縮圖有時消失不見，以及消費者在開始播放影片前看不到第一個影格。
• 在訊息 sent 狀態 Webhook 通知中加入新欄位

  • 我們在所有媒體訊息的訊息 sent 狀態 Webhooks 通知中推出了新欄位 media_id。

2022 年

2022 年 11 月 24 日（v2.43.2）

我們的 Business API 用戶端 2.43.2 版本現已推出，當中包含下列變更：

• 修復已刪除訊息 Webhooks 通知的問題
  

  1. v2.43.1 版本中的漏洞導致系統無法發出 Webhooks 通知來傳達訊息已刪除的狀態。除了 v2.43.1 中傳送此 Webhooks 通知外，其他內部清理程序不受此更新影響

2022 年 10 月 11 日（v2.43.1）

我們的 Business API 用戶端 2.43.1 版本現已推出，當中包含下列變更：

• 對 contacts 節點的變更

  • contacts 要求的回應將不再提供關於電話號碼的狀態資訊。您仍可使用 contacts，以在傳送訊息至電話號碼前預先載入聯絡資料。此變更可改善系統在傳送大量訊息時的傳送效能
• 用於封鎖聯絡人的新 API

  • 我們現推出一個新 API，以允許商家封鎖和舉報傳送猥褻內容、使用不當用語或騷擾商家員工的消費者
• 改善媒體可靠度

  • 在以高輸送量傳送同一媒體的情況下（例如在宣傳活動期間），媒體訊息傳送（包括範本媒體訊息）的可靠度得到改善
• 延長 API 逾時期限

  • API 要求的逾時期限已增加至 120 秒。此為短期緩解措施，以減少 API 用戶端仍在處理的操作之逾時次數
• 修復聯絡人傳入訊息問題

  • 傳入的聯絡人訊息現會正確顯示聯絡人的公司和部門資訊
• 穩定性和錯誤修復

  • 修復註冊後立即傳送訊息時會出現的死機問題
  • 修復網頁應用程式問題，使系統可正確處理密碼中的特殊字元
  • 在 message_receipt_log 中加入新的表格索引

2022 年 9 月 19 日（v2.41.3）

我們的 Business API 用戶端 2.41.3 版本包含下列變更：

• 在 message_receipt_log 上加入新的表格索引，這可有利具有高輸送量需要的合作夥伴，即每秒傳送超過 200 則訊息的情況

2022 年 6 月 27 日（v2.41.2）

我們的 Business API 用戶端 2.41.2 版本包含下列變更：

• 批量 /contacts 端點要求的延遲情況有所改善，死結問題亦得到解決
• 垃圾回收程序的效能和穩定性有所改善
• 商家現可啟用／停用 delivered 和 read Webhook 通知，因此能夠更好地控制訊息的 Webhook 通知。此操作可透過 settings/applications 端點完成
• 針對範本物件可選用 namespace 欄位
• 對媒體下載錯誤的處理能力更強大，讓商家在下載顧客傳送的媒體時遇到更少問題
• 提高傳送訊息和註冊工作流程的可靠性並修復其中的錯誤
• caption 屬性限制為 1024 個字元。此變更僅適用於在 v2.41.2 上傳送的媒體訊息標題，而不會影響先前使用其他版本傳送的訊息。我們未有為其他訊息類型加上字元長度限制

2022 年 5 月 10 日（v2.39.4）

此用戶端版本包含隨 v2.39.1 提供的所有功能和修正項目。此外，此版本修復了以下問題：

• 修正了在某些情況下無法傳送影片訊息的錯誤。此修復項目亦包含在 v2.39.2 中。
• 修復商家在以下情況下無法向消費者傳送訊息的錯誤：由消費者首先在 WhatsApp 上發起雙方之間的互動，且互動早在多於 7 天前發起。此修復項目亦包含在 v2.39.3 中。
• 修復使商家無法接收顧客自動刪除訊息的錯誤。限時訊息安裝 v2.39.4 後，商家會在收到限時訊息時接到通知，通知形式為 Webhooks 通知，其類型設定為 "ephemeral"。商家將無法看到訊息的內容。

在我們推出 v2.39.3 時，WhatsApp 自動在與用戶端的對話串中停用限時訊息，從而處理此類訊息問題。在 v2.39.4 中，我們不會這樣做。在使用此版本時，收到限時訊息的商家必須請顧客停用限時訊息並重新傳送最新訊息。

2022 年 3 月 25 日（v2.39.3）

我們今天正式向開發人員推出 Business API 用戶端 v2.39.3 版。新用戶端包括兩個修正項目及其他記錄以支援除錯。這兩個修復項目如下所示：

• 修正了商家在以下情況中無法向顧客傳送訊息的錯誤：由消費者首先在 WhatsApp 上發起雙方之間的互動且已是在早於 7 天前發起互動。
• 修復使商家無法接收顧客限時訊息的錯誤。安裝 v2.39.3 版本後，商家會在收到限時訊息時接到通知，通知形式為 Webhooks 通知。顧客在自己的用戶端會看到一則警告訊息，告知他們限時訊息模式已停用。

2022 年 3 月 4 日（v2.39.2）

修正了在某些情況下無法傳送影片訊息的錯誤。

已知問題

• 存在使商家無法向顧客傳送訊息的錯誤，當消費者首先在 WhatsApp 上發起雙方之間的互動且已是在早於 7 天前發起互動，便會引發此錯誤。
• 存在使商家無法接收顧客限時訊息的錯誤。

2022 年 2 月 1 日（v2.39.1）

由今天起，我們正式向開發人員推出 Business API 用戶端 2.39.1 版。新用戶端包括：

• 用於 Set Shards API 的新欄位。
• 在網絡要求加入新主機名稱。
• 新錯誤代碼 1031。
• 停用 hsm 類型和 webhook_payload_conversation_pricingmodel_disabled 應用程式設定。

Set Shards API

由新 API 用戶端版本開始，您在設定多點連線時可能需要提供手機的憑證。也就是說，在呼叫 /v1/account/shards 端點時，您可以在憑證欄位中新增以 Base64 方式編碼的憑證。詳情請參閱使用多點連線擴展 API 用戶端。

新主機名稱

我們已將 graph.whatsapp.com 加入 WhatsApp 伺服器主機名稱清單，Business API 用戶端需要與此清單中的主機建立連線。詳情請參閱設定網絡及網絡偵錯 > 主機名稱。

錯誤代碼更新

在 v2.39 中，我們加入了錯誤代碼 1031。如果您的帳戶由於違反完整性政策而遭鎖定，無法傳送任何訊息，您將收到此錯誤訊息。詳情請參閱錯誤和狀態訊息，以及政策執行。

停用內容

• Messages API：hsm 類型已在 v2.39 中被停用。您應轉為使用 template 類型。
• 應用程式設定：應用程式設定 webhook_payload_conversation_pricingmodel_disabled 已被停用。

已知問題

在某些情況下無法傳送部分影片訊息。

2022 年 3 月 26 日（v2.37.2）

此版本包含與 v2.37.1 相同的功能，但過期日期不同。v2.37.2 於 2022 年 9 月 22 日過期。

已知問題

部分 Kubernetes 開發人員可能會看到其網頁版應用程式容器的 CrashLoopBackOff，並且他們的容器可能無法啟動。如要修復此問題，可在 Kubernetes 部署 YML 檔案的網頁版應用程式配置下新增以下程式碼：

command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]

2021 年

2021 年 9 月 30 日（v2.37.1）

這個新版本的 API 引入了以下項目：

• 商務訊息。（印度的商家必須遵循另一套規則並有權存取新端點：/settings/business/compliance_info）。
• 新增 Webhook 欄位，以支援基於對話的定價。
• 在 statuses 物件中新增 Webhooks 欄位。
• 訊息 API、應用程式設定 API 和定價的停用公告。

商務訊息

此版本的 API 引入了兩類新的互動式訊息：單一商品訊息和多商品訊息。收到這些訊息的用戶可以查看商品、將商品加入購物車，及將購物車傳送回商家。

單一商品和多商品訊息都有利助長簡單且個人化的用戶體驗，引導顧客瀏覽與自身最相關的項目子集，而非完整目錄，讓他們獲得更出色的體驗。這兩類訊息與自然語言處理、文字搜尋或清單訊息和回覆按鈕等導覽工具結合使用時效果最佳，能夠快速找出顧客正在搜尋的內容。詳情請參閱商務指南。

印度的商務訊息

印度的 API 商家（+91 電話號碼）從即日起可以開始整合，但要在 2021 年 11 月 15 日之後才能傳送多商品或單一商品訊息。根據由印度消費者事務部頒佈的法律要求，您必須在商家檔案和商品詳情頁面向顧客提供額外資訊。

此外，WhatsApp Business API 2.37 版亦允許印度的商家存取 /settings/business/compliance_info 端點。詳情請參閱此處。

基於對話的定價

我們之前已宣佈，自 2022 年 2 月 1 日起，WhatsApp Business API 將不再採用基於通知的定價模式，轉為使用基於對話的定價（CBP）模式。為協助您做好準備迎接新的定價系統，此版本的 API 引入了新的 Webhook 欄位。下列 Webhooks 欄位自 2022 年 2 月 1 日起才會在您的 Webhooks 上顯示。

請在此處查看新 Webhooks 的例子。

為狀態物件新增的 Webhooks 欄位

Webhooks statuses 物件現在包含 type 欄位。目前僅支援 "message" 類型。

停用內容

• 訊息 API：推出 WhatsApp Business API v2.39 後，hsm 類型將會停用。您應轉為使用 template 類型。
• 應用程式設定：webhook_payload_conversation_pricingmodel_disabled 設定將於 2022 年 2 月 1 日停用。
• 定價：

  • 基於通知的定價將於 2022 年 2 月 1 日停用。pricing_model 下的 "NBP" Webhook 欄位也將一併停用。
  • 為墨西哥版基於對話的定價測試新增的 Webhooks billable 標示預定最早於 2022 年 3 月停用。建議您先停止使用此欄位，再升級至新版本。

2021 年 6 月 28 日（v2.35.4）

修復項目：

• 在多重裝置上重試「回覆」按鈕訊息機制。
• 檢查傳入訊息的大小上限，防止發生 MySQL 錯誤。
• 記憶體問題。

2021 年 5 月 26 日（2.35.2 版）

互動式訊息

此版本的 API 支援您傳送互動式訊息，其中包括清單訊息和「回覆」按鈕訊息。這些新功能讓用戶可在 WhatsApp 上進行互動期間，更輕鬆地從您的商家中尋找和選擇所需內容。測試期間，與靠文字溝通的聊天機械人相比，使用互動式訊息傳送功能的聊天機械人的回覆率和轉換率明顯較高。

以下訊息會視為互動式訊息：

• 清單訊息：訊息的選單最多包含 10 個選項。此類型的訊息讓用戶以更方便且一致的方式，在與企業互動期間作出選擇。
• 「回覆」按鈕：訊息最多包含 3 個選項，其中每個選項為一個按鈕。此類型的訊息讓用戶以更快捷的方式，在與企業互動期間從選單中作出選擇。「回覆」按鈕的用戶體驗與含有按鈕的互動式範本的用戶體驗相同。

在 API 級別，透過將訊息的 type 設定為 interactive 並加入 interactive 物件來設定互動式訊息。通常來說，這些訊息包含 4 個主要部分：header、body、footer 和 action。

如需更多資訊，請參閱我們的傳送互動式訊息指南。

停用內容

TTL

已停用 ttl 參數。此後，所有對包含此欄位的 /messages 發出的 POST 要求都將傳回一則錯誤訊息。在此之前，只有類型為 hsm 和 template 的訊息接受此欄位

穿透設定

由 2.35 版起，您將無法再為 WhatsApp Business API 用戶端重新啟用 pass_through 設定。

2021 年 3 月 10 日（2.33.4 版）

• [修復項目] 已成功將刪除訊息事件的 Webhook 通知傳送給商家。

2021 年 2 月 23 日（2.33.3 版）

一般更新項目

• 現時，所有 docker 圖像均在運行 Ubuntu 20.04。所有外部資料庫均在使用最新版本：php 7.4、openSSL 1.1.1 和 Lighttpd 1.4.55。
• [停用項目] 將無法再透過網頁應用程式網址使用 WhatsApp Business 工具（已從 2.29.1 版開始停用）。目前，建議透過 Postman 存取 REST API。
• [修復項目] Grafana 監控實例的安全漏洞。

WhatsApp 發訊廣告的對話串內背景提示

從 2021 年 4 月 21 日開始，商家將可存取 API 2.33 版的功能之一，亦即 WhatsApp 發訊廣告的對話串內背景提示。透過了解對話串內背景提示，消費者可以輕鬆參考點按的廣告，同時商家亦能了解哪些訊息來自於哪些廣告，從而使首次互動更為方便、個人化而且有效。

為了提高對話數量並降低每次對話的成本，初始測試已顯示對話串內背景提示。

為了支援對話串內背景提示，託管 API 2.33 版的商家或商業服務供應商需要更新其已接收 Webhooks 整合工具，以讀取已在 4 月 21 日之前加至已接收訊息的新「轉介」屬性。

在 4 月 21 日以後，消費者將能透過訊息附件傳送對話串內背景提示，其中包括標題、正文圖片以及與廣告有關的影片。

如果廣告客戶在 4 月 21 日之前沒有完成上述更新，他們將無法接收附件，並將錯過顧客發出的重要內容。顧客將看到廣告上下文，同時也希望商家能夠看到。

基於對話的定價

自 2021 年 2 月 1 日起，我們一直在測試一款全新的 WhatsApp Business API 定價模式，而使用墨西哥電話號碼與用戶收發訊息的商家將會受影響。

為了支援這項操作，部分訊息 Webhooks 通知現在包含全新的 conversation 和 pricing 物件，只有狀態為 sent、delivered 和 read 的訊息會受影響。如需更多資訊，請參閱訊息狀態通知。

2020 年

2020 年 11 月 13 日（v2.31.5）

• [已修復] 正確處理接收欄位超出預期限制的訊息。
• [已修復] 以 /v1/settings/application 回應顯示自動垃圾回收的 config 設定

2020 年 10 月 20 日（v2.31.4）

• 由此版本起以及在所有先前版本上執行更嚴格的版本到期措施。
• 身分變更通知

  • 使用 WhatsApp Business API 的商家可以選擇在與其通訊的用戶身分可能有所更新時接收通知。這樣商家會收到訊號指帳戶背後的操作用戶可能有變，以便商家驗證資訊是否傳送到合適的號碼。
  • 如果商家選擇啟用此功能，當其收到的訊息是來自操作者可能有變的 WhatsApp 帳戶時，商家便會收到通知，並且將無法向有關帳戶傳送訊息，直到商家確認收到訊號並且認為適合繼續通訊為止。這將預防商家及其顧客洩漏敏感資訊。
  • 請查看啟用此功能整合的最佳操作實例：了解 WhatsApp Business 的身分更改
• [已修復] 高度結構化訊息套件下載問題
• [已修復] 備份／還原 API 安全問題

2020 年 8 月 11 日（v2.29.3）

• 核心應用程式服務會以 root 用戶運行
• 升級至 v2.29.3 的路徑當中會確保全部既存媒體磁碟區已修改為 root 用戶的擁有權，以確保順利在 v2.29.3 中操作。這尤其會影響執行 v2.29.1、v2.29.2 或最近嘗試升級到這些版本的商家。請按照我們的推薦指南升級到 v2.29.3：

  • 生產設定：單一實例—升級
  • 生產設定：高可用性／多點連線—升級
• [已修復] 傳送／接收媒體訊息時的記憶體損毀問題

2020 年 7 月 27 日（v2.29.2、v2.27.13）

• 修復 Grafana 監察實例的安全漏洞

2020 年 7 月 17 日（v2.29.1）

• 當消費者更改電話號碼時，商家可以收到傳入系統通知
• 為來自消費者的傳入通知加入新的 forwarded 和 frequently_forwarded 標示。這類標示可用於偵測傳入訊息是否已轉寄或頻繁轉寄，或者沒有轉寄出去。
• 更新 WhatsApp Business API 用戶端的安全性，以減少處理媒體時的記憶體損毀，並在沒有 root 權限的情況下運行，使應用程式不易受到攻擊
• 改善 WhatsApp Business API 用戶端的效能
• 為 /stats 和 /metrics 節點新增 API 密鑰支援。
• [已停用] WhatsApp 網頁版商業工具已停用
• [已停用] on_call_pager 參數已停用
• [將會停用] 傳送訊息範本的結構將會更改，停用 hsm 物件
• 資料庫管理建議

  • 預設停用 pass_through
  • 不同情況的升級用戶

    • 已啟用 pass_through：自動資料庫垃圾回收功能已啟用
    • 已停用 pass_through：建議啟用自動垃圾回收功能來管理資料庫
  • 如果用戶想停用自動垃圾回收功能，可使用新的 /services/message/gc 端點來回收資料庫垃圾
  • pass_through 啟用時不會發佈任何讀取狀態回呼。

2020 年 4 月 17 日（v2.27.12）

• Grafana 版本升級至 6.7.2
• 加入新警示

2020 年 4 月 8 日（v2.27.11）

• 改善核心應用程式總覽管理中心
• [錯誤修復] 核心應用程式中斷資料庫連線次數超出必要頻率

2020 年 3 月 4 日（v2.27.9）

• 修復升級到 2.27.8 時潛在的資料庫升級問題

2020 年 1 月 29 日（v2.27.8）

• 增加貼圖支援

  • 以訊息形式收發貼圖
  • 下載 Whatsapp 貼圖並產生／管理第三方貼圖
• 使用 force_check 參數檢查聯絡人時繞過快取
• 在非同步模式下進行的 /v1/contacts API 呼叫，其結果可以發佈到回呼伺服器，而無需輪詢檢查聯絡人狀態
• [已停用] 適用於傳送訊息範本的 fallback 語言政策已停用
• [已停用] 從不同命名空間傳送訊息範本的功能已停用
• 將訊息範本序列化邏輯從消費者應用程式用戶端移至 WhatsApp Business API 用戶端
• 使用以秒為單位的 WA_DB_CONNECTION_IDLE_TIMEOUT 關閉空閒 MYSQL 資料庫連線的功能

2020 年 1 月 6 日（v2.25.5）

• [錯誤修復] 解決 2.25.x 先前版本中發現的與記憶體流失相關的問題
• [錯誤修復] 預覽網址會間歇性地導致核心應用程式死機

2019 年

2019 年 11 月 13 日（v2.25.4）

• [錯誤修復] 接收者手機用戶端上無法正確產生影片預覽縮圖
• [錯誤修復] 資料庫連線過多問題
• [錯誤修復] 產生影片長度

2019 年 10 月 7 日（v2.25.3）

• 傳出文字類型訊息的輸送量提高至每秒 50 則訊息
• 改善網址預覽顯示功能
• 改善預覽網址無效或不獲支援時的錯誤處理
• [錯誤修復] 在 Postgres 中將訊息標記為已讀
• [錯誤修復] 以往大於 63 KB 的相片會經過編碼。此上限已提升至 5 MB，以便按原樣傳送高畫質的原相片。
• [錯誤修復] 修復 CVE-2019-11931 和 CVE-2019-14835 的安全漏洞

2019 年 9 月 9 日（v2.25.2、v2.23.6）

• 改善核心應用程式的安全性

2019 年 8 月 26 日（v2.25.1）

• 傳出媒體類型訊息的輸送量提高至每秒 18 則訊息
• 傳出文字類型訊息的輸送量提高至每秒 25 則訊息
• 單一實例中傳出文字類型訊息的輸送量提高至每秒 100 則訊息
• 已停用「不安全 http」Webhooks：請將 Webhooks 升級至 https 以取得傳入通知
• 長期驗證憑證適用於 health API 呼叫，以協助監察 WhatsApp Business API 用戶端的多個部署

  • health 端點的要求數量（限速）為每秒 10 項
• 商家行業值應為可列舉值，而非自由填入文字
• [錯誤修復] 正確散佈 mime 類型以解決傳入媒體問題
• [錯誤修復] 多點連線模式下將訊息標記為已讀的要求應該統一分發到所有分片，而不是只傳送到分片 0
• AWS 雲端組成範本從 S3 起向公眾開放，移除了手動向直接支援服務要求存取權限的步驟

安全建議

以下安全漏洞影響 v2.25.1 核心應用程式圖片。下一次發佈的修補程式將包含修復項目。

• CVE-2018-20856：Ubuntu 16.04 供應商發佈的修補程式將包含修復項目

2019 年 6 月 18 日（v2.23.5）

• [已修復] WhatsApp 網頁版商業工具無法在多點連線模式下運作
• 媒體檔案上載大小現在為 100 MB
• 禁止為單一實例設定分片
• 改善以下情況的錯誤處理
  

  • 設定分片
  • 設定雙重驗證
  • 傳送訊息範本
• 改善「無法找到結構錯誤」的候命呼叫器錯誤訊息
• 「將訊息標記為已讀」現在包括所有可已讀的訊息類型

2019 年 4 月 29 日（v2.23.4）

• 透過網址而非二進位 blob 取得群組圖示和商家檔案圖片的功能
• 改良 WhatsApp 網頁版商業工具
• 不依靠 WhatsApp Business API 用戶端升級 WhatsApp Business API 用戶端資料庫的功能
• 單獨更新商家檔案設定的功能，不再需要提供所有欄位
• 除 MySQL 外還支援 PostgreSQL 資料庫
• 新增在傳送時驗證訊息範本的程序，減少顧客裝置上的呈現錯誤
  

  • 加入新的錯誤代碼以表明失敗原因
• 以訊息形式傳送影片的功能，目前僅限於採用 H.264 視像轉碼器和 AAC 音訊轉碼器的 MP4 格式影片
• 加入新的監察管理中心 Grafana，有助於更密切地追蹤資料庫和核心應用程式的效能
• 使用網頁連結傳送媒體的功能

  • 支援媒體供應商存取網頁連結的功能，有關連結要求供應商通過驗證才能下載媒體
• 為現有錯誤代碼提供說明更明確的錯誤訊息，例如 471、472 等
• 文件訊息中除了用戶嘗試下載文件時會看到的 caption 欄位之外，還可以設定 filename
• 接收文件訊息時，除了 caption 欄位之外，寄件者提供的 filename 現在也將在回呼中分享

重大變更

衡量數據

• 以 callback_requests_duration_ms_count 及 callback_requests_duration_ms_sum 取代 callback_requests
• 以 out_message_status 取代 metric out_message_received_by_server、out_message_received_by_target、out_message_received_by_target_read 及 out_message_sent
• 將 Prometheus／Grafana 容器升級至 2.23+ 以便監察新衡量數據

安全建議

以下安全漏洞影響 v2.23.4 映像。下一次發佈的修補程式將包含修復項目。

核心應用程式

• CVE-2019-2683（CVSS 中危險級）
• CVE-2019-2566（CVSS 中危險級）
• CVE-2019-2581（CVSS 中危險級）

網頁應用程式

• CVE-2019-11034（CVSS 嚴重級）
• CVE-2019-11035（CVSS 嚴重級）

2019 年 1 月 24 日（v2.21.6）

• 錯誤修復：

  • [安全修復] 移除網頁應用程式容器中存在安全漏洞的 Mercurial 套件
  • [已修復] 無法在文字訊息中傳送「0」
  • [已修復] 修復伺服器要求處理和媒體要求處理中由於競爭條件導致的記憶體流失
• 已知問題：

  • WhatsApp Business API 用戶端如執行 v2.21.6 版本，當用戶端與伺服器中斷連線時，其可能會保持連線中斷狀態幾分鐘（最多 4 分鐘），然後重試連線。升級到 v2.23.4 將減少用戶端嘗試連接伺服器時的停機時間。

2018 年

2018 年 11 月 13 日（v2.21.4）

• 新功能：

  • 在單獨的聯絡人物件中新增個人檔案名稱以用於回呼
  • 新操作指南
  • 新安全指南
  • 註冊 1800 和免付費電話號碼
• 錯誤修復：

  • [已修復] 部分填入的商家檔案導致 GET /v1/settings/business/profile 傳回空白內容
  • [已修復] 商家檔案為空時，WhatsApp Business 網頁版工具中的商業帳戶設定無法載入
  • [已修復] 對 /v1/contacts 的 API 呼叫沒有回傳資料
  • [已修復] 傳送 JPEG 圖片時回傳錯誤代碼 500
  • [已修復] 嘗試將已刪除的訊息標記為已讀時，系統傳回 500: Internal Server Error。
  • [已修復] 在應用程式完全初始化之前將嘗試上載媒體

2018 年 10 月 24 日（v2.21.3）

• 新訊息收發功能：

  • 在傳送給消費者的訊息中設定 TTL（存留時間）的功能，以指定尚未送達的訊息會在多久後過期（預設值：7 天）
  • 從商家到消費者之間，傳送（在顧客服務時段內）和接收聯絡人的功能
  • 在顧客服務時段內從商家傳送位置給消費者的功能
  • 商家將從消費者收到的訊息標記為「已讀取」的功能
  • 來自消費者的不支援傳入訊息現將引發回呼
  • 來自消費者的傳入訊息如果之後被消費者刪除，現在會引發回呼以通知商家
  • 允許刪除商業帳戶中商家檔案圖片的新 API
  • 新錯誤代碼來說明訊息未能送達消費者的情況
• 新的監察功能：

  • 現可透過 Prometheus 和 Grafana 的容器輕鬆幫助設定對 Business API 用戶端的監察
  • 可用於監察網頁版容器的新統計數據
  • 發佈了 WADebug，此開放來源工具可用於解決 WhatsApp Business API 整合的問題
  • 增強解決疑難功能（API 回應標題中的新欄位），方便根據對 Business API 用戶端進行的特定要求／API 呼叫，輕鬆追蹤所有相關記錄
• 公告：

  • 停用資料磁碟區：從此版本開始，Business API 用戶端操作不再需要資料磁碟區
  • 現在需具備管理員權限才能存取設定、註冊以及上載／刪除憑證或下載 Webhook 憑證。
• 錯誤修復：

  • [已修復] 上載 Webhook CA 憑證在多點連線部署中不起作用
  • [已修復] GET 設定／個人檔案／關於的 API 回應結構不正確

2018 年 9 月 24 日（v2.19.7）

• 明確制定媒體傳輸要求的逾時期限，防止要求無限期地卡住
• 支援資料庫主機名稱的 IPv6 位址
• 允許更大的商家檔案圖片大小（最多 5 MB）
• 修復「個人檔案」>「關於」的 JSON 回應格式

2018 年 7 月 24 日（v2.19.4）

• 修復先前次要版本的 AWS 升級問題
• 已知問題：

  • 使用 IPV6 位址作為資料庫主機名稱無效。
    在傳遞給容器的環境中，如果 WA_DB_HOSTNAME 是 IPV6 位址，則網頁應用程式容器無法運作。因應措施是尋找 DNS 名稱或更改 /etc/hosts，好使系統將其視為主機名稱。請注意，如果 WA_DB_HOSTNAME 是 IPV4 位址，則可以正常運作。
  • 超過 70k 的商家檔案圖片無法使用。
    無法為 WhatsApp Business API 用戶端設定大小超過 70k 的商家檔案圖片。此問題目前沒有因應措施。我們會在準備好後立即在 2.19.X 加入此問題的修補程式。
  • 使用錯誤的 PIN 進行「雙重驗證」註冊會導致核心應用程式死機。
    使用錯誤的雙重認證 PIN 註冊會導致核心應用程式死機。因應措施是 1）重新開啟容器並以正確的 PIN 註冊，或 2）停用雙重認證並在沒有雙重認證 PIN 的情況下重試註冊。

2018 年 7 月 18 日（v2.19.3）

• 移除指令行註冊
• 結束對「手動註冊碼」的支援
• 推薦使用 Docker Compose 安裝與升級
• 用於安裝和升級的指令碼繼續如常運作，但會在後續版本中移除
• 組建的有效期延長至 6 個月
• 更妥善地處理多點連線中的錯誤
• 多點連線設定中，只有主機可以更改 VName
• 此版本不再支援 SQLite。如果您尚未轉移到 MySQL，請轉移。
• 允許以用戶提供的 CA 憑證為 Webhooks 執行 HTTPS
• SSL 憑證現在儲存在 waweb 資料庫中
• 網頁應用程式的登入失敗容錯率限制設定為每小時 50 次
• 支援網頁應用程式和核心應用程式之間的安全裝載
• 增強網頁應用程式的安全性
• 將預設資料庫環境改為不使用 root
• 網頁應用程式和核心應用程式的記錄輪替指令碼支援

2018 年 6 月 15 日（v2.18.26）

• 提高限速規定以反映真實使用情況
• 改善加密密鑰效能
• 提高應用程式在中斷連線後重新連線的速度
• 增強網頁應用程式的安全性
• 支援在網頁版管理員修改密碼
• 改善網頁應用程式的資料庫效能
• 推出確定性 HSM：這允許商家為 HSM 設定語言，而不是作為遞補。
• 使 Prometheus 與新 API 相容
• 修復不正確的媒體下載 uuid 資料
• 修復與文件 MIME 類型相關的問題
• 使用參數 format=prometheus 檢索 Prometheus 統計數據
• 提高工作／回呼佇列超過大小限制時的限速效能
• 修復佇列限制的高／低閾值模型
• 此版本後不再支援 SQLite。如果您仍在使用 SQLite，請轉移到 MySQL。
• 在 Webhooks 執行 HTTPS，停用新的 HTTP Webhooks：建議使用公開簽署憑證的 HTTPS，如果無法使用，請透過在應用程式設定下設定 Webhooks 參數來關閉 SSL 驗證：

{
    "webhooks": {
      "ignore_ssl_errors": true,
      "url": "https://webhook_endpoint"
    }
}

2018 年 5 月 10 日（v2.18.22）

• 候命呼叫器可以設定為群組，以便更多人收到通知。
• 如果訊息無法傳送，傳回的錯誤將更加具體且實用。
• 全面增強安全性。
• 在新的 RESTful API 上傳送訊息之前必須設定 Webhook 網址。
• 更智能地處理資料庫故障、重新連線和重新開啟程序。
• 更妥善地處理網頁版管理員用戶介面錯誤。
• 配置現在預設儲存在資料庫中。
• 在用戶介面和 API 上首次登入管理員用戶時會被強制更改密碼。
• 只有在要求儲存後，系統才會在傳送訊息時傳回訊息編號。
• 持續開發多點連線。
• 允許並遵守所有連線的代理環境變數。
• 新的不重複訊息編號，這在 API 呼叫中會需要用到。
• 傳送訊息時的多執行緒現會進一步優化。
• 改善網絡事件和工作佇列記錄。
• 小幅度優化編譯器

2018 年 4 月 18 日（v2.18.16）

• 增強用戶帳戶憑證的安全性。
• 透過確保維護工作佇列次序來提高效能。
• API 註冊會傳回經驗證的名稱以確保正確無誤。

2018 年 4 月 16 日（v2.18.15）

• 網頁版管理員的設定現已更新。
• 修復傳送 HSM 時無任何參數的問題。
• 隨著轉移到 MYSQL 及資料庫配置的安排，我們不再使用應用程式設定中的資料庫設定並將其移除。
• 改善網頁應用程式和核心應用程式之間的安全性。
• 新增對框架中立 SSL 參數的支援。
• 改善 AWS 設定。
• 增強用戶級安全性，例如在首次登入時強制重設密碼。
• 將操作移至自家執行緒以改善效能。

2018 年 4 月 5 日（v2.18.13）

• 在自家執行緒中處理訊息接收以改善效能。
• 資料庫密碼會安全地儲存在 AWS。
• 改善網頁版管理員。

2018 年 3 月 29 日（v2.18.12）

• 新增對使用環境變數為資料庫表格加上前綴的支援。
• 修復刪除最後一個檔案時一併刪除媒體資料夾的錯誤。
• 增加對分析核對的記錄。
• 更新為新聯絡人 API，以便只傳回有效聯絡人的 wa_id。
• 修復清除回呼時損毀資料庫的潛在錯誤。
• 回呼現會正確辨識語音訊息。
• SSL 憑證建立程序可高可用性地運作。
• 改善與更多分片的多點連線。

2018 年 3 月 22 日（v2.18.11）

• 減少資料庫查詢數量以提高效能。
• 修復檔案名稱被用作媒體訊息標題的錯誤。
• 商家檔案圖片不再儲存在共享用磁碟區上。

2018 年 3 月 14 日（v2.18.10）

• 修復在資料庫上使用配置時的備份／還原問題。
• 以新 API 更妥善地處理錯誤。
• 修復工作管理器中可能出現的死機情況。
• 嚴重錯誤將觸發設定中制定的呼叫器。
• 持續開發多點連線。
• 修復資料庫配置中的 Webhook 設定。

2018 年 3 月 5 日（v2.18.7）

• 在 support_info 中公開 WhatsApp 版本到期日期。
• 新增內部工作管理器的增強功能。
• 持續改善多點連線。

2018 年 2 月 26 日（v2.18.6）

• 新增支援用戶提供的 SSL 憑證。
• 修復連結預覽不一定會載入的問題。
• 改善在網頁應用程式例外情況時顯示的錯誤訊息。
• 公開 support_info 時包含環境變數。
• 持續改善新 API。
• 持續改善多點連線。

2018 年 2 月 10 日（v2.18.4）

• 改善 HSM 參數處理。
• 改善限速。
• 改善在發出 API 要求後而對話中斷時顯示的錯誤。
• 作出修訂以幫助 WhatsApp Enterprise 應用程式更妥善地與客戶關係管理軟件配合使用。
• 持續改善多點連線。

2018 年 1 月 31 日（v2.18.3）

• 改進多點連線。
• 與 WhatsApp 伺服器維持更長的連線。
• 修復商家無法回覆傳入訊息的關係連線案例錯誤。
• 改善新 API。
• 禁止商家向只有自己的群組傳送訊息。
• 修復沒有 Webhook 時啟動會死機的問題。

2018 年 1 月 22 日（v2.18.2）

• 提高執行緒效能。
• 透過平衡傳入要求和訊息傳送操作，更妥善地處理工作佇列。
• 發生嚴重錯誤後嘗試重新啟動連線。
• 修復 iPhone 上無法下載媒體的問題。
• 新增對 AWS 範本設定資料庫配置的支援。

2018 年 1 月 10 日（v2.18.1）

• 具有單一 Webhook 的新 REST API（支援舊 API）。
• 可選擇將磁碟區減少至僅 2 個（data 和 media）。
• 當叫用系統健康檢查端點時，系統會在支援資料中傳回更多資訊。
• 當 Enterprise 應用程式處於連線欠佳狀態時，會出現更多指示如何操作的錯誤。
• 新增第一個版本的多點連線（高可用性）功能。
• 交付資料庫配置以免依賴檔案系統。
• 一般效能改善。

2017 年

2017 年 12 月 28 日（v2.17.73）

• 在工作佇列中新增額外的記錄來為問題偵錯。
• 改善核心應用程式和網頁應用程式通訊。

2017 年 12 月 22 日（v2.17.72）

• 現可向您的商家所在群組中的用戶傳送訊息。
• 更改資料庫架構以提高效能和升級。
• 改善 API 註冊以避免假當機狀態。
• 現可從系統健康檢查端點查看支援資料。
• 更妥善地處理訊息傳送逾時以避免工作卡住。
• 新增兩步驟驗證，您可以在其中設定每次嘗試註冊時都需要提供的代碼。
• 改善設定有誤時的錯誤。
• 更改經驗證名稱邏輯，以避免重新連線迴圈。

2017 年 12 月 11 日（v2.17.62）

• 修復將錯誤的 json 類型傳遞給 set_settings 而可能導致核心應用程式死機的錯誤。

2017 年 11 月 30 日（v2.17.61）

• 修復和改善限速。

2017 年 10 月 27 日（v2.17.48）

• 修復以防止記錄變得太大。
• 修復傳送重複回呼的錯誤。
• 修復 AWS 備份和還原功能。
• 改善限速功能。
• 阻止將商家加入群組的選項。
• 不再支援 HTTP，僅支援 HTTPS 端點。
• 改善經驗證名稱以免遺失。
• 網頁版管理員／設定檢視畫面現受密碼保護。
• 修復網頁版管理員／設定檢視畫面的錯誤。
• 資料庫中的回呼預設會保留。
• 改善回呼效能。

2017 年 10 月 15 日（v2.17.46）

• 改善經驗證名稱以免遺失。

2017 年 9 月 25 日（v2.17.42）

• 改善回呼效能、監察功能和重試功能。
• 新增對群組內提及功能的支援。
• 用於設定和檢視設定的新網頁版用戶介面。
• 改善網絡。
• 修復備份和還原的關係連線案例。
• 改善整個應用程式的記錄功能，以便更妥善地分析和偵錯。
• 新增限速，以防止可能導致帳戶被停用的失控指令碼／程式。
• 執行 4096 個字元的限制。
• 群組建立時間現採用 Unix 時間。

2017 年 9 月 18 日（v2.17.41）

• 略過 2.17.40 版本。
• 修復傳送音訊檔案時的競爭條件。
• 改善檢查聯絡人記錄功能。

2017 年 9 月 15 日（v2.17.39）

• 與網頁應用程式的連線會在 5 分鐘後逾時，並顯示得體的錯誤訊息。
• 改善檢查聯絡人的功能。

2017 年 9 月 15 日（v2.17.38）

• 修復傳入的媒體連結。

2017 年 8 月 8 日（v2.17.37）

• 略過版本 2.17.34、2.17.35 和 2.17.36。
• 修復向群組傳送媒體的問題。
• 改善媒體傳送功能。
• 為訊息中首個網址啟用網址預覽。
• 更強大的網頁版應用程式。
• 一般改善和死機錯誤修復。

2017 年 8 月 28 日（v2.17.33）

• 現可配置回呼重試延遲功能。
• 在傳送訊息之前，必須先檢查電話號碼的聯絡資訊。
• 改善資料庫效能。
• 透過 API 取得應用程式設定的功能。
• 已知問題：

  • 如果媒體儲存在媒體磁碟區中，傳入的媒體連結將會損壞。

2017 年 8 月 8 日（v2.17.32）

• 修復資料庫配置失敗的已知問題。
• 獲取訊息已傳送回呼的功能。
• 推出 WhatsApp 群組。
• 改善回呼和整體效能。
• 已知問題：

  • 向群組傳送媒體的功能已損壞。

2017 年 7 月 28 日（v2.17.31）

• 修復互動式註冊流程。
• 略過 2.17.30 版本。
• 已知問題：

  • 資料庫配置期間發生故障導致核心應用程式無法啟動。

2017 年 7 月 25 日（v2.17.29）

• 改善資料庫。
• 修復從備份還原導致 WhatsApp Enterprise 應用程式關閉的問題。
• 改善檢查聯絡人功能的效能。

2017 年 7 月 15 日（v2.17.28）

• 引入應用程式設定的新端點

  • 增加設定商家檔案的功能。
  • 新增為 WhatsApp 帳戶設定「關於」的功能。
  • 新增對 MySQL 的支援。
  • 更改了設定商家檔案圖片的欄位。
• 增加備份設定、密鑰和其他資料然後從備份還原的功能。
• 改善在透過 API 註冊時顯示的錯誤訊息。
• 新增對在 Webhooks 中從用戶接收位置資訊的支援。
• 在傳入訊息 Webhooks 新增名為 type 的欄位，指明訊息的類型。

2017 年 7 月 6 日（v2.17.27）

• 修復註冊指令碼以處理經驗證的名稱憑證。
• 新增透過設定 API 首次註冊的功能。

2017 年 6 月 30 日（v2.17.26）

• 引入了新的註冊流程，由用戶提供經驗證的名稱憑證，而且用戶可在完成註冊之前加以預覽。
• 修復檢查聯絡人呼叫有所重疊時的問題。
• 修復死機記錄。

2017 年 6 月 20 日（v2.17.25）

• 伺服器上有 VName 時註冊流程可更簡單。
• 提高處理較重負載時的效能。

2017 年 6 月 14 日（v2.17.24）

• 修復有關檢查聯絡人和 MySQL 的錯誤。
• 提高網絡效能。

2017 年 6 月 8 日（v2.17.23）

• 修復某些帳戶的訊息傳送問題。
• 修復 media_url_prefix 邏輯，以便將 "media.hostname.com" 換成網頁版容器的 IP 位址，並指向傳入的媒體檔案。

2017 年 6 月 7 日（v2.17.22）

• 修復處理大量聯絡人時記憶體和儲存空間用量過多的問題。
• 已知問題：

  • 某些帳戶在傳送訊息時遇到問題。

2017 年 6 月 1 日（v2.17.20）

• 新的版本控制格式。
• 提升選擇商家檔案圖片的靈活度。
• 增加來自系統健康檢查端點的統計數據。
• 啟用穿透模式以減少應用程式的磁碟使用量。
• 已知問題：

  • 大量聯絡人會消耗大量記憶體和儲存空間。

2017 年 5 月 11 日（v17018）

• 修復 JPG 影像傳送問題。
• 修復註冊問題，以便實際向電話號碼致電和傳送短訊。
• 新增訊息回呼的背景資訊，以助理解訊息回覆。
• 提高回呼效能。
• 已知問題：

  • 商家檔案圖片必須為 640x640 JPG。

2017 年 5 月 8 日（v17017）

• 新的註冊流程不再使用還原憑證。
• 停用 conversation，現在使用 text 作為訊息欄位。
• 新增會分享應用程式閘道狀態的系統健康檢查端點。
• 支援查看用戶傳送的媒體說明文字。
• 已知問題：

  • JPG 影像傳送失敗。
• 語音和短訊註冊無法運作。

2017 年 4 月 26 日（v17016）

• 新的傳入媒體下載回呼。
• 可配置的 WhatsApp 伺服器 IP 和通訊協定，並且加入 SSL 包裝以便測試。
• 已知問題：

  • JPG 影像傳送失敗。

指令碼

2018 年

2018 年 6 月 20 日（v2.33）

• 將預設版本上推至 2.18.26。
• 將 Prometheus 和 Grafana 移至單獨的指令碼中

2018 年 6 月 12 日（v2.30）

• 將預設 WhatsApp Enterprise 應用程式版本上推至 2.18.22。
• 不再使用 MySQL 檢查資料庫設定。
• 使用 Docker 容器 IP 位址來連結容器，而不是已停用的 Docker 連結

2018 年 5 月 10 日（v2.27）

• 將預設版本上推至 2.18.20。
• 將多點連線中從屬實例的命名更改為核心應用程式。
• 在多點連線指令碼中新增支援網絡代管和掛接選項。

2018 年 3 月 27 日（v2.23）

• 將預設版本上推至 2.18.13。
• 預設設定需要用到 MYSQL 並在資料庫上啟用配置。
• 新增對高可用性和多點連線的支援。
• 從 JFrog 存放庫中提取 Docker 映像。
• 使用設定指令碼載入和運行 Prometheus 和 Grafana 的功能。

2018 年 2 月 16 日（v2.19）

• 為核心應用程式和網頁應用程式啟動增加更妥善的錯誤檢查程序。

2018 年 2 月 10 日（v2.18）

• 將預設版本上推至 2.18.4。
• 預設為單一媒體磁碟區，並可選擇保留舊磁碟區設定。
• 現可透過指定環境變數檔案以在資料庫上配置。
• 加入範例環境變數檔案。

2018 年 1 月 23 日（v2.15）

• 將預設版本上推至 2.18.2。

2018 年 1 月 11 日（v2.14）

• 重構指令碼以分享多點連線（高可用性）的常用程式碼和設定指令碼。

2017 年

2017 年 12 月 21 日（v2.13）

• 修復升級期間維護 TCP 443 連接埠的問題。

2017 年 12 月 11 日（v2.12）

• 將預設應用程式版本更新為 2.17.62。

2017 年 12 月 6 日（v2.11）

• 將預設應用程式版本更新為 2.17.61。

2017 年 10 月 31 日（v2.10）

• 將預設應用程式版本更新為 2.17.48。
• 從核心應用程式中提取記錄的指令。

2017 年 10 月 1 日（v2.9）

• 將預設應用程式版本更新為 2.17.42。

2017 年 9 月 19 日（v2.8）

• 將預設應用程式版本更新為 2.17.41。
• 簡短指令碼的標準化指令。
• wadockersetup 指令碼現有升級指令。

2017 年 9 月 18 日（v2.7）

• 將預設應用程式版本更新為 2.17.39。
• 在 Docker 設定和升級時指定連接埠的功能。
• 在網頁版應用程式加入必要的磁碟區。

2017 年 7 月 31 日（v2.6）

• 將預設應用程式版本更新為 2.17.31。

2017 年 7 月 25 日（v2.5）

• 將預設應用程式版本更新為 2.17.29。
• 移除未使用的設定配置和訊息傳送指令碼。

2017 年 7 月 10 日（v2.4）

• 將預設應用程式版本更新為 2.17.27。
• 新增 pass_through 來配置設定指令碼。
• 使安裝指令碼可配合新的註冊和已驗證的名稱流程運作。

2017 年 6 月 21 日（v2.3）

• 將預設應用程式版本更新為 2.17.25。

2017 年 6 月 10 日（v2.2）

• 將預設應用程式版本更新為 2.17.23。

2017 年 5 月 11 日（v2.1）

• 顧及新的註冊流程，並顯示正確的訊息以繼續舊的註冊程序或不繼續。
• 將預設應用程式版本更新為 17018。
• 如果目前目錄已有 Docker 映像，請勿下載有關映像。
• 為所有指令碼檔案新增版本控制。
• 傳送訊息時會使用 WhatsApp 用戶名稱，而不是國家／地區代碼和電話號碼。

Amazon Web Services 範本

AWS（Amazon Web Services）—Cloud Formation（CFN）範本中包含的內容：

發佈版本 2.3.6

範本網址

• Enterprise：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=lYu.TOcU7oob75JIQNq8hwDa5DV8LETZ
• DB：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=E8G3Hvsd8osglCbCMJ37wMQDgDqiX.8z
• Lambda：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=hL2KwxNHEIDBB.m8DyBZ0gTkKdwmPYLO
• Network：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=4SyZ_JRIu9Qjv1sS0_gq64uI9b5ZVki0
• Monitoring：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_monitoring.yml?versionId=k5w2uyGdSYdgzsah4K74GiX3hka92o7i

變更記錄

• 新增用於設定 Grafana 的監控範本。
• 新增可支援匯出核心應用程式託管統計數據以作監控的選項。
• 修復防礙主機安裝部分套件的問題。
• 將資料庫預設為不可公開存取。
• 已將 Lambda 執行階段更新至 Python 3.8。

發佈版本 2.3.5

範本網址

• Enterprise：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=xyE_FkWE5FyYIiXozixCiwJ7qEBFHJD_
• DB：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=6S64vuEJuIUYgcKMakIUVsBnYVLe8FlZ
• Lambda：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=ORGseStC38YfQnnbUDp0aAu2hgva1mvt
• Network：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=jIAQAZ0h7Mr6zGPDX0Du_2TxRvov27Bv

變更記錄

• 支援可配置的 RDS 參數：儲存類型、多可用區域、IOPS 和引擎版本
• 支援孟買地區
• 新增支援 M5 級 EC2 實例及 M5 級 DB 實例類型
• 支援可配置的 EBS 磁碟區大小
• 將 DB Idle Connection Timeout 的預設值更新為 180000 毫秒

發佈版本 2.3.4

範本網址

• Enterprise：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=tZ1laU2RSC7r3bXJpBb8GvTKSZtTjcor
• DB：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=AnGlHzLonTRUbARyCxqO.WNaMs0igmRD
• Lambda：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=mzhd2_Rl8H8_hzX2z0RQNRWfILb78Pn7
• Network：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=rSNKu7R_4LccpMDkEAstdWiRogj8e4dd

變更記錄

• 已改進安全性

發佈版本 2.3.3

範本網址

• Enterprise：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=jnUkOxCK0d.PKuI50esojEJuYXsQ7HiQ
• DB：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=W8wVUEc4qrdK4wEycvkKArmfLhxbd3dF
• Lambda：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=ltvjuVbzyk02hF8X4FnQL4WTGLQmwWPb
• Network：https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=WmOUyj8x0nvGT3k0X7Oc1KGZ3_puX.En

變更記錄

• 現可在新的 S3 組別中使用全部 CFN 範本
• 現可在 Marketplace CentOS 7 AMI 中啟動 EC2 實例
• 已移除 Business API 用戶端範本中不支援的 EC2 實例類型
• 現已為 EC2 實例配備用於維護工作的排程任務（為網頁應用程式／核心應用程式配備 Logrotate、為 ECS 配備代理更新）
• 現在您可在預備階段環境及正式版環境使用一般用途 SSD 磁碟區作為 RDS 實例的儲存空間
• 已移除未有使用的 CloudWatch 警告

發佈版本 2.3.1

範本網址

• Enterprise：https://s3.amazonaws.com/wa-ent-cfn/wa_ent.yml?versionId=2xaTm9dKCdjmuxMKTZOfQI_o9iw.bBTK
• DB：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_db.yml?versionId=tq8ZXaK30IIdlWhF3bevI2tCi5nIlFs6
• Lambda：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_lambda.yml?versionId=IZykZHXo._QyKHPZKDffLB0ISJPfPevr
• Network：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_net.yml?versionId=X51Ww5KtgjcbTwBrn_C3C0m5Sko150f3

變更記錄

• 支援新地區（首爾、新加坡和東京）

發佈版本 2.3.0

範本網址：

• Enterprise：https://s3.amazonaws.com/wa-ent-cfn/wa_ent.yml?versionId=C3JDtTfqFxGm4QAd_tMm33UHbDCGvts3
• DB：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_db.yml?versionId=1XJEwdOPecEsecG0rfQIZAh9sIKh9HIv
• Lambda：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_lambda.yml?versionId=qo_Tx6j6.M5WJjE4b3k22bpQz4YJHFV_
• Network：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_net.yml?versionId=5lI_QAUA7H1Og9HXWdf7Ds1LYkrYTjsQ

相依項目／必要條件：

建議使用 WhatsApp Business API 用戶端版本 v2.18.20 或更高版本。此範本可能適用於先前的版本，但並不建議。

變更記錄：

• 此範本現提供多點連線功能。請參考多點連線指南以了解更多資訊和設定。

發佈版本 2.2.1

範本網址：

• Enterprise：https://s3.amazonaws.com/wa-ent-cfn-beta/wa_ent.yml?versionId=UGXYUCZXdffRe8_mAHfVFwc8HAjzDI2A
• DB：https://s3.amazonaws.com/wa-ent-cfn-beta/wa_ent_db.yml?versionId=N3I6q9CkQMbE8bQQvaFsYLRKTkCDm2Jw
• Lambda：https://s3.amazonaws.com/wa-ent-cfn-beta/wa_ent_lambda.yml?versionId=4yGnpz8a5xtaaXKg.UAiatOlOYM71UrD
• Network：https://s3.amazonaws.com/wa-ent-cfn-beta/wa_ent_net.yml?versionId=sX9jYgVgajf.gownIUc0R70S9uT_aX5e

相依項目／必要條件：

此範本需要使用 WhatsApp Business API 用戶端版本 v2.18.14 或更高版本。此範本並不適用於先前的版本。

變更記錄：

• 支援容器的可配置記錄驅動程式。預設記錄驅動程式是 json-file，其會在運行容器的主機（EC2）上將記錄儲存為 JSON 檔案。此範本還提供了配置 awslogs 的選項，其中所有容器記錄都會串流傳輸到 CloudWatch。這樣可將所有記錄集中在一個地方提供。選擇 awslogs 選項後，容器記錄便不會在 EC2 主機上提供。不過，容器內的記錄檔案仍會存在。
• 新增所有 SSL 參數：SSL 憑證、SSL 密鑰和 SSL CA。2.2.0 版本中新增 SSL CA 支援，但已修改說明用字以避免歧義。

發佈版本 2.2.0

範本網址：

• Enterprise：https://s3.amazonaws.com/wa-ent-cfn/wa_ent.yml?versionId=G1kEgU_D._ksw97T3pDBO938lVyxmnhb
• DB：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_db.yml?versionId=H0qu4NzJewXpE8xcuJuBcPzAvdW.mFqn
• Lambda：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_lambda.yml?versionId=vhx_JvViDextJCRUSvYeLy7ZRYSpbR0M
• Network：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_net.yml?versionId=mV7iD6iNdF4E3gzSDBYyhjfVmL1CfjaW

相依項目／必要條件：

此範本需要使用 WhatsApp Enterprise 用戶端版本 v2.18.14 或更高版本。此範本並不適用於先前的版本。

變更記錄：

• 支援「靜態」HA

  • 預備階段環境—最小容器（EC2）實例：2，最大：3，理想的主機、核心應用程式和網頁容器數量：2
  • 正式版環境—最小容器（EC2）實例：3，最大：4，理想的主機、核心應用程式及網頁容器數量：3
  • 此選項預設停用
• 加密支援（RDS／資料庫和 EFS）

  • 新版本可以加密待用資料。預設選項是使用預設的 AWS 服務密鑰來加密。其他支援的選項：

    • 不加密
    • 建立並使用新密鑰
    • 以用戶提供的密鑰加密
• 資料庫連線加密支援

  • 新版本可以加密傳輸到資料庫的資料。注意事項：目前只適用於核心應用程式，尚未支援網頁版應用程式加密。此外，使用新的資料庫引擎時，即使沒有設定，核心應用程式似乎也會執行加密，而無需伺服器憑證驗證。
• 支援測試版發行渠道

  • WhatsApp 建立了測試版渠道來測試尚未正式推出的新範本集。顧客需要另外存取測試版渠道／範本
• 可配置的容器登錄支援

  • 新範本具有可配置的容器登錄，可用於存取日後的 Enterprise 用戶端實驗版本。大多數情況下，預設值為 good
• 支援新區域（us-west-1：北加州）

  • AWS EFS 服務現支援北加州區域。任何有興趣使用該區域的顧客應該都可獲得存取權限
• 資料庫密碼儲存在安全參數儲存功能中以免洩漏
• 資料庫（MySQL）引擎版本更新至 5.17.21
• 巢狀範本的範本版本控制

  • 我們將所有參照的巢狀範本與合適的版本連結。這將避免各範本版本不符（例如，主範本 → 資料庫範本）
• 支援資料庫配置

  • 資料庫上的配置不再限於實驗功能，並且預設為啟用。顧客仍然可以選擇將其關閉
• 錯誤修復：

  • 發現 EFS 掛接次序有誤，即在容器啟動後才掛接 EFS 磁碟區。這種情況在超過 100 次嘗試中才發生一次，但情況並不樂觀。我們透過強行執行次序來解決此問題。
  • 由於計時問題，連接埠對應工具需要重試幾次，才能找到正確的外部連接埠對應以便 HA 正常運作。在 HA 之前這不是問題，而重試得夠多次可以解決此問題

注意：請審慎使用實驗／測試版功能。強烈建議在使用這些功能時與 WhatsApp 團隊密切合作，以便在出現任何問題時，我們可以快速為您提供支援。

已知問題：

停用 HA 後，WhatsApp Enterprise 用戶端無法運作。此問題將在下一個 WhatsApp Enterprise 用戶端版本中解決。

發佈版本 2.1.0

範本網址：

• Enterprise：https://s3.amazonaws.com/wa-ent-cfn/wa_ent.yml?versionId=G1kEgU_D._ksw97T3pDBO938lVyxmnhb
• DB：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_db.yml?versionId=H0qu4NzJewXpE8xcuJuBcPzAvdW.mFqn
• Network：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_net.yml?versionId=dwwWw0d07CXWn4UUh0zTByadVa8ANN8d

變更記錄：

• 支援記錄配置：容器記錄檔案大小上限、保留檔案數量上限，以及 CloudWatch 記錄保留天數上限
• AWS ECS 主控台上現會顯示容器衡量數據
• 自動資料庫配置：在新範本的幫助下，無需明確配置資料庫。API
• 已停止／終止的容器會保留 3 天，而不是 3 小時
• EFS 掛接失敗現在將導致 CFN 堆疊建立失敗
• 支援資料庫配置（實驗功能）

  • 注意：請審謹使用實驗功能。強烈建議在使用實驗功能時與 WhatsApp 團隊密切合作，以便在出現任何問題時，我們可以快速為您提供支援
• 錯誤修復：

  • EC2 主機重新啟動程序遺失掛接點，因此遺失了先前的配置
  • 記錄輪替問題現已修復
  • ecs-agent 的遙測權限問題，導致 ecs-agent 記錄檔案中充滿 TCS 相關錯誤

發佈版本 2.0.0

範本網址：

• Enterprise：https://s3.amazonaws.com/wa-ent-cfn/wa_ent.yml?versionId=0AebXsDpC1K0anavueHimLGADZHSLS9Y
• DB：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_db.yml?versionId=6XfLkIitlgTajEI892hReQMgHfwSb8n9
• Network：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_net.yml?versionId=ArE8AtF1A6uusRs6_Hr9XNCdDEVf694t

變更記錄：

• RDS 上的 utf8mb4 字元集支援
• 可配置的環境類型：正式版與預備階段

  • 正式版：EBS—16 GB 和 SSD；RDS：多可用性區域和 SSD
  • 預備階段：EBS—10 GB 和 SSD；RDS：無可用性區域和磁碟片
• 包括 EC2 主機的記錄輪替配置
• 負載平衡器和可配置負載平衡器方案的單獨子網絡
• 基於 CentOS 7 的最新 AMI（7.4.1708）
• 改良網絡範本，以支援建立私人子網絡、NAT 閘道等。
• 現支援 EMEA（法蘭克福）的新區域
• 錯誤修復：

  • 從 awslogs 配置移除 cfn-hup 服務記錄
  • 解決媒體檔案過多時升級失敗的問題
  • 解決 ecs-agent 啟動問題

發佈版本 1.1.0

範本網址：

• Enterprise：https://s3.amazonaws.com/wa-ent-cfn/wa_ent.yml?versionId=.Sc8G5IyWSYUu_D76L_xwng5he797WXw
• DB：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_db.yml?versionId=YT6bS49XRJE7_TOB5A_ufflt71.mejG1
• Network：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_net.yml?versionId=XSTKDOfjbSy4KEfkxgR_1Zp76G4iTcNs

變更記錄：

• 支援 CloudWatch 記錄，方便除錯
• 驗證 EC2 和 RDS 實例類型升級程序，確保不會遺失資料（預計停機時間約 15 分鐘或更短）
• 為 EC2 和 RDS 新增「m」類別實例類型
• 收集網絡相關資訊，方便解決疑難
• 移除 HTTP 端點（安全問題）
• 資料庫密碼接受特殊字元

發佈版本：1.1.0

範本網址：

• Enterprise：https://s3.amazonaws.com/wa-ent-cfn/wa_ent.yml?versionId=BsmMWbouupu2pW_42El8b8FjHZOaGL2f
• DB：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_db.yml?versionId=q1u3dUeGRGYLEsrJWoVnLEd9ekOQyG2B
• Network：https://s3.amazonaws.com/wa-ent-cfn/wa_ent_net.yml?versionId=QQWM24CLiXnsHH1Reg_fR3TaK5YRiyfj

變更記錄：

• WhatsApp Enterprise 用戶端的一鍵設定 AWS 基礎架構功能
• 支援一鍵升級到新版本
• 可選擇網絡和資料庫

已知問題