> ## 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 Flow
> 在客户消息中使用 Flow 之前，先进行创建和测试。
创建 WhatsApp Flow，测试其屏幕和数据处理，然后将其发布以用于客户消息中。
## 选择创建方法
您可以通过 [YCloud Flows API](/zh/api-reference/guides/whatsapp-platform/manage-whatsapp-flows) 管理 Flow。您还可以使用 WhatsApp 管理工具中为您的 WABA 提供的 Flow 构建工具。
API 支持与控制台编辑器可用性是分开的。请确认您账户中显示的选项，而不是默认每个 YCloud 界面都包含 Flow 构建器。
## 准备与测试
1. 选择将拥有该 Flow 的 WABA。
2. 定义屏幕、字段和完成结果。
3. 确定该 Flow 是否需要数据端点。
4. 创建草稿并解决验证错误。
5. 使用合成数据预览完整的客户旅程。
6. 仅在表单和下游处理准备就绪后才进行发布。
截图展示了现有的 WhatsApp 管理工具工作流程。请遵循您账户中的当前标签和资格提示。
## 在定义屏幕之前先定义数据
对于预约请求，编写一个简短的字段规范：
| 字段 | 示例值 | 验证与用途 |
| - | - | - |
| 服务 | 咨询 | 必须是您实际提供的服务之一。 |
| 地点 | 市中心 | 必须支持所选的服务。 |
| 首选日期 | 2026-10-12 | 必须是可用或可接受的未来日期。 |
| 首选时间 | 10:30 | 在客户体验中包含该地点的时区。 |
| 请求标识 | 不透明标识 | 将提交内容与客户的请求进行关联。 |
仅使用最少量的必要字段。首选时间并非已预订的时段；在预订系统确认可用性之前，请准确命名。
确定每个屏幕接收、返回的内容以及失败时显示的内容。对于动态 Flow，即使表单通常会限制这些值，端点也必须能够处理陈旧的可用性信息和无效的选择。
## 分阶段验证草稿
1. **结构：** 获取 Flow 并检查 `validationErrors`。修复指定的 JSON 位置，而不仅仅是第一个可见的错误。
2. **导航：** 测试每个前进、返回和完成路径。
3. **数据：** 测试必填字段为空、最大预期值以及不再有效的选择。
4. **端点：** 测试不可用数据、超时以及被拒绝的业务操作。
5. **完成：** 确认响应准确到达正确的客户上下文一次。
对于 API 方式，文档记录的顺序是创建、获取验证详情、更新结构、生成预览和发布。预览端点会生成一个公开的预览 URL，因此请使用合成数据，切勿包含机密信息。
## 规划版本化发布
在您的发布记录中同时保留 Flow 定义和任何端点更改。记录 Flow ID、所属 WABA、状态、预期的邀请模板和业务结果。
当前的 YCloud 约定中关于编辑已发布 Flow 的描述并不一致。在明确该行为之前，如果线上体验有变更，请使用经过测试的新 Flow 版本，而不是依赖直接回退为草稿。仅在测试替代版本后更新其邀请。
在检查有效邀请以及已经收到该 Flow 的客户的预期过渡方案之前，请勿弃用之前的 Flow。
## 发布之前
检查必填字段、导航、无效输入、重复提交和端点故障。公开预览切勿包含生产环境机密信息或敏感客户数据。
发布会更改资源的生命周期。在修改已上线的 Flow 之前，请检查当前约定；必要时规划替代版本。
如果在创建模板时找不到该 Flow，请确认两个资源均属于预期的 WABA，且该 Flow 可供使用。
继续阅读 [发送 Flow](/zh/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-flows/send-a-whatsapp-flow)。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.