您可以使用 Business Management API 建立範本。詳情請參閱建立和管理範本。您也可以使用 WhatsApp 管理工具手動建立。
建立範本後,您便可將其提交以供審查。審查決定結果可能需要最多 24 小時才會出爐。我們作出決定後,便會在 WhatsApp 管理工具中顯示一則通知,並向您的企業管理平台管理員傳送電郵。此外,如果您訂閱了訊息範本狀態變更,我們還會傳送 Webhook 通知。請參閱監察狀態變更。
如果您的訊息範本通過審查,其狀態會被設為使用中 - 品質待確認,此時您便可開始向顧客傳送該範本。如果您的訊息範本被拒絕,您可以編輯範本,然後重新提交以供審查,又或者針對決定提出申訴。
如果您的範本使用變數,您必須在提交時加入變數值範例(媒體資產、文字字串等)。這樣做方便我們了解您的範本向顧客展示時的視覺效果。
如要在 WhatsApp 管理工具中提交內容時加入範例,請首先建立範本並新增範本需要的任何變數,然後點擊「新增範例」按鈕。預覽窗格會顯示您提供的任何媒體資產範例或文字值範例。
如果使用我們的 API 建立範本,請在使用變數的要求中為每個範本元素物件加入 examples
屬性。
提交內容通常因下列原因而被拒,因此,請務必避免此類錯誤。
{{1}}
。#
、$
或 %
。{{1}}
、{{2}}
、{{4}}
和 {{5}}
,但並未設定 {{3}}
。企業支援中心內會顯示一則拒絕通知,當中包含拒絕的理由。您可在企業支援中心查看有哪些範本遭到拒絕,方法是前往帳戶總覽 > 查看我的帳戶(按鈕)>(您的 Meta 商業帳戶)>(您的 WhatsApp Business 帳戶)> 遭拒絕的訊息範本。我們亦會透過電郵通知您範本被拒。
您可以參閱企業支援中心的通知,以找出現有範本當中哪些內容與被拒絕的重複範本相同,並且查看其名稱和所有語言。您也可以選擇編輯範本,然後重新提交。
這項檢查不適用於劃分為 AUTHENTICATION
類別的範本。
您可以使用 WhatsApp 管理工具或訊息範本端點編輯範本。請注意,如果您編輯某個訊息範本並重新提交以供審查,其狀態將被設為審查中;在其狀態改為使用中之前,您無法向顧客傳送該範本。
範本可能處於以下狀態。
您可以前往 WhatsApp 管理工具 > 概覽,將鼠標移到手提箱圖示(帳戶工具)上方,然後點擊「訊息範本」來查看相關範本的狀態。如果您有多個 WhatsApp Business 帳戶,請在右上角下拉式選單的帳戶清單中選擇所需帳戶以查看其範本狀態。
自 2024 年 4 月 30 日起,我們會就營銷範本和工具範本實施範本期間預測。
在範本期間預測機制下,顧客有時間就範本提供早期意見。此機制可以識別並暫停收到負面意見或互動率低的範本,讓您有充足的時間調整其內容,之後才向大批顧客傳送,降低收到負面意見而影響到您商家的機會。
範本期間預測適用於營銷範本和工具範本。新建立的範本、遭暫停後恢復使用的範本和以前可能已建立但未取得 GREEN
品質評分的範本都可能需要接受範本期間預測措施。範本品質記錄(例如品質低導致範本遭暫停)是範本進入期間預測程序的主要原因之一,您可能也會看到其他範本需要接受期間預測程序。
在範本接受期間預測程序期間,系統會在達到不定的門檻之前如常傳送訊息。達到此門檻後,系統就會暫緩傳送使用此範本的後續訊息,以預留充足的時間接收顧客意見。在收到高品質訊號後,系統就會將使用該範本的後續訊息大規模地傳送給整個目標受眾。如果收到低品質訊號,系統將丟棄使用該範本的後續訊息,讓您有機會調整內容和設定目標等。
工具範本只有在被暫停過後才需接受期間預測程序。工具範本被暫停後,新建立的範本、被暫停後恢復使用的範本,以及以前建立但未取得 GREEN 品質評分的範本都可能需要在接下來的 7 天內接受期間預測程序。
訊息端點的即時回應會透過 messages
物件中的新 message_status
屬性,指明訊息是已傳送還是暫緩傳送。API 的所有版本均可提供此回應。
message_status
屬性,其中已處理訊息的值為 accepted
,暫緩傳送訊息的值為 held_for_quality_assessment
。獲接受的訊息將在實際傳送時觸發 sent
和 delivered
Webhooks,這與期間預測程序之前就有的行為相同。請在雲端 API 文件中查看完整的回應範例。message_status
屬性,其中如有 ”Message has been held because quality assessment is pending”
值,則代表訊息被暫緩傳送。已傳送的訊息不會包含此屬性。請在內部部署 API 文件中查看完整的回應範例。如果收到的意見屬正面,令到範本品質評分因此變為高品質,系統便會恢復並如常傳送暫緩訊息。message_template_quality_update
會傳送品質更新,messages
Webhook 會傳送有關訊息已傳送和已送達的最新消息。
如果收到的意見屬負面,令到範本品質因此變為低品質:
status
設為 PAUSED
。"status":"failed"
和 "code":"132015"
(雲端 API 用戶)或 "code":"2061"
(內部部署 API 用戶)的 messages
Webhook。message_template_quality_update
Webhook。請參閱範本暫停,了解如何恢復使用因期間預測機制而被暫停的範本。
請注意,我們設有內部護欄標準,以確保我們在合理的時間內完成評估並作出期間預測決定,以避免對具有時限性的宣傳活動產生影響。我們的目標是,即使執行期間預測機制,輸送量最高的宣傳活動訊息仍能在一小時內送達(99 百分位數)。
因此,如果在系統收到足夠的意見來決定是否將範本品質評分提高或降低之前,已達到設定的內部護欄標準,我們一般便會恢復暫緩的訊息,同時傳送任何適宜的 messages
Webhooks。
某個範本的狀態會自動變更,具體視乎審查決定、申訴結果或其品質評分變動而定。當某個範本的狀態有變時,您將收到 WhatsApp 管理工具通知、電郵和 Webhook 通知。
由於您只能向顧客傳送處於使用中狀態的訊息範本,我們強烈建議您訂閱 message_template_status_update webhook
欄位,以便在範本狀態有變時收取通知。請參閱 Webhooks 設定以了解如何訂閱此欄位,另請參閱訊息範本更新以查看 Webhook 裝載範例。
如果您設定了 Webhooks,並且看到特定訊息範本的品質正在下降,請前往 WhatsApp 管理工具 > 訊息範本,將鼠標移到有問題的訊息範本上方。此時應該會出現工具提示,當中顯示與問題性質相關的資訊。根據這項資訊,您可編輯範本並提交範本以供重新審查、使用不同的範本或更改應用程式的業務邏輯。如果您編輯了訊息範本而且該範本通過審查,您便可向顧客傳送該範本,只要未有頻繁收到負面意見或讀取率不低,其品質評分便會逐漸提升。
我們會根據使用情況及顧客意見和互動情況,為每個訊息範本提供一個品質評分。訊息範本只要處於使用中狀態,您便會在 WhatsApp 管理工具中看到其評分,緊隨訊息範本狀態及連字號後顯示:
如果訊息範本通過審查,其最初的評分會是品質待確認。如果某個訊息範本不斷收到負面意見或互動情況欠佳,這最終會導致該範本的狀態改變。只要訊息範本處於使用中狀態,無論品質評級如何,您都可將其傳送給顧客。不過,一旦訊息範本改為任何其他狀態,則在其重新變為「使用中」之前,您無法將其傳送給顧客。
透過訂閱 message_template_quality_update
欄位,您可以在範本品質評分有所變化時收到通知。
請參閱訊息範本品質更新以查看 Webhooks 裝載範例。
如果訊息範本處於最低品質評分(正常使用中—低品質),便將自動被暫停一段時間,以保障使用該範本的電話號碼之品質評分。暫停時間如下所示:
當某個訊息範本被暫停(處於已暫停狀態)時,您無法向顧客傳送該範本,因此您應停止進行任何依賴該範本的自動發訊宣傳活動。如果您嘗試向顧客傳送被暫停的訊息範本,您無需就此付費,而且這次嘗試也不會計入您的收發訊息限制,不過,API 仍會拒絕此類嘗試。您只應在該範本的狀態再次設為使用中時,才恢復此類宣傳活動。
如果您認為編輯範本內容可以減少所收到的負面意見數量或增加用戶互動率,您可編輯已暫停的範本。請注意,當您編輯某個訊息範本並重新提交以供審查後,其狀態便會變為審查中;在其重新通過審查且狀態設為使用中之前,您無法向顧客傳送該範本。
如果您認為是業務邏輯(目標受眾、傳送參數等)導致負面意見或互動情況欠佳,您可修改業務邏輯。
暫停範本一開始不會影響傳送訊息範本的商家電話號碼,該電話號碼的收發訊息限制也不會因此下降。您可以繼續使用該電話號碼傳送其他高品質訊息範本。不過,如果商家持續傳送處於低品質狀態的訊息範本,該電話號碼最終也有可能受到影響。
訊息範本被暫停後,我們將透過 WhatsApp 管理工具通知和電郵通知您;如果您訂閱了訊息範本變更 Webhooks,我們還會傳送 Webhook 通知。請參閱監察狀態變更以了解 Webhook 設定資訊,另請參閱範例:已暫停範本以查看 Webhook 裝載範例。
在達到上方列出的暫停時間後,範本將自動恢復使用。該範本恢復使用後,其狀態便會被設為使用中,並且您可以開始再次向顧客傳送該範本。如果您沒有停止進行依賴已暫停範本的任何自動發訊宣傳活動,應該可以再次開始此類宣傳活動。不過,直至範本恢復之前,我們建議您停止進行任何用到已暫停範本的宣傳活動,因為我們的 API 無論如何都會拒絕您的要求。
我們亦會根據該範本收到的最近顧客意見,將其品質評分重設為其他值。
與暫停通知類似,一旦範本的狀態改為使用中,我們便將透過 WhatsApp 管理工具通知、電郵和 Webhook 告知您。
由 2023 年 9 月 12 日開始適用於巴西、哥倫比亞和新加坡境內的企業。由 2023 年 10 月 12 日開始適用於所有企業。
在推出範本期間預測機制之時,我們還將一同推出透過以下方式恢復使用任何遭暫停範本的功能:
/{whats_app_message_template_id}/unpause
發出 POST 要求。 請注意,在範本期間預測程序期間遭暫停的範本,需要透過 API 或 WhatsApp 管理工具手動恢復使用,才能再次使用。