訊息範本

企業必須使用訊息範本來開啟營銷、工具和驗證對話。這些對話可以是顧客服務訊息、預約提醒、付款及送貨更新資訊、警示等。

必要條件

• 訊息範本必須先獲得批准，才能用於開啟對話。了解詳情。
• 如要與顧客開啟營銷、工具和驗證對話，該顧客必須已選擇同意接收您企業傳送的訊息。了解詳情。

支援的範本類別

請參閱類別。

翻譯

傳送資訊範本時，您需要使用 language 欄位來指定語言。您的企業需提供要使用的所有翻譯。

支援語言

語言套件

系統會以語言套件形式儲存訊息範本。語言套件是特定語言或本地語言的訊息範本素材套件。如果企業支援最少一種語言或本地語言的翻譯，則系統會為該語言或本地語言建立套件。

訊息範本命名空間即是特定企業的語言套件組合。

語言政策選項

如果傳送訊息範本時 language: policy 欄位設定為 deterministic（預設值），WhatsApp 會完全按照要求的語言和本地語言傳送訊息範本。隨後裝置會向伺服器查詢，以獲取該特定語言的語言套件。

當此訊息送達裝置時，裝置會作出以下動作：

• 政策／代碼檢查：在 "policy": "deterministic" 及 "code": "en" 的情況下，裝置是否有已快取的 en 套件？

  • 如果是，則移至素材檢查。
  • 如果否，能否在伺服器找到 en 套件？

    • 如果是，更新本機快取並前往素材檢查。
    • 如果否，請記錄失敗事件，伺服器會透過 Webhook 傳回 structure_unavailable 錯誤，而且裝置不會顯示任何訊息。

• 素材檢查："element": "hello_world" 素材是否存在？

  • 如果是，解壓縮參數，並在裝置中顯示訊息。
  • 如果否：

    • 如果語言套件來自本機快取，則從伺服器下載最新的 en 套件，然後重複執行素材檢查。
    • 如果語言套件是最近才從伺服器下載，則記錄失敗事件，伺服器會透過 Webhook 傳回 structure_unavailable 錯誤，而且裝置不會顯示任何訊息。

系統將會完全略過裝置的語言／本地語言設定。

使用 deterministic 政策時，如果您所要求的內容並不存在，便會出現問題。請確保以下事項：

• 命名空間正確無誤
• 素材名稱正確無誤
• 該素材擁有語言／本地語言翻譯
• 已傳送參數的數量與訊息範本所指定的數量一致

本地化

訊息範本可根據裝置的本地語言設定提供本地化訊息，從而為您提供現成的本地化支援。

本地化參數

範本擁有能夠動態時刻與訊息整合的參數。對於本文件所使用的範例，訊息範本如下所示：

"You made a purchase for {{1}} using a credit card ending in {{2}}."

若是使用 "namespace": "cdb2df51_9816_c754_c5a4_64cdabdcad3e" 且含有 "element_name": "purchase_with_credit_card"，請使用您列出的第一個值來替換範本訊息中的 {{1}} 變數，並使用您列出的第二個值來替換 {{2}} 變數。

其中一些參數（如 date_time 或 currency）可以本地化，因此會根據顧客的語言和本地語言偏好來顯示內容。如果裝置在本地化參數時失敗，則裝置會預設為 fallback_value。

如需指定 fallback_value 以外的貨幣和日期，請使用 currency 和 date_time 物件。這樣，用戶端便能夠儘量以最佳方法本地化數據，並僅在無法本地化數據時才會預設為 fallback_value。

下方的表格展示 localizable_params 選項：

參數

currency 物件

Whatsapp Business API 用戶端會嘗試根據指定的本地化要求，設定貨幣的格式。

範例

{
    "type": "currency",
    "currency" : {
        "fallback_value": "$230.99",
        "code": "USD",
        "amount_1000": 230990
    }
}  

date_time 物件

Whatsapp Business API 用戶端會嘗試根據指定的本地化要求，設定日期／時間的格式。支援的日期和時間格式如下所示：

• 組合時間格式 — 由各個時間元素組成的時間（如星期幾、月份、小時等）無論客戶位於哪個時區，指定的時間都將保持一致。
• Unix 時間格式 — 根據客戶的所在時區顯示時間。

DateTime

DateTimeComponent

範例

{
    "type": "date_time",
    "date_time" : {
        "fallback_value": "October 25, 2020",
        "day_of_week": "Saturday",
        "day_of_month": 25,
        "year": 2020,
        "month": 10,
        "hour": 12,
        "minute": 0
    }
}

DateTimeUnixEpoch

後續步驟

此文件包含訊息範本的參考資料。有關如何建立和傳送範本的指南，請參閱傳送訊息範本。對於訊息範本中可以使用的所有參數，請參閱訊息，訊息範本。

https://developers.facebook.com/docs/whatsapp/message-templates/creation#step-1--create-template-using-the-whatsapp-manager