摘要

想要透過 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
}
}
}
}'