範本

範本在範本訊息中用於與顧客展開營銷、工具和驗證對話。有別於自由格式的訊息,如果顧客未曾向您傳送訊息或在過去 24 小時內未向您傳送過訊息,範本訊息是您唯一可向其傳送的訊息類型。

範本必須經過批准方能以範本訊息格式傳送。此外,根據顧客意見和互動情況,系統或會自動停用範本。範本一被停用,便無法再次以範本訊息格式傳送,直至其品質評分有所改善或範本不再違反我們的商業政策商務政策

建立

您可以使用 Business Management API 建立範本。詳情請參閱建立和管理範本。您也可以使用 WhatsApp 管理工具手動建立

審查程序

建立範本後,您便可將其提交以供審查。審查決定結果可能需要最多 24 小時才會出爐。我們作出決定後,便會在 WhatsApp 管理工具中顯示一則通知,並向您的企業管理平台管理員傳送電郵。此外,如果您訂閱了訊息範本狀態變更,我們還會傳送 Webhook 通知。請參閱監察狀態變更

如果您的訊息範本通過審查,其狀態會被設為使用中 - 品質待確認,此時您便可開始向顧客傳送該範本。如果您的訊息範本被拒絕,您可以編輯範本,然後重新提交以供審查,又或者針對決定提出申訴

範例

如果您的範本使用變數,您必須在提交時加入變數值範例(媒體資產、文字字串等)。這樣做方便我們了解您的範本向顧客展示時的視覺效果。

如要在 WhatsApp 管理工具中提交內容時加入範例,請首先建立範本並新增範本需要的任何變數,然後點擊「新增範例」按鈕。預覽窗格會顯示您提供的任何媒體資產範例或文字值範例。


如果使用我們的 API 建立範本,請在使用變數的要求中為每個範本元素物件加入 examples 屬性。

被拒絕的常見原因

提交內容通常因下列原因而被拒,因此,請務必避免此類錯誤。

  • 欠缺變數參數或所用的大括號不符。正確的格式為 {{1}}
  • 變數參數包含特殊字元,例如 #$%
  • 變數參數不連貫。例如已定義 {{1}}{{2}}{{4}}{{5}},但並未設定 {{3}}
  • 相對於訊息長度,範本包含太多變數參數。您需要減少變數參數的數量或增加訊息長度。
  • 訊息範本不得以參數結尾。
  • 訊息範本包含違反 WhatsApp 商務政策的內容:在您出售商品或服務時,我們會將與商品或服務相關的所有訊息和媒體視為交易的一部分,包括任何說明、價格、費用、稅項和/或任何法律規定的必要披露內容。所有交易均須遵循 WhatsApp 商務政策
  • 訊息範本包含違反 WhatsApps 商業政策的內容:請勿要求用戶提供敏感識別資料。例如,請勿要求用戶提供完整的個人付款卡號碼、財務帳戶號碼、國民身分證號碼或其他敏感識別資料,其中包括不可要求用戶提供可能包含敏感識別資料的文件。不過,您可以要求用戶提供部分敏感識別資料,例如是其社會安全號碼的最後 4 位。
  • 內容包含可能具辱罵性或威脅性的內容,例如以法律訴訟威脅顧客或威脅要公開羞辱他們。
  • 訊息範本與另一個現有範本重複。如果所提交範本正文和註腳中的措辭與現有範本的相關內容一樣,這個內容重複的範本便會遭拒絕。

企業支援中心內會顯示一則拒絕通知,當中包含拒絕的理由。您可在企業支援中心查看有哪些範本遭到拒絕,方法是前往帳戶總覽 > 查看我的帳戶(按鈕)>(您的 Meta 商業帳戶)>(您的 WhatsApp Business 帳戶)> 遭拒絕的訊息範本。我們亦會透過電郵通知您範本被拒。

您可以參閱企業支援中心的通知,以找出現有範本當中哪些內容與被拒絕的重複範本相同,並且查看其名稱和所有語言。您也可以選擇編輯範本,然後重新提交。

這項檢查不適用於劃分為 AUTHENTICATION 類別的範本。

編輯

