摘要

想要使用 Wati API 直接向客户的 WhatsApp 发送个性化订单消息吗？本指南将指导您如何使用 POST /api/v1/order_details_template 端点发送包含订单项、价格和支付选项的结构化消息。您还将找到一个样本负载来帮助您快速开始。

注意: 广播现在是活动 – 同样的强大功能，更新的名称！

端点

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

该 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 <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
        }
      }
    }
  }'