easyCoexistence
登入開始免費試用
Meta Tech Provider

傳送含變數的訊息範本

訊息範本變數按位置排列,不是按名稱排列。您要按次序,為每個元件傳送參數清單,而數量必須完全符合範本定義。次序或數量出錯會產生 3 種不同錯誤,每種都指向不同問題。

132000

參數數量與範本不一致時顯示的錯誤。

132012

參數格式不符合要求時顯示的錯誤。

132001

範本名稱和語言無法解析時顯示的錯誤。

如何配對參數

按位置配對,不是按名稱配對。內文清單中的第 1 個參數會填入第 1 個佔位符,第 2 個參數會填入第 2 個,依此類推。您無法為變數命名,而交換兩個參數後,訊息仍會成功傳送,只是數值會出現在錯誤位置。

這種情況最危險,因為不會出現任何失敗。客戶收到訂單確認時,日期出現在金額應有的位置,而且任何地方都不會記錄錯誤。

元件是分開的清單

標頭變數和內文變數不共用同一個清單。每個元件都有自己的參數,將它們合併便會造成數量不一致。

  • 標頭參數放在標頭元件內,而且最多只有一個。
  • 內文參數放在內文元件內,並按次序排列。
  • 按鈕 URL 參數放在按鈕元件內,並按按鈕編號排列。
  • 為所有參數傳送一個扁平清單會返回錯誤 132000。

正確處理語言

範本由名稱和語言共同識別,因此同一名稱的兩種語言代表兩個範本。範本以 en_US 建立時,傳送 en 不會自動改用備用語言,而會因錯誤 132001 失敗,錯誤訊息會顯示範本不存在。

列出該號碼的範本,並複製準確的語言字串,不要自行假設其格式。這是最常見的範本錯誤,也是描述最不清晰的一種。

具有類型的參數

大部分參數都是純文字,但部分參數不是。若將這些參數當作文字傳送,便會因錯誤 132012 而失敗。

  • 貨幣參數包含金額、貨幣代碼和備用字串。
  • 日期和時間參數包含帶有備用值的結構化物件。
  • 媒體標頭參數包含媒體 ID 或連結,而不是檔案名稱。
  • 如果收件者的應用程式無法格式化數值,便會顯示備用字串。

每個錯誤代表甚麼

這 3 種失敗可以區分。如果分開記錄,而不是統稱為範本錯誤,便能大幅減少猜測。

錯誤 132001 代表名稱和語言組合無法解析,因此先檢查語言。錯誤 132000 代表數量錯誤,因此要與範本本身的定義比較。錯誤 132012 代表數值格式錯誤,通常是把具有類型的參數當作純文字字串傳送。

常見錯誤

  • 以為 en 會自動改用 en_US。實際不會,錯誤訊息會顯示範本不存在。
  • 將標頭和內文參數合併成一個清單。它們屬於分開的元件。
  • 將貨幣或日期當作純文字傳送。具有類型的參數有固定格式。
使用 EasyCoexistence 完成這項設定

EasyCoexistence 會透過控制台和 MCP 連接器列出範本的準確名稱及語言代碼,讓傳送時使用 Meta 實際儲存的值。

常見問題

訊息範本變數有名稱嗎?

沒有。它們按位置排列,因此參數次序就是全部規則。

為甚麼我的範本不存在?

通常是語言代碼有誤。範本由名稱和語言共同識別,而且不設備用語言。

如果我傳送太多參數會怎樣?

錯誤 132000。參數過多和過少會以相同方式失敗。

如何傳送金額?

使用包含金額、貨幣代碼和備用字串的貨幣參數,而不是純文字。

繼續閱讀

準備開始嗎?

幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。

開始免費試用

驗證日期

傳送含變數的訊息範本