您可以使用 WhatsApp 管理工具訊息範本端點編輯範本。請注意,如果您編輯某個訊息範本並重新提交以供審查,其狀態將被設為審查中;在其狀態改為使用中之前,您無法向顧客傳送該範本。

傳送範本

範本一經批准,即其 status 設為 ACTIVE,您便可開始向顧客傳送有關範本。如要使用雲端 API 傳送範本,請參閱傳送訊息範本。如要使用內部部署 API 傳送範本,請參閱傳送訊息範本

請注意,視乎顧客意見和互動情況,訊息範本的 status 可能自動從 ACTIVE 變為 PAUSEDDISABLED。因此,我們建議您監察狀態變更,並在您依賴的訊息範本變成「已暫停」或「已停用」狀態時或有可能變成此等狀態時採取適當行動。

狀態

範本可能處於以下狀態。

  • 審查中:表示範本正在接受審查。審查最長需時 24 小時。
  • 已被拒:範本在審查過程中被拒絕,或違反我們的一項或多項政策規定。請參閱申訴
  • 使用中 - 品質待確認:訊息範本尚未收到顧客的品質意見或讀取率資訊。您可以向顧客傳送處於此狀態的訊息範本。請參閱品質評分
  • 使用中 - 高品質:範本幾乎沒有收到顧客的負面意見。您可以向顧客傳送處於此狀態的訊息範本。請參閱品質評分
  • 使用中 - 中等品質:範本收到多位顧客的負面意見或讀取率低,但可能很快會被暫停或停用。您可以向顧客傳送處於此狀態的訊息範本。請參閱品質評分
  • 使用中 - 低品質:範本收到多位顧客的負面意見或讀取率低。您仍可向顧客傳送處於此狀態的訊息範本,但此類範本可能很快會被暫停或停用,所以我們建議您解決顧客回報的問題。請參閱品質評分
  • 已暫停:範本因反覆收到顧客的負面意見或讀取率低而被暫停。您無法向顧客傳送處於此狀態的訊息範本。請參閱範本暫停
  • 已停用:範本因反覆收到顧客的負面意見而被停用。您無法向顧客傳送處於此狀態的訊息範本。
  • 已提出申訴:表示經已提出申訴要求。請參閱申訴

您可以前往 WhatsApp 管理工具 > 概覽,將鼠標移到手提箱圖示(帳戶工具)上方,然後點擊「訊息範本」來查看相關範本的狀態。如果您有多個 WhatsApp Business 帳戶,請在右上角下拉式選單的帳戶清單中選擇所需帳戶以查看其範本狀態。

範本調節

自 2024 年 4 月 30 日起,我們會就營銷範本和工具範本實施範本期間預測。

在範本期間預測機制下,顧客有時間就範本提供早期意見。此機制可以識別並暫停收到負面意見或互動率低的範本,讓您有充足的時間調整其內容,之後才向大批顧客傳送,降低收到負面意見而影響到您商家的機會。

範本期間預測適用於營銷範本和工具範本。新建立的範本、遭暫停後恢復使用的範本和以前可能已建立但未取得 GREEN 品質評分的範本都可能需要接受範本期間預測措施。範本品質記錄(例如品質低導致範本遭暫停)是範本進入期間預測程序的主要原因之一,您可能也會看到其他範本需要接受期間預測程序。

在範本接受期間預測程序期間,系統會在達到不定的門檻之前如常傳送訊息。達到此門檻後,系統就會暫緩傳送使用此範本的後續訊息,以預留充足的時間接收顧客意見。在收到高品質訊號後,系統就會將使用該範本的後續訊息大規模地傳送給整個目標受眾。如果收到低品質訊號,系統將丟棄使用該範本的後續訊息,讓您有機會調整內容和設定目標等。

工具範本期間預測

工具範本只有在被暫停過後才需接受期間預測程序。工具範本被暫停後,新建立的範本、被暫停後恢復使用的範本,以及以前建立但未取得 GREEN 品質評分的範本都可能需要在接下來的 7 天內接受期間預測程序。

API 行為

