---
title: "WhatsApp Flows JSON 模板与预览工具"
description: "免费的 WhatsApp Flows JSON 示例，含英语、阿拉伯语等六种语言：线索表单、预订、问卷与授权。可预览界面、校验 JSON 并一键复制。"
canonical: "https://omnichannels.ai/zh/tools/whatsapp-flows-templates/"
language: "zh"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# WhatsApp Flows JSON 模板与预览工具

Canonical: https://omnichannels.ai/zh/tools/whatsapp-flows-templates/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

WhatsApp Flow 是用 Flow JSON 定义的一组聊天内界面。最简单的有效 Flow 包含版本（如 7.3）和 screens 数组。每个界面都有由字母和下划线组成的 id、带组件的 SingleColumnLayout 以及一个 Footer 按钮。界面之间通过 navigate 动作前进，最后一个界面标记为 terminal 并执行 complete，把答案发送到您的 webhook。

## 如何使用 WhatsApp Flow 模板
1. **选择模板:** 选择线索收集、餐桌预订或客服工单等使用场景，再切换各语言版本。
2. **预览界面:** 点击手机预览中的按钮，按客户看到的先后顺序逐个浏览界面。
3. **复制或下载 JSON:** 将 Flow JSON 粘贴到 WhatsApp Manager 的 Flow 编辑器中，或通过 Flows API 上传，然后发布。
4. **校验您的修改:** 把修改后的 JSON 粘贴到校验工具中，检查失效的跳转、缺失的字段以及超出 Meta 字符上限的标签。

## WhatsApp Flow JSON 文件里有什么

Flow JSON 有两个必填属性：version 和 screens。每个界面包含 id、可选的顶部栏标题，以及类型为 SingleColumnLayout 的布局，其子项为各类组件：文本、输入框、选择列表、日期选择器、授权复选框和一个 Footer 按钮。
导航由 actions 控制。带 navigate 的 Footer 会打开下一个界面；在标记为 terminal 的最后一个界面上，带 complete 的 Footer 会关闭 Flow，并把载荷连同 flow token 发送给您的企业。从 Flow JSON 4.0 起，任何界面都可以用 ${screen.SCREEN_ID.form.field} 读取前面界面的字段，所以这些模板让 navigate 的载荷保持为空，并在最后的 complete 载荷中统一收集所有答案。
- version：Flow JSON 版本，所有模板均为 "7.3"。
- screens：按顺序排列的界面列表；第一个没有入站跳转的界面即入口界面。
- routing_model 和 data_api_version：仅用于调用您数据接口的 Flow。
- terminal 和 success：标记最后一个界面，以及在该处结束是否算作成功。

## 带数据接口与不带数据接口的 Flow

这十二套模板都是无接口（endpoint-less）的。它们无需服务器即可运行：选项直接写在 JSON 中，由 Meta 生成路由模型，客户完成 Flow 后答案会发送到您的 webhook。只要不需要实时数据，Meta 就建议使用无接口 Flow，因为它们打开更快，构建也更快。
当界面依赖实时数据时再添加数据接口：可预约时段、会变化的价格、库存，或对客户账户的核对。这时界面使用 data_exchange，Flow 需要 data_api_version 和 routing_model，您的接口必须解密每个请求并在 Meta 的超时时间内响应。这部分正是我们为客户搭建并托管的内容。

## 需要遵守的字符上限与组件规则

多数被拒的 Flow 都栽在细小的规则上。标签很短：文本输入框、文本区域或下拉框为 20 个字符，单选或复选框组为 30，日期选择器为 40，Footer 按钮为 35。选项标题上限 30 个字符，说明上限 300。标题可用 80 个字符，正文 4,096。
每个界面最多可使用 50 个组件、1 个 Footer、2 个嵌入链接、3 张图片和 5 个授权复选框。界面 id 只能包含字母和下划线，SUCCESS 为保留字。阿拉伯语标签按字符而非字节计数，所以 20 个字符的阿拉伯语标签没有问题。校验工具会检查以上所有项，并指出需要修改的界面。

## 面向海湾客户的阿拉伯语与从右到左 Flow

每套模板都有原生阿拉伯语版本，界面和字段名相同，因此您的 webhook 代码无需改动即可处理两种语言。WhatsApp 会在客户手机上从右到左排版阿拉伯语 Flow，预览也呈现相同的方向。
模板库包含对海湾地区重要的使用场景：设有开斋饭后推送时间的斋月和开斋节优惠报名、餐厅订位、房产看房申请，以及要求客户不要在聊天中发送证件照片的 KYC 文件清单。

## 如何把 Flow 发送给客户

发布 Flow 后，将它作为交互式 flow 消息发送，需要包含其 Flow ID、您生成的 flow token、简短的按钮文字和首个界面。模板库为每套模板提供了消息载荷。交互式消息只能在 24 小时客户服务窗口内使用；若要主动触达客户，请把 Flow 附加到带 Flow 按钮的已审核消息模板上。
客户完成后，WhatsApp 会向其展示答案摘要，您则在 webhook 上收到完整载荷。请回复一条确认消息，说明接下来会发生什么，以及如何修改或取消。

## WhatsApp Flows JSON 常见问题

### 应该使用哪个 Flow JSON 版本？

使用 7.3，这是我们查看 Meta 更新日志时其推荐用于发布新 Flow 的版本。5.0 等旧版本已被冻结：基于它们的 Flow 仍可发送，但无法发布。

### 这些模板需要服务器或数据接口吗？

不需要。所有模板都是无接口的。选项写在 JSON 中，客户点击最后一个按钮后，答案会发送到您的 webhook。只有可预约时段、价格这类实时数据才需要接口。

### 如何在 WhatsApp Manager 中使用模板？

在 WhatsApp Manager 中创建 Flow，打开 JSON 编辑器，用模板内容替换原有内容，检查预览后发布。您也可以通过 Flows API 创建并发布 Flow。

### 可以编辑标签和选项吗？

可以。修改任何文本，增删选项和字段，然后把 JSON 粘贴到校验工具中。当标签超出字符上限，或某个跳转指向已不存在的界面时，它会提醒您。

### 我的 Flow 为什么发布失败？

常见原因包括：标签超出上限、界面 id 含数字或连字符、terminal 界面没有 Footer、在非 terminal 界面使用 complete 动作，以及使用了 data_exchange 却没有 data_api_version 和路由模型。

### 阿拉伯语模板是从右到左的吗？

是的。它们以阿拉伯语撰写，WhatsApp 会按从右到左的方向显示。字段名和选项 id 保持英文，所以同一套 webhook 代码可以处理两种语言。

### Flow 可以收集证件吗？

Flow 带有照片和文件选择组件，但敏感文件的上传需要谨慎处理。KYC 模板只确认客户持有哪些文件，并预约安全的提交方式，避免证件图片出现在聊天中。

### 这个校验工具和 Meta 的一样吗？

不一样。它依据 Meta 文档中记录的错误进行基础静态检查。WhatsApp Manager 中 Meta 的校验器还会检查表达式和数据模型，所以请在它不报错之后再发布。