> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 目录与商务

> 在 WhatsApp 中分享目录商品并处理客户订单请求。

使用关联的目录在 WhatsApp 中展示商品并允许客户选择商品。通过您的订单和支付系统处理他们的订单请求。

## 选择消息格式

YCloud 的消息接口协议包含交互式单商品、多商品和目录消息类型。这些属于服务消息格式，需要处于适用的发送窗口期内。

基于模板的目录和多商品格式提供了另一种接入途径。它们需要已获批准的模板以及相关的目录配置。

参考：

* 查看 [服务消息](/zh/documentation/whatsapp-business-platform/messaging/service-messages) 了解自由格式消息的发送资格。
* 查看 [模板组件与格式](/zh/documentation/whatsapp-business-platform/messaging/message-templates/template-components-and-formats) 了解可选的模板类型。
* 查看 [目录模板](/zh/documentation/whatsapp-business-platform/messaging/message-templates/catalog-templates) 和 [多商品模板](/zh/documentation/whatsapp-business-platform/messaging/message-templates/multi-product-templates) 了解格式详情。

API 协议支持并不意味着每种格式都会出现在所有控制台编辑器中。

<Frame caption="Meta example of a multi-product message opening a categorized item list. It illustrates product selection, not a completed payment. Client styling and sample prices are illustrative.">
  <img src="https://mintcdn.com/lchnan/3gBf_HfRdWRqXdyx/images/whatsapp-platform/meta-catalog-product-selection.png?fit=max&auto=format&n=3gBf_HfRdWRqXdyx&q=85&s=7003f875c2deaca9ba773f5a0912c012" alt="带有“查看商品”按钮的 WhatsApp 多商品消息，打开后显示按类别分组的商品列表。" className="bg-white" width="1334" height="698" data-path="images/whatsapp-platform/meta-catalog-product-selection.png" />
</Frame>

来源：[Meta 官方示例](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/sell-products-and-services/share-products/)。

## 准备目录与业务流程

在发送商品消息之前：

* 确认目标目录已关联到正确的业务资产。
* 保持商品标识符稳定，并将其与您自己的商品记录相匹配。
* 保持准确的价格、库存状态、图片和描述。
* 检查商品及商务政策合规性。
* 明确由谁负责处理订单咨询、取消和退款。
* 根据当前库存和价格验证提交的商品。

在未经验证的情况下，切勿将客户提供的订单详情视为权威的支付或履约指令。

## 发送前匹配商品标识符

使用所关联 Meta 目录中的商品零售商标识符（Retailer ID）——而非显示名称、商品详情页 URL 或无关的内部数据库 ID。

例如，您的店铺可能使用内部商品 ID `8421`，而目录使用的是零售商 ID `SKU-BAG-BLUE`。请维护明确的映射关系。引用 `8421` 的商品消息将无法找到 `SKU-BAG-BLUE`，除非该 ID 与目录中的标识符完全一致。

同时检查目录 ID、商品零售商 ID 和发送方的目录关联。相同的商品名称可能存在于多个目录中，但这并不意味着这些记录可以互换。

## 验证客户订单请求

当客户提交所选商品时：

1. 识别客户身份及来源目录。
2. 将每个商品标识符解析为当前可售商品。
3. 复核数量、库存、价格、币种、配送地点、税费和运费。
4. 通过您支持的结账流程展示最终应付总额和适用条款。
5. 根据支付系统的返回结果确认付款。
6. 仅在达到相应的业务状态时才创建或释放履约订单。

如果展示的价格在结账前发生变化，请说明变动并获取客户确认。切勿在未通知的情况下扣除不同金额。

## 排查商品缺失问题

| 症状 | 检查项 |
| - | - |
| 目录按钮缺失或目录无法打开 | 正确的发送方、目录关联、商务设置以及支持的消息/客户端。 |
| 某件商品缺失 | 准确的零售商 ID、商品可售状态、政策审核和目录同步状态。 |
| 商品图片或价格已过期 | 当前源目录记录及其更新状态。 |
| 收到购物车但未生成已支付订单 | 订单处理与支付集成；购物车提交不等于支付事件。 |

在开展营销活动之前，请使用小型测试目录和模拟客户数据验证完整流程。已获批准的消息模板并不意味着之后添加到目录中的所有商品都自动获得批准。

## YCloud Shop 与 WhatsApp Pay 为独立产品

[YCloud Shop](/zh/documentation/shop/overview) 拥有独立的店铺、商品、运送、支付和订单管理配置。请勿假定 Shop 商品会自动同步为 WhatsApp 目录商品。

[WhatsApp Pay](/zh/documentation/whatsapp-pay/overview) 提供应用内支付支持体验。当前 YCloud 指南将此功能限定于印度境内使用受支持支付服务商的企业和用户。

Meta 的其他支付功能或市场并不自动代表 YCloud 已提供支持。在设计聊天内结账流程之前，请确认所在市场及支付服务商。

## 对整个交易方案全面落实政策要求

请将商品、消息、目录和支付体验结合起来进行统一审核。拥有发送商业消息的权限，并不代表自动获准通过商务功能销售同款商品。

有关政策审核指引，请参阅 [商业与商务政策](/zh/documentation/whatsapp-business-platform/consent-policies-and-account-health/business-and-commerce-policies)。您的企业仍需对自身的销售条款、客户支持及交易处理全权负责。

## 在 YCloud 中继续

* [设置 YCloud Shop](/zh/documentation/shop/overview)
* [了解 WhatsApp Pay](/zh/documentation/whatsapp-pay/overview)
* [通过 API 发送 WhatsApp 消息](/zh/api-reference/guides/whatsapp-platform/send-whatsapp-message)
* [跟踪消息送达情况](/zh/documentation/whatsapp-business-platform/messaging/message-delivery-statuses)

## 常见问题

<AccordionGroup>
  <Accordion title="商品已在我的店铺中存在，为什么 WhatsApp 提示找不到？">
    请检查已关联的 Meta 目录以及其中使用的确切零售商/内容 ID（retailer/content ID）。你店铺的内部 ID 或商品 URL 可能会有所不同。重试之前，请确认发送者使用了该目录，且商品处于有货并已获批状态。
  </Accordion>

  <Accordion title="客户发送了购物车，已支付的订单在哪里？">
    购物车仅用于传达已选商品，并不是付款结果。你的订单流程必须验证商品、计算总额、获取所需的任何确认，并使用受支持的结账方式。请根据支付/订单系统的实际状态进行履约发货。
  </Accordion>

  <Accordion title="设置 YCloud Shop 会自动启用 WhatsApp 目录消息或聊天内支付吗？">
    不能这样假设。Shop、已关联的 Meta 目录以及 WhatsApp Pay 都有各自独立的设置和可用性。请确认目录连接以及受支持的消息格式；对于聊天内支付，请在 YCloud 指南中确认市场和支付服务提供商的资质要求。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.