訊息端點的即時回應會透過 messages 物件中的新 message_status 屬性,指明訊息是已傳送還是暫緩傳送。API 的所有版本均可提供此回應。

  • 雲端 API 一律包含 message_status 屬性,其中已處理訊息的值為 accepted,暫緩傳送訊息的值為 held_for_quality_assessment。獲接受的訊息將在實際傳送時觸發 sentdelivered Webhooks,這與期間預測程序之前就有的行為相同。請在雲端 API 文件中查看完整的回應範例。
  • 內部部署 API 包含 message_status 屬性,其中如有 ”Message has been held because quality assessment is pending” 值,則代表訊息被暫緩傳送。已傳送的訊息不會包含此屬性。請在內部部署 API 文件中查看完整的回應範例。

如果收到的意見屬正面,令到範本品質評分因此變為高品質,系統便會恢復並如常傳送暫緩訊息。message_template_quality_update 會傳送品質更新,messages Webhook 會傳送有關訊息已傳送和已送達的最新消息。

如果收到的意見屬負面,令到範本品質因此變為低品質

  • 系統會將範本的 status 設為 PAUSED
  • 系統會傳送 message_template_status_update,其中 event 的值為 paused
  • 每則暫緩傳送的訊息都將被棄置,並且會觸發含有 "status":"failed""code":"132015"(雲端 API 用戶)或 "code":"2061"(內部部署 API 用戶)的 messages Webhook。
  • 如果品質有變,便會觸發 message_template_quality_update Webhook。
  • 系統將透過 Meta Business Suite 通知、WhatsApp 管理工具橫額和電郵聯絡擁有 WhatsApp Business 帳戶的商家管理員,告訴他們相關訊息已被棄置。

請參閱範本暫停,了解如何恢復使用因期間預測機制而被暫停的範本。

請注意,我們設有內部護欄標準,以確保我們在合理的時間內完成評估並作出期間預測決定,以避免對具有時限性的宣傳活動產生影響。我們的目標是,即使執行期間預測機制,輸送量最高的宣傳活動訊息仍能在一小時內送達(99 百分位數)。

因此,如果在系統收到足夠的意見來決定是否將範本品質評分提高或降低之前,已達到設定的內部護欄標準,我們一般便會恢復暫緩的訊息,同時傳送任何適宜的 messages Webhooks。

監察狀態變更

某個範本的狀態會自動變更,具體視乎審查決定、申訴結果或其品質評分變動而定。當某個範本的狀態有變時,您將收到 WhatsApp 管理工具通知、電郵和 Webhook 通知。

由於您只能向顧客傳送處於使用中狀態的訊息範本,我們強烈建議您訂閱 message_template_status_update webhook 欄位,以便在範本狀態有變時收取通知。請參閱 Webhooks 設定以了解如何訂閱此欄位,另請參閱訊息範本更新以查看 Webhook 裝載範例。

如果您設定了 Webhooks,並且看到特定訊息範本的品質正在下降,請前往 WhatsApp 管理工具 > 訊息範本,將鼠標移到有問題的訊息範本上方。此時應該會出現工具提示,當中顯示與問題性質相關的資訊。根據這項資訊,您可編輯範本並提交範本以供重新審查、使用不同的範本或更改應用程式的業務邏輯。如果您編輯了訊息範本而且該範本通過審查,您便可向顧客傳送該範本,只要未有頻繁收到負面意見或讀取率不低,其品質評分便會逐漸提升。

品質評分

我們會根據使用情況及顧客意見和互動情況,為每個訊息範本提供一個品質評分。訊息範本只要處於使用中狀態,您便會在 WhatsApp 管理工具中看到其評分,緊隨訊息範本狀態及連字號後顯示:

  • 使用中 - 品質待確認(以綠色字體顯示)
  • 使用中 - 高品質(以綠色字體顯示)
  • 使用中 - 中等品質(以黃色字體顯示)
  • 使用中 - 低品質(以紅色字體顯示)

如果訊息範本通過審查,其最初的評分會是品質待確認。如果某個訊息範本不斷收到負面意見或互動情況欠佳,這最終會導致該範本的狀態改變。只要訊息範本處於使用中狀態,無論品質評級如何,您都可將其傳送給顧客。不過,一旦訊息範本改為任何其他狀態,則在其重新變為「使用中」之前,您無法將其傳送給顧客。

