傳送訊息範本

您可以使用 /messages 端點向顧客傳送訊息範本。訊息範本可以是文字訊息、媒體訊息或互動式訊息。

如需詳細了解訊息範本，請參閱訊息，企業發起的訊息。

準備工作

請確保您已經完成「訊息」文件中「必要條件」部分所列出的動作。

步驟 1：使用 WhatsApp 管理工具建立範本

您可以在 WhatsApp 管理工具中建立訊息範本，而 WhatsApp 管理工具位於 Facebook 企業管理平台的 WhatsApp 帳戶中。我們會審查您的訊息範本，以確保其沒有違反 WhatsApp 的政策。獲得批准後，您的企業將會擁有自己的命名空間，而訊息範本將會儲存在此命名空間內。

建立訊息範本時，您必須齊備下列資料：

1. 訊息範本名稱：只能包含小楷字母數字字元和底線 ( _ )。不得使用其他字元或空格。
2. 訊息範本的元件：按要求使用文字和／或媒體元件填寫範本，包含參數預留位置。確保當中不包含換行符號、定位字元或超過 4 個連續空格，並符合企業管理平台或 WhatsApp Business Management API 中標明的長度限制。
3. 您的企業需要的所有其他翻譯。

建立訊息範本時，您可以透過點擊新增範例按鈕來新增範本範例。這樣有助我們在審查和批准流程中了解您計劃傳送的訊息類型。請確保提供的內容為範例，切勿包含任何機密或個人資料。

請參閱為 WhatsApp Business API 帳戶建立訊息範本，以了解有關建立訊息範本的詳細步驟。

範例

建立歡迎訊息，訊息範本名稱為 welcome，訊息內容為

  "Welcome {{1}}. We look forward to serving you on WhatsApp." 

建立訂單確認訊息，訊息範本名稱為 order_confirmation，訊息內容為

  "Your order {{1}} for a total of {{2}} is confirmed. The expected delivery is {{3}}." 

翻譯

WhatsApp 不會為您的企業提供任何翻譯。您需要自行輸入訊息範本的所有翻譯，並且翻譯格式需與此處所述格式相同。所有翻譯的元素名稱都相同。如需更多資訊，請參閱：

• 翻譯
• 支援語言

步驟 2：向 /messages 傳送 POST 要求

建立範本後，您便可透過 template 物件將其傳送給顧客：

POST /v1/messages
{
  "to": "recipient_wa_id",
  "type": "template",
  "template": {
        "namespace": "your-namespace",
        "name": "your-template-name",
        "language": {
            "code": "your-language-and-locale-code",
            "policy": "deterministic"
        },
        "components": [{
            "type": "body",
            "parameters": [
                {
                    "type": "text",
                    "text": "your-text-string"
                },
                {
                    "type": "currency",
                    "currency": {
                        "fallback_value": "$100.99",
                        "code": "USD",
                        "amount_1000": 100990
                    }
                },
                {
                    "type": "date_time",
                    "date_time" : {
                        "fallback_value": "February 25, 1977",
                        "day_of_week": 5,
                        "day_of_month": 25,
                        "year": 1977,
                        "month": 2,
                        "hour": 15,
                        "minute": 33
                    }
                },
                {
                "type": "date_time",
                    "date_time" : {
                    "fallback_value": "February 25, 1977",
                    "timestamp": 1485470276
                    }
                }
            ]
        }]
    }
}

參數

• 通用於所有訊息要求的參數。
• 訊息範本參數：template 物件、components 物件、parameters 物件和 language 物件。
• 語言：語言政策選項、language 物件、可本地化參數。

步驟 3：檢查 API 回應

成功回應包含帶有 id 的 messages 物件。

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

不成功的回應會包含錯誤物件，當中含有錯誤字串、錯誤代碼和其他資訊。如需更多資訊，請參閱錯誤和狀態代碼。

每位用戶的營銷範本訊息限制

我們正在推出新措施，旨在建立高質素的用戶體驗並發揮營銷範本訊息互動的最大效益，其中先由印度消費者開始，當中可能包括限制用戶在特定時間內從任何企業接收到的營銷範本訊息數量，首先針對一小部分較不可能看到的對話。請注意，相關限制是根據用戶已從任何企業接收到的營銷範本訊息數量而定，與您的企業並無特定關係。

此限制僅適用於在一般情況下會開啟新營銷對話的營銷範本訊息。如果您和 WhatsApp 用戶之間有已開啟的營銷對話，向用戶傳送的營銷範本訊息將不會受到影響。

如果營銷範本訊息因為相關限制而未能送達至特定用戶，內部部署 API 會傳回錯誤代碼 1026。請注意，雖然這個錯誤代碼涵蓋許多可能會導致訊息未能送達的問題，但出於私隱原因，我們不會披露訊息實際上是否因相關限制而未能送達。請參閱「為什麼我的送達率不是 100%？」參閱常見問題以了解詳情。

如果您確實收到以上其中一個錯誤代碼，並懷疑錯誤是由相關限制所致，請避免即時再次傳送範本訊息，因為這樣做只會導致傳回另一個錯誤回應。限制可能會在不同時段生效，因此您可拉長重試時間的間隔，直至訊息送達為止。

我們會繼續完善措施，同時亦感謝您與我們合作，致力為您的企業和顧客打造最佳的 WhatsApp 體驗。