摘要

想要透過 Wati API 直接發送個人化的訂單訊息到客戶的 WhatsApp 嗎?本指南將引導您如何使用 POST /api/v1/order_details_template 端點來發送包含訂單項目、價格和付款選項的結構化訊息。您還可以在此找到範例負載 (payload),協助您快速入門。

操作說明

端點

POST https://{your-account-endpoint}/api/v1/order_details_template

order_details_template 端點允許您將訂單詳細資訊範本訊息發送至客戶的 WhatsApp。您可以在訊息中包含一個或多個項目、指定價格,並將其連結至 PayU、Razorpay 等支付網關。

注意:此 API 端點目前處於私人測試階段 (Private Beta),僅開放給特定客戶使用。如果您需要存取權限,請聯絡 Wati 支援團隊。

Wati 也提供用於 WhatsApp Pay 訂單操作的非範本 API 端點,包括 order_status 和 order_details。這些端點與基於範本的 API 分開提供。如需這些端點的更多資訊,請參閱 Wati 開發人員文件。

步驟 1:找到您的 API 端點

您可以在您的 Wati 帳號中找到專屬的 API 端點。請前往 Connectors (連接器) > API Tokens (API 權杖)。它看起來會像這樣:https://live-mt-server.wati.io

您用於發送訂單的最終端點將為:

POST https://{your-account-endpoint}/api/v1/order_details_template

步驟 2:了解 reference_id 的重要性

每則訂單訊息都必須包含一個唯一的 reference_id。此數值由您自行生成,並用於追蹤每一筆訂單。不得有兩筆訂單使用相同的 reference_id。

步驟 3:建構您的負載 (payload)

以下是一個範例負載,展示如何格式化您的 order_details_template。您可以根據需要自定義產品名稱、價格、進口商詳細資訊和付款配置等欄位。

範例負載

curl --request POST \
--url https://live-mt-server.wati.io/{tenantId}/api/v1/order_details_template
--header 'Authorization: Bearer <TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"phone_number": "918606328257",
"template_name": "order_details_template_yzn_1",
"language_code": "en_US",
"is_campaign": true,
"custom_params": [
{
"name": "name",
"value": "Madhavan"
},
{
"name": "discount",
"value": "60%"
}
],
"order_details": {
"reference_id": "yzn-test-6",
"type": "digital-goods",
"payment_configuration": "razorpay_test_payment_2",
"payment_type": "payment_gateway:razorpay",
"currency": "INR",
"total_amount": {
"offset": 100,
"value": 100
},
"order": {
"discount": {
"offset": 100,
"value": 100
},
"items": [
{
"name": "ORDER_ITEM_NAME",
"quantity": 1,
"retailer_id": "ORDER_ITEM_RETAILER_ID",
"country_of_origin": "ORIGIN_COUNTRY",
"importer_name": "IMPORTER_NAME",
"amount": {
"offset": 100,
"value": 100
},
"importer_address": {
"address_line1": "IMPORTER_ADDRESS",
"city": "CITY",
"country_code": "COUNTRY",
"postal_code": "ZIP_CODE"
}
}
],
"shipping": {
"offset": 100,
"value": 0
},
"status": "pending",
"subtotal": {
"offset": 100,
"value": 100
},
"tax": {
"offset": 100,
"value": 100
}
}
}
}'

注意事項

  • 貨幣與偏移量 (offsets):金額數值使用偏移系統(例如:value: 21000 且 offset: 100 = ₹210.00)。

  • 產品詳細資訊:您可以在單一訊息中發送多項產品。

  • 圖片標題:請提供有效的媒體網址,以便在訊息頂部顯示圖片。

  • 支付網關:Facebook 支援的支付網關,例如:Razorpay、Payu、Zaakpay 和 Billdesk。

如何將您的支付帳號連結至 Facebook

若要在 WhatsApp 上收款,您需要透過付款配置將您的支付網關連結至您的 WhatsApp Business 帳號。

以下是快速的操作流程展示:

如何在 Wati 中建立訂單詳細資訊範本

想要快速且清晰地向客戶發送訂單資訊嗎?使用 Wati 中的訂單詳細資訊 (Order Details) 範本來設計並發送結構化訊息。本指南將引導您透過幾個簡單步驟來完成建立。

請按照以下步驟在 Wati 中設定訂單詳細資訊範本:

1. 登入您的 Wati 帳號。

2. 前往 Campaigns (行銷活動) 並選擇 Template Messages (範本訊息)。

3. 點擊 New Template Message (新增範本訊息)。

4. 輸入您的範本名稱,以便日後輕鬆找到它。

5. 在 Category (類別) 下,選擇 Marketing (行銷) 或 Utility (實用工具)。

6. 選擇您要使用的範本語言。

7. 在 Select Marketing Template (選擇行銷範本) 下,選擇 Order Details (訂單詳細資訊)。

8. 選擇您希望訊息如何開始:

  • 若要將文字或圖片作為標題,請在 Campaign title (行銷活動標題) 下選擇 Text (文字) 或 Image (圖片)。

  • 如果您想跳過標題直接從內容開始,請在 Campaign title (行銷活動標題) 下選擇 None (無)。

9. 輸入您的內容主體 (body content)——這是客戶將看到的訊息主要部分。

10. 確認一切無誤後,點擊 Save and Submit (儲存並提交)。

就是這樣!您的「訂單詳細資訊」範本現在已準備好在您的行銷活動中使用。

注意:您可以在「行銷」或「實用工具」範本類別下建立「訂單詳細資訊」範本。

Did this answer your question?