透過訂閱 message_template_quality_update 欄位,您可以在範本品質評分有所變化時收到通知。

請參閱訊息範本品質更新以查看 Webhooks 裝載範例。

範本暫停

如果訊息範本處於最低品質評分(正常使用中—低品質),便將自動被暫停一段時間,以保障使用該範本的電話號碼之品質評分。暫停時間如下所示:

  • 第 1 次:暫停 3 小時
  • 第 2 次:暫停 6 小時
  • 第 3 次:停用

當某個訊息範本被暫停(處於已暫停狀態)時,您無法向顧客傳送該範本,因此您應停止進行任何依賴該範本的自動發訊宣傳活動。如果您嘗試向顧客傳送被暫停的訊息範本,您無需就此付費,而且這次嘗試也不會計入您的收發訊息限制,不過,API 仍會拒絕此類嘗試。您只應在該範本的狀態再次設為使用中時,才恢復此類宣傳活動。

如果您認為編輯範本內容可以減少所收到的負面意見數量或增加用戶互動率,您可編輯已暫停的範本。請注意,當您編輯某個訊息範本並重新提交以供審查後,其狀態便會變為審查中;在其重新通過審查且狀態設為使用中之前,您無法向顧客傳送該範本。

如果您認為是業務邏輯(目標受眾、傳送參數等)導致負面意見或互動情況欠佳,您可修改業務邏輯。

暫停範本一開始不會影響傳送訊息範本的商家電話號碼,該電話號碼的收發訊息限制也不會因此下降。您可以繼續使用該電話號碼傳送其他高品質訊息範本。不過,如果商家持續傳送處於低品質狀態的訊息範本,該電話號碼最終也有可能受到影響。

暫停通知

訊息範本被暫停後,我們將透過 WhatsApp 管理工具通知和電郵通知您;如果您訂閱了訊息範本變更 Webhooks,我們還會傳送 Webhook 通知。請參閱監察狀態變更以了解 Webhook 設定資訊,另請參閱範例:已暫停範本以查看 Webhook 裝載範例。

恢復使用

在達到上方列出的暫停時間後,範本將自動恢復使用。該範本恢復使用後,其狀態便會被設為使用中,並且您可以開始再次向顧客傳送該範本。如果您沒有停止進行依賴已暫停範本的任何自動發訊宣傳活動,應該可以再次開始此類宣傳活動。不過,直至範本恢復之前,我們建議您停止進行任何用到已暫停範本的宣傳活動,因為我們的 API 無論如何都會拒絕您的要求。

我們亦會根據該範本收到的最近顧客意見,將其品質評分重設為其他值。

與暫停通知類似,一旦範本的狀態改為使用中,我們便將透過 WhatsApp 管理工具通知、電郵和 Webhook 告知您。

由 2023 年 9 月 12 日開始適用於巴西、哥倫比亞和新加坡境內的企業。由 2023 年 10 月 12 日開始適用於所有企業。

在推出範本期間預測機制之時,我們還將一同推出透過以下方式恢復使用任何遭暫停範本的功能:

請注意,在範本期間預測程序期間遭暫停的範本,需要透過 API 或 WhatsApp 管理工具手動恢復使用,才能再次使用。

申訴

如果您提交的內容被拒絕,您可以提出申訴。請注意,申訴內容必須包含範例。如果通過審查的範本被停用,您亦可加以編輯,然後重新提交以供審查。

WhatsApp 管理工具中:

  1. 將鼠標移到手提箱圖示(帳戶工具)上方,然後點擊訊息範本
  2. 如果您有多個 WhatsApp Business 帳戶,請在右上角的下拉式選單中選擇所需帳戶以管理其範本。
  3. 找出並點擊您想編輯的訊息範本。
  4. 編輯該範本的內容。
  5. 點擊「新增範例」按鈕,並新增變數值範例及圖像範例。
  6. 點擊「提交」。

我們將在 24 小時內審查申訴並作出決定。

了解詳情