跳至主要內容

如何使用訂單詳細資料模板 API 發送訂單訊息

昨日已更新

摘要

想要透過 Wati API 直接向客戶的 WhatsApp 發送個人化訂單訊息嗎?本指南將引導您使用 POST /api/v1/order_details_template 端點來發送結構化訊息,其中包括訂單項目、定價及付款選項。您也會找到樣本載入內容,幫助您快速開始。

端點

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

用於發送結構化訊息到客戶 WhatsApp。您可以在訊息中包含一個或多個商品項目、指定定價,並鏈接至到像 PayU、Razorpay 等支付網關。

步驟 1:查找您的 API 端點

您可在 Wati 帳戶中的 /api-docs 部分找到您的特定 API 端點。您的終端端點會是:https://live-server-xxxx.wati.io

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

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

步驟 2:瞭解 reference_id 的重要性

每筆訂單訊息都必須包含一個 唯一reference_id。由您生成此值,並在其中追蹤每筆訂單。兩筆訂單不能有相同的 reference_id

步驟 3:結構化您的載入內容

以下是指定如何格式化您的 order_details_template 的範例載入內容。您可依需求自訂適用於產品名稱、價格、進口商資訊及付款配置等欄位內容。

範例載入內容

curl --location 'https://mt-dev-gke-server.watiapp.io/103128/api/v1/order_deta
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqd
--header 'Content-Type: application/json' \ --data '{
"phone_number": "918606328257",
"template_name": "order_details_template_yzn_1",
"language_code": "en_US",
"is_broadcast": 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": [
{
"amount": {
"offset": 100,
"value": 100
},
"name": "ORDER_ITEM_NAME",
"quantity": 1,
"retailer_id": "ORDER_ITEM_RETAILER_ID",
"country_of_origin": "ORIGIN_COUNTRY",
"importer_name": "IMPORTER_NAME",
"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
}
}
}
}'

說明

  • 貨幣和偏移量:金額值採用偏移量系統(例如:value: 21000 和 offset: 100 = ₹210.00)。

  • 產品資訊:您可在一則訊息裡發送多種產品資訊。

  • 圖片標題:提供正確的媒體 URL,以便顯示訊息上方的圖片。

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

如何鏈接您的付款帳戶至 Facebook

要透過 WhatsApp 收款,您需要透過支付配置將支付網關與 WhatsApp 商家帳戶連接。

以下是快速視覺步驟:

如何在 Wati 中建立訂單詳情範本

想要快速且清楚地將訂單資訊傳達給客戶嗎?使用 Wati 中的訂單詳情範本可設計並發送結構化訊息。本指南將引導您完成設定程序,便於在短短數步駐完成。

以下為在 Wati 中設定「訂單詳情」范本步驟:

1. 登入您的 Wati 帳號。

2. 前往 廣播 區,選擇 您的範本

3. 點擊 新增範本訊息

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

5. 在 類別 中,選擇 行銷 或實用性

6. 選擇您想要範本的語言

7. 在 選擇行銷範本 中,選擇訂單詳情

8. 選擇您想要訊息的開頭方式:

  • 若想將文字圖片視為標題,請在廣播主標中選擇文字圖片

  • 若您偏好跳過標題而從正文開始,可在 廣播主標 中選擇

9. 輸入您的正文內容——這是客戶最終看到的主要訊息內容

10. 確認一切看起來都沒問題後,請點擊 儲存並送出

完成!您的訂單詳情範本已準備好用於您的活動行銷中。

注意:您可以在「行銷」以及「實用程式」範本類別下建立「訂單詳細資料」範本。

是否回答了您的問題?