跳转到主要内容

如何使用订单明细模板API发送订单消息

更新于昨天

摘要

想通过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等。

第一步:定位您的API端点

您可以在Wati账户中的/api-docs区域下找到您的特定API端点。它看起来像这样:https://live-server-xxxx.wati.io

发送订单的最终端点将是:

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

第二步:了解reference_id的重要性

每条订单消息必须包含一个唯一reference_id。您生成此值并使用它来跟踪每个订单。两个订单不能有相同的reference_id

第三步:结构化您的有效载荷

这里有一个示例有效载荷,展示了如何格式化您的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
}
}
}
}'

注意事项

  • 货币和偏移量:金额值使用偏移量系统(例如值:21000且偏移量: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. 一切看起来都没问题后,点击保存并提交

完成!您的订单详细信息模板现在已准备好用于您的活动中。

注意: 您可以在营销类别下创建订单详细信息模板,也可以在实用模板类别下创建。

这是否解答了您的问题?