摘要
想通过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. 一切看起来都没问题后,点击保存并提交。
完成!您的订单详细信息模板现在已准备好用于您的活动中。
注意: 您可以在营销类别下创建订单详细信息模板,也可以在实用模板类别下创建。