创建 WhatsApp Flow

创建 WhatsApp Flow，测试其屏幕和数据处理，然后将其发布以用于客户消息中。

​

选择创建方法

您可以通过 YCloud Flows API 管理 Flow。您还可以使用 WhatsApp 管理工具中为您的 WABA 提供的 Flow 构建工具。 API 支持与控制台编辑器可用性是分开的。请确认您账户中显示的选项，而不是默认每个 YCloud 界面都包含 Flow 构建器。

​

准备与测试

1. 选择将拥有该 Flow 的 WABA。
2. 定义屏幕、字段和完成结果。
3. 确定该 Flow 是否需要数据端点。
4. 创建草稿并解决验证错误。
5. 使用合成数据预览完整的客户旅程。
6. 仅在表单和下游处理准备就绪后才进行发布。

截图展示了现有的 WhatsApp 管理工具工作流程。请遵循您账户中的当前标签和资格提示。

​

在定义屏幕之前先定义数据

对于预约请求，编写一个简短的字段规范： 仅使用最少量的必要字段。首选时间并非已预订的时段；在预订系统确认可用性之前，请准确命名。 确定每个屏幕接收、返回的内容以及失败时显示的内容。对于动态 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。