範本基本入門

Updated: 2026年5月21日

為 LLM 複製

本文件會涵蓋適用於所有範本類別的範本機制。如需特定類別的範本指南，請參閱「營銷訊息」、「公用訊息」和「驗證訊息」。

範本是訊息帳戶的資產，可透過雲端 API 或 WhatsApp 營銷訊息 API 以範本訊息的形式傳送。這也是唯一一種可在非顧客服務期間向 WhatsApp 用戶傳送的訊息類型，通常用於批量向用戶傳送訊息，或在您與用戶之間沒有已開啟的顧客服務期間時向用戶傳送訊息。

建立

使用訊息範本 API 或 WhatsApp 管理工具的訊息範本面板⁠建立範本。

經由 API 建立的範本使用常用語法。大部分的變數發生在用於為範本指定類別的 category 字串，以及定義組成範本元件的 components 陣列。

您每小時最多可在一個訊息帳戶中建立 100 個範本。

常用語法

curl 'https://graph.facebook.com/v23.0/102290129340398/message_templates' \
-H 'Authorization: Bearer EAAJB...' \
-H 'Content-Type: application/json' \
-d '
{
"name": "<NAME>",
"category": "<CATEGORY>",
"language": "<LANGUAGE>",
"parameter_format": "<PARAMETER_FORMAT>",
"components": [<COMPONENTS>]
}'

名稱

每個範本都必須設定名稱，但這些名稱可以重複。這樣的彈性允許您以相同名稱，建立多個不同語言的範本。

範本名稱最多可包含 512 個字元，且只能由小楷英數字元和底線組成。

類別

每個範本都必須歸類為「驗證」、「營銷」或「公用」。範本分類文件說明了如何為範本指派正確的類別，以及當範本類別有誤時會發生什麼情況。

請注意，範本類別也會影響定價。

元件

範本是由各種文字、影音內容及互動式用戶介面元件組成，您可在建立範本時自行定義這些元件。範本元件指南說明了所有可用元件及其定義方式。

由於可選元件眾多，請參閱「驗證訊息」、「營銷訊息」及「公用訊息」章節，以查看特定類別的範本指南及程式碼範例，了解如何使用常用元件建立各種範本。

語言

您必須在建立範本時指派範本語言代碼。範本中的字串和變數並非由 Meta 翻譯，因此您需自行提供對應語言的字串和參數範例。

如果您以同一個名稱建立了使用不同語言的多個範本，每個範本都會計入您的範本限制。

參數格式

有些範本元件允許您定義包含一個或多個參數的字串（在 WhatsApp 管理工具中稱為「變數」）。在您傳送範本時，這些變數會替換為您在傳送訊息裝載中加入的值。

建立範本時，如果字串包含一個或多個參數，您可以指定參數格式：named 或 positional；您亦必須為每個參數提供範例值。如果您沒有指定格式，範本會預設使用 positional 格式。

已命名參數

使用命名格式的參數必須為不重複的單一字串，且由小楷字母和底線組成，並用兩個括號括住，例如 {{first_name}}。範本建立裝載中的範例值以及範本傳送裝載中的實際值，可以按任何順序出現。

範本建立裝載範例（含命名參數）：

{
"name": "order_confirmation",
"language": "en_US",
"category": "utility",
"parameter_format": "named",
"components": [
  {
    "type": "body",
    "text": "Thank you, {{first_name}}! Your order number is {{order_number}}.",
    "example": {
      "body_text_named_params": [
        {
          "param_name": "first_name",
          "example": "Pablo"
        },
        {
          "param_name": "order_number",
          "example": "860198-230332"
        }
      ]
    }
  }
]
}

使用命名參數的範本傳送裝載範例：

{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "+16505551234",
"type": "template",
"template": {
  "name": "order_confirmation",
  "language": {
    "code": "en_US"
  },
  "components": [
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "parameter_name": "first_name",
          "text": "Jessica"
        },
        {
          "type": "text",
          "parameter_name": "order_number",
          "text": "SKBUP2-4CPIG9"
        }
      ]
    }
  ]
}
}

位置參數

位置參數必須為有序的陣列索引編號（從 1 開始），並用兩個括號括住（{{1}}、{{2}}……如此類推）。範本建立裝載中的範例值和範本傳送裝載的實際值，必須按照它們在元件文字字串中對應的預留位置出現的順序排列。

