中文(香港) 的翻譯尚未完成。
中文(香港) 更新時間：
2024 年 1 月 26 日
雲端 API
- 雲端 API 範本訊息傳送重試存活時間從 24 小時變更為 30 天。您仍可為驗證範本覆寫此值。
- 已將
biz_opaque_callback_data字元上限由 256 變更為 512。
2023 年 12 月 12 日
Business Management API
- 在 WhatsApp 訊息範本節點新增
cta_url_link_tracking_opted_out欄位，以啟用／停用按鈕點擊次數追蹤。 - 範本分析現在包括在範本中分類為
UTILITY的按鈕點擊次數。
2023 年 11 月 14 日
雲端 API
- 在各個節點新增
health_status欄位，以檢查訊息傳送健康狀態。 - 向任意格式訊息新增
biz_opaque_callback_data欄位，以在訊息 Webhooks 中加入任意字串。
2023 年 10 月 4 日
Business Management API、雲端 API、內部部署 API
- 使用驗證碼過期警告的驗證範本現在使用
code_expiration_minutes值（而不是預設值 10 分鐘）來判定已送達範本訊息是否應顯示自動填入按鈕或複製驗證碼按鈕。 - 已送達範本訊息中顯示的自動填入按鈕將在範本的
code_expiration_minutes值（如果有的話）所指示的時間量後停用（如果沒有的話，則在 10 分鐘後停用）。
2023 年 9 月 18 日
雲端 API、內部部署 API
- 在 204 年 4 月 1 日（從 2023 年 10 月 2 日起延長）之前，可以繼續傳送、編輯和申訴舊版驗證範本（沒有一次性密碼按鈕的驗證範本）。
2023 年 9 月 12 日
Business Management API
- 新增 WhatsApp Business 帳號存取權限層級，以進行更細微的控制。
- 如果權杖識別的用戶未經授予適當的 WhatsApp Business 帳號存取權限，WhatsApp Business 帳號 > 電話號碼和 WhatsApp Business 帳號 > 訊息範本的 GET 要求現在會傳回錯誤代碼
200。 - 新增範本移轉。
雲端 API
- 新增輪播範本。
雲端 API、內部部署 API
- 若將商家電話號碼從內部部署 API 移轉到雲端 API，而該商家電話號碼的多點連線執行 2 個以上的分片，則會自動升級至更高的雲端 API 輸送量。
2023 年 8 月 8 日
工具
- 在 WhatsApp Business API 狀態頁面新增雲端 API 本地化儲存狀態。
Business Management API
內嵌註冊
- 在內嵌註冊中新增停用電話號碼選擇的功能。
2023 年 7 月 11 日
雲端 API
- 排定和執行商家電話號碼輸送量的升級不再需要即時呼叫。
- 您現在可於提交直接支援票證時指定升級時間，以要求升級至商家電話號碼的輸送量。
- 進行輸送量升級之商家電話號碼的停機時間減少為 5 分鐘或更短。
2023 年 5 月 23 日
雲端 API
- 若嘗試使用第 17 版或後續版本在範本訊息中傳送已暫停範本，現在會傳回錯誤代碼
132015，而不是132001。 - 若嘗試使用第 17 版或後續版本在範本訊息中傳送已停用範本，現在會傳回錯誤代碼
132016，而不是132001。
內部部署 API
2023 年 5 月 1 日
Business Management API
- 在
account_alertsWebhooks 欄位加入新的 Webhooks，通知您訊息限制增加的拒絕數。 - 所有範本現在必須分類為
AUTHENTICATION、MARKETING或UTILITY。
2023 年 4 月 26 日
Business Management API
- 將
hsm_id欄位新增至 DELETE WhatsApp Business 帳號 > 訊息範本端點。若已包含，則刪除與提供之編號相符的單一範本（而不是刪除與提供之名稱相符的所有範本）。
2023 年 4 月 18 日
雲端 API
- 將
last_onboarded_time新增至 WhatsApp Business 電話號碼節點。指示用戶何時透過完成內嵌註冊流程在其 WhatsApp Business 帳號建立商家電話號碼。
2023 年 4 月 4 日
Business Management AI、雲端 API、內部部署 API
- 已完成第一個範本類別移轉。
- 類別驗證現在是新建範本之範本審查程序的一部分。適用於第 16.0 以上版本。
- 針對範本建立或編輯要求的 API 回應現已包含範本狀態和範本類別。適用於所有 API 版本。
- 將
allow_category_change參數新增至 POST WhatsApp Business 帳號 > 訊息範本端點。 - 依靠變數的範本現在於建立或編輯時需要範例值。適用於所有版本。
- 將
previous_category欄位新增至 WhatsApp 訊息範本。 - 商家主動開啟對話不再符合免費期間對話的資格。如果您的 WhatsApp Business 帳號依賴解決方案合作夥伴或 Meta 合作夥伴的服務，在 2023 年 6 月 1 日之前將不受這些變更的影響。
2023 年 3 月 17 日
Business Management API
- 新增
template_category_updateWebhook 訂閱欄位。如果訂閱此欄位，每當範本的類別變更時，您都會收到可指出範本舊類別和新類別的 Webhook。 - 針對範本建立和編輯要求的 API 回應現已包含範本的狀態和類別。
2023 年 2 月 3 日
雲端 API、內部部署 API
- 新增 WhatsApp Business 電話號碼 > 商務設定端點，可啟用／停用個別商家電話號碼的購物車和商品目錄。請參閱雲端 API 的設定商務設定和內部部署 API 的設定商務設定，以取得使用說明，並瞭解這些設定如何幫助您銷售商品和服務。
2023 年 2 月 2 日
Business Management API、雲端 API
雲端 API
- 第 16.0 以上版本的錯誤回應中不再包含錯誤子代碼（很少使用，且不應依賴這類代碼）。請改用
code和details。 - 錯誤代碼 100（
"code":100）具有多個不重複標題，可指出指定 100 錯誤的性質。所有代碼 100 錯誤現在都將使用Invalid parameter作為其標題。描述指定代碼 100 錯誤性質的舊標題已移至details屬性。此變更現在��反映在描述代碼 100 錯誤回應的 Webhooks 承載中。
雲端 API Webhooks
- 第 16.0 以上版本要求錯誤所觸發之 Webhooks 中的
errors物件現在包括message和error_data.details屬性，且多個錯誤代碼的title值已變更。現在errors物件具有以下結構和資料：
[
{
"code": <CODE>,
"title" : "<TITLE>",
"message": "<MESSAGE>",
"error_data": {
"details": "<DETAILS>"
}
},
...
]- 下列錯誤代碼的
title屬性值已更新。其舊值現在會顯示在error_data.details中。130470新標題現在為Re-engagement message130429新標題現在為Rate limit hit131045新標題現在為Incorrect certificate131031新標題現在為Business Account locked131053新標題現在為Media upload error131027新標題現在為Something went wrong131042新標題現在為Business eligibility payment issue131026新標題現在為Message Undeliverable131000新標題現在為Something went wrong
error_data.details屬性現在會包含上述錯誤代碼的錯誤代碼標題，並說明錯誤的根本原因。此值對映至 API 錯誤回應承載中的details屬性。
這些變更會反映在錯誤相關 Webhooks 的下列 errors 屬性中：
entry.changes.value.errorsentry.changes.value.messages.errorsentry.changes.value.statuses.errors
2023 年 1 月 30 日
雲端 API
未驗證的商家現在可以在 24 小時的循環週期內發起最多 250 組對話。
2022 年 12 月 13 日
影音素材權限檢查
適用於所有雲端 API 版本。
在影音素材端點新增選用的 phone_number_id 欄位。如果包含此參數和商家電話號碼編號，只有當電話號碼編號和已上傳影音素材的電話號碼編號相符時，系統才會處理操作。
2022 年 12 月 8 日
HTTP 影音素材快取
雲端 API HTTP 影音素材快取已不再為測試版，可供所有人使用。
Webhooks
雲端 API 現在重新嘗試傳遞失敗 Webhook 通知的時間最長達 7 天，而不是 30 天。請參閱 Webhooks 傳遞失敗。
2022 年 11 月 23 日
新的 Webhooks 欄位
適用於所有版本。
- 已新增
template_performance_metrics欄位。每週通知您所有範本成效衡量指標，包括傳送的訊息數量、開啟的訊息數量，以及封鎖的主要原因。
2022 年 11 月 22 日
新的 Webhooks 欄位和值
適用於所有版本。
新的 account_alerts 欄位：
- 已新增
account_alerts欄位。通知您商家、WhatsApp Business 帳號和商家電話號碼提醒。
新的 account_update 欄位值：
- 已新增
account_update.events值：ACCOUNT_DELETED。指示已將電話號碼從 WhatsApp Business 帳號中取消註冊或刪除。 - 已新增
message_template_status_update.events值：PENDING_DELETION。指示已將訊息範本標記為刪除。
觸發以下新事件時傳送的範例 Webhooks 通知：
ACCOUNT_DELETED：WhatsApp Business 帳號已刪除PENDING_DELETION：範本訊息待刪除
新的 WhatsApp Business 帳號節點���位
已新增下列 WhatsApp Business 帳號節點欄位：
country（適用於v15.0+）ownership_type（適用於v15.0+）business_verification_status（適用於所有版本）
新的商家端點篩選條件
適用於 15.0 以上版本。
已在商家用戶端 WhatsApp Business 帳號���點中新增下列篩選條件選項：
- 使用
GREATER_THAN、LESS_THAN或IN_RANGE運算子，依 WhatsApp Business 帳號creation_time欄位進行篩選。 - 使用
EQUAL或IN運算子，依 WhatsApp Business 帳號ownership_type進行篩選。
已在商家所屬 WhatsApp Business 帳號端點中新增下列篩選條件選項：
- 使用
GREATER_THAN、LESS_THAN或IN_RANGE運算子，依 WhatsApp Business 帳號creation_time進行篩選。 - 使用
EQUAL或IN運算子，依 WhatsApp Business 帳號ownership_type進行篩選。 - 使用
EQUAL或IN運算子，依 WhatsApp Business 帳號country進行篩選。
新的電話號碼節點欄位
適用於 15.0 以上版本
新增下列 WhatsApp Business 電話號碼節點欄位：
is_official_business_accountmessaging_limit_tier
此外，您可以依 is_official_business_account 篩選 WhatsApp Business 帳號電話號碼端點。
2022 年 11 月 3 日
每秒訊息數量
雲端 API 現在可支援的每秒訊息量（mps）（包含簡訊和媒體訊息）將增加至 500 則（原來為 350 則），用戶可視需求提出要求。請參閱輸送量以瞭解詳細資訊。
如果您已經具備 350 mps 輸送量，系統將自動增加至 500 mps 輸送量。如果您已經提出 350 mps 輸送量的要求，但該程序尚未完成，在完成後您將可接收 500 mps 輸送量。
影音素材 HTTP 快取
我們目前正在對雲端 API 影音素材 HTTP 快取測試版進行測試。如果您是解決方案合作夥伴，請參閱影音素材 HTTP 快取，瞭解如何在伺服器回應中使用標頭，這些標頭可指示我們快取影音素材資產，以在將來的訊息中重複使用。
文件描述
雲端 API 現可支援在傳送給顧客和從顧客接收的文件上使用描述。請參閱影音素材參考資料中的影音素材物件。
2022 年 10 月 12 日
商家電話號碼移轉
您現在可以將商家電話號碼移轉至雲端 API WhatsApp Business 帳號，也可以從雲端 API WhatsApp Business 帳號移轉商家電話號碼。請參閱將電話號碼移轉至不同的 WABA。
2022 年 10 月 6 日
回呼覆寫
僅限雲端 API。
您現在不需為每個 WhatsApp Business 帳號建立不重複的應用程式，即可為每個 WhatsApp Business 帳號使用不同的回呼網址。請參閱覆寫回呼網址以瞭解詳細資訊。
版本 15 呼叫
所有雲端 API 端點現已支援版本 15 呼叫。
訊息範本
僅限雲端 API。
僅使用內文元件（components.type:body）的訊息範本文字參數（components.parameters.text）現在總共可達 32,768 個字元。請參閱參數物件。
每秒訊息數量
僅限雲端 API。
雲端 API 現在可支援的每秒訊息量（mps）（包含簡訊和媒體訊息）將增加至 350 則（原來為 250 則），用戶可視需求提出要求。請參閱輸送量以瞭解詳細資訊。
如果您已經具備 250 mps 輸送量，系統將自動增加至 350 mps 輸送量。如果您已經提出 250 mps 輸送量的要求，但該程序尚未完成，在完成後您將可接收 350 mps 輸送量。
雲端 API - 2022 年 9 月 22 日
心情回應
現已支援心情回應。請參閱傳送訊息 - 心情回應訊息以瞭解如何收發心情回應，以及 Webhook 承載通知範例的承載範例 - 心情回應訊息。
商業簡介
現已支援商業簡介的 about 欄位。請參閱商業簡介以瞭解詳細資訊。
雲端 API – 2022 年 8 月 25 日
動態貼圖
您現在可以在商家主動開啟的出站訊息中包含動態貼圖，並以跟傳送非動態貼圖時一樣的方式接收描述這些訊息的訊息 Webhooks。請參閱訊息物件的 sticker 屬性和動態貼圖素材要求。
產品訊息
您現在可以在傳送給客戶的訊息中包含產品和服務，如此客戶不用離開對話串便能將它們加入購物車。請參閱銷售產品和服務指南，以瞭解如何傳送一或多則產品訊息給客戶。
開發人員通知：宣佈未來 2.43 和 2.45 版向下不相容變更
v2.43 2022 年 10 月11 日
- 自
v2.43起，contacts端點的行為將變更status的回覆將變更。無論用戶是否有 WhatsApp，一律會在回應中傳回status為valid和wa_id。不保證傳回的 wa_id 有效。這些變更既適用於直接回應，也適用於非封鎖呼叫的 Webhook 回應
確保您的代碼在嘗試發送範本訊息時處理潛在的
1013用戶無效錯誤，如果您嘗試將範本訊息傳送到沒有 WhatsApp 帳戶的電話號碼，則會傳回該錯誤對於非範本訊息，向沒有 WhatsApp 帳戶的電話號碼傳送訊息將傳回
470錯誤
v2.45 2023 年 1 月 10 日
從
v2.45開始，shards節點中的選擇性cert參數將變成所有節點的強制項目。請更新您的整合，以在呼叫shards節點時始終包含有效的cert從
v2.41.2開始，商家可以使用application節點，透過webhooks物件中的message物件篩選排除他們沒興趣的已傳送訊息狀態。sent_status將在v2.45中停用，因此請更新您的整合，以在所有 Webhook 控制項的application節點中使用webhooks物件截至
v2.39.1，recipient_id可在statuses物件和message物件中使用。在v2.45中，recipient_id將從statuses物件中移除，因此請更新您的整合以在message物件下使用recipient_id
內部部署 API - 2022 年 9 月 19 日（v2.41.3）
發行 2.41.3
我們的商家 API 用戶端 v2.41.3 版本包括：已在 message_receipt_log 中新增資料表索引，具有高輸送量需求的合作夥伴可從中受益。例如，此改善允許合作夥伴每秒傳送超過 200 則訊息。
內部部署 API - 2022 年 6 月 27 日（v2.41.2）
在 2.41.2 版中，我們引進了 DB 模式變更，以改善系統成效。因此，從 2.37.2 版和 2.39.x 版升級至有數百萬則訊息和聯絡人項目的大型資料庫的設定將比平時花費更長的時間。
普遍來說，請在離峰時間執行升級並先升級較低傳輸量的設定。
如為大型資料庫，請依下列步驟操作：
在升級之前透過 /services/message/gc 端點執行記憶體回收，並確保其成功完成
請使用 dbupgrade 工具先升級 DB 模式，然後再升級版本。完成後，您將能再最短的停機時間內升級 API 版本。強烈建議在使用 dbupgrade 工具之前關閉 API 用戶端。確保 dbupgrade 工具成功完成（退出代碼 0），並在升級過程中避免或限制 API 要求
建議將資料庫伺服器上的查詢逾時時間拉長到一小時，直到升級成功完成。
此用戶端版本包含以下功能和更新：
WhatsApp Business Management API - 2022 年 5 月 19 日
訊息範本類別
/WHATSAPP-BUSINESS-ACCOUNT-ID/message_template 端點的 category 參數的以下值已在 v14.0 以上版本中停用：
|
|
|
我們已新增下列值：
TRANSACTIONALMARKETING
WhatsApp 內部部署 API - 2022 年 5 月 10 日（2.39.4 版）
此用戶端版本包含 v2.39.1 提供的所有功能和修正。此外，此版本：
- 修正在特定情況下無法傳送影片訊息的錯誤。此修正也包含在
v2.39.2中。 - 修正使商家無法向顧客傳送訊息的錯誤，如果顧客是 WhatsApp 上雙方中首先發起互動的人，且該發起發生在 7 天前。此修正也包含在
v2.39.3中。 - 修正使商家無法接收來自客戶的限時訊息的錯誤。安裝
v2.39.4後，商家將透過類型設定為"ephemeral"的 Webhooks 通知收到其收到限時訊息的通知。商家將無法看到訊息的內容。
推出 v2.39.3 時，WhatsApp 會在與客戶的聊天串中自動停用這些訊息，以處理限時訊息的問題。但在 v2.39.4，我們不這樣做。在此版本中，收到限時訊息的商家必須要求客戶停用限時訊息並重新傳送最新的訊息。
WhatsApp 內部部署 API - AWS Service 範本 - 2022 年 5 月 4 日
發行 2.3.8
範本網址
變更紀錄
- 更新適用於 CentOS 7 機器的 AMI
雲端 API - 2022 年 5 月 3 日
從今天開始，雲端 API 包括以下升級：
- 修正與用戶限時訊息有關的問題。
- 更快決定媒體訊息的縮圖品質。
WhatsApp 內部部署 API - AWS Service 範本 - 2022 年 4 月 26 日
發行 2.3.7
範本網址
變更紀錄
- 從使用 pip 轉移到 pip3 以安裝 AWS 起步指令碼。
- 修正 awscli 安裝的問題。
雲端 API - 2022 年 4 月 5 日
從今天開始，所有現有的解決方案合作夥伴和直接客戶都可以使用雲端 API。此外，我們也為雲端 API 開發人員發佈以下功能：
- 新電話驗證選項：透過圖形 API 呼叫驗證您的商家電話號碼。如需詳細資訊，請參閱電話號碼。
- 新轉介 Webhooks：當用戶點擊點擊進入 WhatsApp 並向商家傳送訊息的廣告時，接收 Webhooks 通知。如需詳細資訊，請參閱 Webhooks。請注意，雲端 API 的 Webhooks
referral物件與內部部署 API 的referral物件不同。
此外，我們宣佈使用雲端 API 的第一方開發人員不再需要進行應用程式審核。所有開發人員均需遵守 WhatsApp Business 平台訊息限制。
內部部署 API - 2022 年 3 月 26 日
此版本包含與 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"]
內部部署 API - 2022 年 3 月 25 日
我們的 Business API 用戶端 v2.39.3 版今天將提供給開發人員使用。新用戶端包含兩項修正和額外的日誌，可支援偵錯。兩項修正為：
- 修正使商家無法向顧客傳送訊息的錯誤，如果顧客是 WhatsApp 上雙方中首先發起互動的人，且該發起發生在 7 天前。
- 修正使商家無法接收來自顧客的限時訊息的錯誤。安裝 2.39.3 版後，商家將透過 Webhooks 通知收到其收到限時訊息的通知。最後，客戶會看到一則警告，提示限時訊息模式已關閉。
雲端 API - 2022 年 3 月 15 日
列出訊息和回覆按鈕
從今天開始，雲端 API 試用版用戶可以開始傳送、列出和回覆按鈕訊息。如需更多詳細資訊，請參閱以下文件：
預覽網址
從今天開始，雲端 API 試用版用戶可以在包含網址的簡訊中新增預覽網址 URL 框。詳細資料請參閱以下文件：
新文件指南
內部部署 API - 2022 年 3 月 4 日
我們剛發佈內部部署 API v2.39.2。此版本修正在特定情況下無法傳送影片訊息的錯誤。
已知問題
- 存在一項使商家無法向顧客傳送訊息的錯誤，如果顧客是 WhatsApp 上雙方中首先發起互動的人，且該發起發生在 7 天前。
- 存在一項使商家無法接收來自顧客的限時訊息的錯誤。
雲端 API - 2022 年 3 月 1 日
影片訊息
從今天開始，雲端 API 試用版用戶可以開始收發影片訊息。詳細資訊請參閱以下文件：
2022 年 2 月 1 日
WhatsApp Business 平台
從今天開始，WhatsApp 已從通知型定價模式轉換為對話型定價模式。我們將依每次對話向商家收費，包含在 24 小時期間內送達的所有訊息。如需相關資訊，請參閱對話型定價。
雲端 API
地點和聯絡人訊息
從今天開始，雲端 API 試用版用戶可以開始收發地點和聯絡人訊息。如需更多資訊，請參閱以下文件：
- Webhooks 範例：收到的訊息數量
最大輸送量更新
我們現在支援每個電話號碼每秒 80 則訊息的最大輸送量。這包含入站和出站訊息，以及文字、範本和媒體訊息。
內部部署 API（2.39.1）
我們的 Business API 用戶端 2.39.1 版今天將提供給開發人員使用。新用戶端包含：
設定分片 API
從新的 API 用戶端版本開始，您可以在設定多點連線時提供電話的憑證。這代表，在呼叫 /v1/account/shards 端點時，您可以在 cert 欄位中加入 Base64 編碼的憑證。如需詳細資訊，請參閱使用多點連線擴展 API 用戶端。
新主機名稱
我們將 graph.whatsapp.com 新增至 Business API 用戶端需要連接的 WhatsApp 伺服器主機名稱清單中。如需詳細資訊，請參閱主機名稱網路的設定及偵錯。
錯誤代碼更新
我們在 v2.39 新增了錯誤代碼 1031。您收到此錯誤，是因為您的帳號因違反完整性政策而遭鎖定，無法傳送任何訊息。如需更多資訊，請參閱錯誤和狀態訊息與政策實施。
停用項目
- 訊息 API：
hsm類型將自v2.39起停用。建議您改用template類型。 - 應用程式設定：
webhook_payload_conversation_pricingmodel_disabled應用程式設定已停用。
已知問題
部分影片訊息在特定情況下無法傳送。