摘要

想要使用 Wati API 將個性化的訂單訊息直接發送到客戶的 WhatsApp？本指南將引導您使用 POST /api/v1/order_details_template 端點 sendsend 結構化的訊息，包括訂單項目、價格和付款選項。您還會找到一個樣本 payload，以幫助您快速入門。

注意: 廣播現在稱為活動 – 同樣強大的功能，更新的名稱！

端點

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

The 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：構建您的 payload

以下是一個示例 payload，顯示如何格式化您的 order_details_template。您可以根據需要自訂字段，例如產品名稱、價格、進口商詳細信息和付款配置。

示例 payload

curl --location 'https://mt-dev-gke-server.watiapp.io/103128/api/v1/order_deta' \
  --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
        }
      }
    }
  }'