範本建立裝載範例（含位置參數）：

{
"name": "order_confirmation",
"language": "en_US",
"category": "utility",
"parameter_format": "positional",
"components": [
  {
    "type": "body",
    "text": "Hi {{1}}! Your order number is {{2}}. Thank you.",
    "example": {
      "body_text": [
        [
          "Pablo",
          "860198-230332"
        ]
      ]
    }
  }
]
}

使用位置參數的範本傳送裝載範例：

{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "+16505551234",
"type": "template",
"template": {
  "name": "order_confirmation",
  "language": {
    "code": "en_US"
  },
  "components": [
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "text": "Jessica"
        },
        {
          "type": "text",
          "text": "SKBUP2-4CPIG9"
        }
      ]
    }
  ]
}
}

影音內容

範本標題元件可以顯示影音素材資產。如果您想建立包含影音素材標題的範本，則必須使用可恢復的上載 API 來獲取資產標識符，並在範本建立要求中加入該資產標識符。資產範例將作為範本審查的一部分接受審查。

範本審查

在範本建立流程完成之時或範本經過編輯之後，系統會進行自動審查。如果您的範本獲批准，其狀態會設定為 APPROVED，接著您便可以開始透過範本訊息傳送範本。如果您的範本被拒絕，或其狀態變更為其他值，便無法在範本訊息中傳送。

請參閱「範本審查」，進一步了解審查流程、常見的拒絕原因，以及範本被拒時的處理方法。

範本狀態

範本必須為 APPROVED 的狀態，才能透過範本訊息傳送。範本狀態最初由範本審查流程所設定，但其值或會根據使用情況和品質意見而有所變更。

範本狀態的變更是經由 message_template_status_update Webhooks 傳達，但您亦可隨時使用範本 API 並要求 status 欄位以取得範本狀態。

範例要求

curl 'https://graph.facebook.com/<API_VERSION>/<TEMPLATE_ID>?fields=status' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'

回應範例

{
"status": "APPROVED",
"id": "1259544702043867"
}

請參閱範本 API 參考資料，查看所有可能的狀態值及其含義之清單。

WhatsApp 管理工具

WhatsApp 管理工具中的「管理範本⁠」面板也會顯示範本狀態，其中已獲批（active）的範本會附加品質評分：

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

範本限制

通訊帳戶可以擁有的範本數量取決於該帳戶母公司的商家資產管理組合。

如果母公司的商家資產管理組合未經驗證，則旗下每個訊息帳戶最多可擁有 250 個訊息範本。不過，如果其資產管理組合已通過驗證⁠，而且最少有一個 WhatsApp 帳戶使用帶有獲批准顯示名稱的商家電話號碼，則旗下每個訊息帳戶最多可擁有 6,000 個範本。

此外，您可以傳送的範本有次數限制，並且會有影響範本送達的流程：

訊息數量上限：在顧客服務期間以外，您可以傳送訊息範本的次數限制。
範本調節：這個程序可讓 WhatsApp 用戶有時間就訊息範本提供意見。
範本暫停：這個程序可以暫時停用獲得負面意見的訊息範本。
範本封存：這個程序可自動封存和刪除閒置 12 個月或以上的範本。除非取消封存，否則已封存的範本將在 28 天後刪除。
每位用戶的營銷範本訊息數量上限：這個程序會限制特定 WhatsApp 用戶從任何商家所接收的營銷訊息範本數量。

存留時間

若傳送給 WhatsApp 用戶的訊息無法送達，系統會在存留時間（TTL）內持續嘗試送達。您可以在建立範本時自訂範本的存留時間。

請參閱「存留時間」以了解詳情。

品質評分

範本品質評分系統會根據使用情況、顧客意見以及互動情況，評估訊息範本的品質。此評分有助保持優質訊息生態系統，且確保您傳送的訊息與用戶相關及反應良好。

請參閱「範本品質評分」，以進一步了解品質評分、此評分如何影響範本狀態，以及系統如何通知您有關範本品質分數的變動。

多個訊息的送達順序

在傳送一系列訊息時，我們無法保證按您 API 要求的順序送達各訊息。如果您需要確保訊息送達的順序，請先確認狀態訊息 Webhook 已收到 delivered 狀態，再開始傳送訊息順序中的下一則訊息。

範本管理

請參閱「範本管理」，以查看通常用於獲取、更新及刪除範本的端點清單。