傳送訊息範本時,您需要使用 language
欄位指定語言。貴企業應對您要使用的所有翻譯負責。
訊息範本會儲存在語言套件中。語言套件是一組適用於特定語言或地區設定的訊息範本元素。若企業對特定語言或地區設定至少支援一種翻譯,系統就會建立該語言或地區的套件。
訊息範本命名空間是屬於特定企業的一組語言套件。
傳送訊息範本時,若將 language: policy
欄位設為 deterministic
(預設值),WhatsApp 將按照要求的語言和地區設定,確切傳遞訊息範本。然後,裝置會向伺服器查詢符合該特定語言的語言套件。
此訊息送達裝置時,裝置會執行下列程序:
"policy": "deterministic"
和 "code": "en"
時,裝置是否包含快取的 en
套件?
en
套件嗎?
structure_unavailable
錯誤,裝置也不會轉譯任何訊息。"element": "hello_world"
元素是否存在?
en
套件,然後重複元素檢查。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}} 變數。
傳遞至承載的參數數量必須符合 template
物件中的參數數量。若非如此,您會收到回呼,讓您知道顯示訊息範本時發生問題。
其中一些參數(例如 date_time
或 currency
)支援本地化,因此能夠根據顧客的語言和地區設定偏好設定正確顯示。若裝置未能成功將參數本地化,則系統預設為 fallback_value
。
如需指定 fallback_value
以外的幣別和日期,請使用 currency
和 date_time
物件。這種作法能讓用戶端盡可能以最好的方式將資料本地化,且只有在無法將資料本地化的情況下,才會預設為 fallback_value
。
下表列出 localizable_params
選項:
名稱 | 說明 |
---|---|
類型:字串 | 必要項目。 本地化失敗時的預設文字。所有本地化參數都要有一個遞補值。指定文字時,只需要提供遞補值即可。 |
類型: | 選用項目。 若使用 |
類型: | 選用項目。 若使用 |
currency
物件Whatsapp Business API 用戶端會嘗試依照指定的本地化規格將幣別格式化。
名稱 | 說明 |
---|---|
類型:字串 | 必要項目。 ISO 4217 定義的幣別代碼。 |
類型:整數 | 必要項目。 乘以 1,000 的金額。 |
{ "type": "currency", "currency" : { "fallback_value": "$230.99", "code": "USD", "amount_1000": 230990 } }
date_time
物件Whatsapp Business API 用戶端會嘗試依照指定的本地化將日期/時間格式化。支援的日期和時間格式包括:
名稱 | 說明 |
---|---|
| 若 採用元件的日期/時間。 |
| 若 採用 Unix epoch 的日期/時間。 |
至少需要此兩個欄位之一:component
或 unix_epoch
。若使用,只能使用其中之一。
名稱 | 說明 |
---|---|
類型:字串 | 選用項目。 如果與衍生自日期的值不同(若有指定),請使用衍生值。字串和數字皆可接受。 |
類型:整數 | 選用項目。 年。 |
類型:整數 | 選用項目。 月。 |
類型:整數 | 選用項目。 當月日期。 |
類型:整數 | 選用項目。 時。 |
類型:整數 | 選用項目。 分。 |
類型:字串 | 選用項目。 行事曆類型。 |
{ "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
將停用。DateTimeComponent
將是之後的預設值。請變更您的代碼以避免發生問題。
名稱 | 說明 |
---|---|
類型:整數 | 必要項目。 Epoch 時間戳記(以秒為單位)。此欄位預計將停用。 |