用您的 AI 建立 WhatsApp 範本,並修正遭拒的範本
透過 MCP 連接 WhatsApp Business 號碼的 AI,可以草擬範本,用 create_template 提交至 Meta,並以 get_template_status 追蹤審批進度。每個範本都需要一個類別(實用類、行銷類或驗證類)、以 {{1}} 等編號的變數,以及每個變數的範例值。Meta 的審批最長可能需時 24 小時。被拒的範本會先修正,然後以新名稱重新提交。
easyCoexistence 透過 Coexistence 將您的 WhatsApp Business 號碼連接至 Meta 官方的 Cloud API,並為您的 AI 提供範本工具:list_templates、create_template、get_template_status 及 send_template,另有自動化功能,可自行傳送已批准的範本。
Meta 所述範本審批決定的最長時限。
已刪除的已批准範本,其名稱不能供新範本使用的時長。
範本名稱的最多字元數;只可使用小寫英文字母、數字及底線。
未驗證的 Business Portfolio 下,每個 WhatsApp Business 帳戶可建立的範本數量;已驗證且具已批准顯示名稱的,最多可達 6,000 個。
自此日期起,提交為實用類但被 Meta 判定為推廣性質的範本,會改以行銷類獲批准。
已批准範本可作的編輯,每 24 小時內不得超過一次。
在您用平實文字描述訊息後,AI 如何建立 WhatsApp 範本?
只需數個工具呼叫。AI 先以 list_templates 檢查現有範本,避免重複已批准的範本。然後它會呼叫 create_template,提交一個以小寫字母、數字及底線組成的名稱、語言代碼(例如 en_US、pt_BR 或 es_ES)、類別,以及各個組件:可選的頁首、正文、可選的頁尾及按鈕。Meta 會審核提交內容,get_template_status 會按該名稱下的每種語言回報 APPROVED、PENDING 或 REJECTED。範本獲批准後,send_template 會將其傳送,自動化的「傳送範本」步驟亦可執行此操作。
AI 提交的範本請求是什麼樣的?
以下是 AI 在收到類似「請用英文建立一個行銷範本,向客戶以名字問候,並提供代碼 WELCOME10,首次訂購享 10% 折扣。」這樣的請求後所提交的內容。正文使用一個位置變數 {{1}},並附上範例值,讓審核者看到真實的訊息。變數之後必須有文字,因為 Meta 會拒絕以變數開頭或結尾的正文;頁尾則說明收件人如何停止接收推廣訊息。優惠碼放在正文中,自動化也可以傳送它。
{
"connection_id": "<from list_numbers>",
"name": "welcome_coupon",
"language": "en_US",
"category": "MARKETING",
"components": [
{
"type": "BODY",
"text": "Hi {{1}}, welcome to Bloom Café! Use code WELCOME10 for 10% off your first order.",
"example": { "body_text": [["Ana"]] }
},
{ "type": "FOOTER", "text": "Reply STOP to stop offers" }
]
}範本應使用哪個類別?
應選擇與訊息用途相符的類別,因為 Meta 會按類別核對內容。自 2025 年 4 月 9 日起,若實用類提交的內容具推廣性質,會改以行銷類獲批准。Meta 之後也可能更改已批准範本的類別,並透過 template_category_update webhook 通知,而您有 60 天時間可在 Business Support Home 提出申訴。行銷類範本在 WhatsApp Business 帳戶上須先設定付款方式才能傳送,Meta 會按各國家及各類別的獨立費率收費。
變數與範例如何運作?
位置變數由 1 開始按出現次序編號,即 {{1}}、{{2}},而 Meta 要求在建立範本時為每個變數提供範例值,例如 "example": {"body_text": [["Ana"]]}。傳送時,數值按相同次序填入。您的 AI 會透過 send_template 的 components 填入這些數值,該參數亦可帶入頁首媒體及按鈕值,例如複製代碼按鈕的代碼。
目前自動化的功能較為有限:「傳送範本」步驟按位置填入正文變數,例如 "params": ["{{first_name}}"],即會將客戶名字放入 {{1}}。含具名變數、頁首圖片或變數、或帶變數按鈕的範本,目前自動化無法傳送,因此自動化會傳送的優惠碼,應放在正文中,而非複製代碼按鈕。
為何 Meta 會拒絕範本?
Meta 的審核一部分由系統自動進行,一部分由人手進行,其說明文件列出常見的拒絕原因。大部分原因在提交前已可察覺,所以值得先請 AI 按此清單檢查草稿:
- 變數格式:大括號缺漏或不配對、變數內含 #、$ 或 % 等特殊字元、編號不按次序,或正文以變數開頭或結尾。
- 變數數量相對於其周圍文字長度過多。
- 違反政策:內容違反 WhatsApp Business 或 Commerce 政策、含辱罵或威脅性內容,或要求提供完整的敏感識別資料;部分識別資料則獲允許。
- 重複:正文及頁尾字句與現有範本相同,此項檢查不適用於驗證類範本。
- 類別不符,以
INCORRECT_CATEGORY原因遭拒,或文字超出組件的長度上限。
如何用 AI 修正被拒的範本?
從 Meta 提供的原因著手。該原因會顯示於 WhatsApp Manager、Meta 發給 Business Suite 管理員的電郵,以及範本狀態 webhook 中;get_template_status 則會直接顯示 REJECTED 狀態。將原因貼入對話,並要求 AI 按 Meta 的清單改寫範本:在結尾變數後加入文字、補上範例值、重新編號變數,或將推廣內容移出實用類範本。然後要求它以新名稱提交修正版本,例如 welcome_coupon_v2,因為同一語言下的同一名稱會被視為重複而遭拒(錯誤 100,子代碼 2388024)。
此連接器不會編輯或刪除範本。您也可以在 WhatsApp Manager 中編輯被拒的範本,並附上樣本重新提交,這同時可作為申訴。若您刪除已批准的範本,其名稱在 30 日內不能再次使用。
WhatsApp Business 應用程式能否在 Coexistence 號碼上傳送範本?
不能。透過 Coexistence 連接的號碼,團隊仍可在應用程式中聊天,但範本只存在於 API 端,因此須透過 send_template、自動化的「傳送範本」步驟或您自己的程式碼傳送。這也使範本成為聯絡最後一則訊息已超過 24 小時客戶的方式:此後 Meta 只接受預先批准的範本,手動輸入的回覆則只限於 24 小時的有效期內。範本訊息由 Meta 按類別及國家向您自己的 WhatsApp Business 帳戶收費,easyCoexistence 從不加價。
常見錯誤
- 提交範本後立即傳送。在 Meta 批准前,傳送會失敗並出現錯誤 132001,即該語言下範本不存在或未獲批准的錯誤。
- 正文以變數結尾,例如「您的驗證碼是 {{1}}」。Meta 會拒絕以變數開頭或結尾的正文,因此須在變數後加入結束句。
- 將優惠碼放入實用類範本。Meta 會將其批准為行銷類,或直接拒絕,無論如何都無法以實用類發送。
- 為自動化會傳送的優惠碼使用複製代碼按鈕。目前自動化尚無法填入按鈕變數,因此應將代碼放入正文。
應用程式留在您的手機上,每個號碼 24 小時全天候監察。每個已連接號碼每月 US$ 9 起,最低降至 US$ 0.75,號碼越多越便宜,首 3 天免費。
常見問題
一個帳戶可以有多少個範本?
Meta 允許未驗證的 Business Portfolio 下,每個 WhatsApp Business 帳戶最多 250 個範本;已驗證的 Business Portfolio 且具已批准顯示名稱者,最多可達 6,000 個。每個帳戶每小時的建立數量上限為 100 個範本。
可以編輯已批准的範本嗎?
可以,可在 WhatsApp Manager 或透過 Meta 的 API 編輯,30 日內最多 10 次,且 24 小時內最多一次。編輯可更改組件及存活時限(time-to-live),但不能更改已批准範本的類別,而且修改後須重新審核。連接器不會編輯範本,因此 AI 會改為提交新版本。
一個範本能否涵蓋多種語言?
不能。名稱與語言共同識別一個範本,因此每種譯文都是在同一名稱下的獨立提交,各自接受審核。請要求 AI 一次提交 en_US、pt_BR 及 es_ES 版本;以名稱刪除範本會移除其所有語言版本。
為何範本在獲批准後被暫停?
批准並非永久有效。若範本在收到負面回饋或互動率偏低後,質素評級跌至最低,Meta 會暫停該範本:第一次暫停 3 小時,第二次 6 小時,第三次則會被停用。list_templates 會回傳每個範本的質素評分,因此 AI 可在傳送開始失敗前提示評分下降。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期