跳转到正文
OmniChannels.ai

免费工具

WhatsApp Flows JSON 模板与预览工具

十二套可直接复制的 WhatsApp Flow 模板,涵盖英语、阿拉伯语、法语、西班牙语、德语和葡萄牙语,从线索收集、预约预订,到 NPS 问卷、KYC 清单和斋月优惠报名。可在手机框中预览每个界面,复制或下载 Flow JSON,并按 Meta 文档规则校验您自己的 JSON。

免费 · 无需注册 · 在浏览器中运行

显示以下类别的模板

线索收集

模板语言

Flow JSON(版本 7.3)

{
  "version": "7.3",
  "screens": [
    {
      "id": "CONTACT",
      "title": "Your details",
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "TextHeading",
            "text": "Tell us about you"
          },
          {
            "type": "TextBody",
            "text": "It takes less than a minute. We only use these details to reply to your request."
          },
          {
            "type": "TextInput",
            "name": "full_name",
            "label": "Full name",
            "input-type": "text",
            "required": true
          },
          {
            "type": "TextInput",
            "name": "company",
            "label": "Company",
            "input-type": "text",
            "required": false
          },
          {
            "type": "TextInput",
            "name": "email",
            "label": "Email",
            "input-type": "email",
            "required": true
          },
          {
            "type": "TextInput",
            "name": "phone",
            "label": "Mobile number",
            "input-type": "phone",
            "required": true,
            "helper-text": "Include the country code, for example +971"
          },
          {
            "type": "Footer",
            "label": "Continue",
            "on-click-action": {
              "name": "navigate",
              "next": {
                "type": "screen",
                "name": "NEEDS"
              },
              "payload": {}
            }
          }
        ]
      }
    },
    {
      "id": "NEEDS",
      "title": "Your request",
      "terminal": true,
      "success": true,
      "layout": {
        "type": "SingleColumnLayout",
        "children": [
          {
            "type": "RadioButtonsGroup",
            "name": "interest",
            "label": "What are you interested in?",
            "required": true,
            "data-source": [
              {
                "id": "demo",
                "title": "A product demo"
              },
              {
                "id": "pricing",
                "title": "Pricing"
              },
              {
                "id": "partnership",
                "title": "Partnership"
              },
              {
                "id": "other",
                "title": "Something else"
              }
            ]
          },
          {
            "type": "Dropdown",
            "name": "timeline",
            "label": "When do you start?",
            "required": true,
            "data-source": [
              {
                "id": "now",
                "title": "Right away"
              },
              {
                "id": "one_three",
                "title": "In 1 to 3 months"
              },
              {
                "id": "later",
                "title": "Later this year"
              },
              {
                "id": "exploring",
                "title": "Just exploring"
              }
            ]
          },
          {
            "type": "RadioButtonsGroup",
            "name": "call_time",
            "label": "Best time to call",
            "required": false,
            "data-source": [
              {
                "id": "morning",
                "title": "Morning"
              },
              {
                "id": "afternoon",
                "title": "Afternoon"
              },
              {
                "id": "evening",
                "title": "Evening"
              }
            ]
          },
          {
            "type": "TextArea",
            "name": "message",
            "label": "Message",
            "required": false,
            "helper-text": "Anything we should know before we call"
          },
          {
            "type": "OptIn",
            "name": "marketing_opt_in",
            "label": "Send me product news and offers on WhatsApp. I can reply STOP at any time.",
            "required": false
          },
          {
            "type": "Footer",
            "label": "Send request",
            "on-click-action": {
              "name": "complete",
              "payload": {
                "full_name": "${screen.CONTACT.form.full_name}",
                "company": "${screen.CONTACT.form.company}",
                "email": "${screen.CONTACT.form.email}",
                "phone": "${screen.CONTACT.form.phone}",
                "interest": "${form.interest}",
                "timeline": "${form.timeline}",
                "call_time": "${form.call_time}",
                "message": "${form.message}",
                "marketing_opt_in": "${form.marketing_opt_in}"
              }
            }
          }
        ]
      }
    }
  ]
}

请粘贴到 WhatsApp Manager 的 Flow 编辑器中,或通过 Flows API 上传。请把示例隐私政策网址替换为您自己的。这些模板无需数据端点即可运行,因此不需要 data_api_version 和 routing_model。

打开 Flow 的消息(Cloud API)

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<CUSTOMER_PHONE_NUMBER>",
  "type": "interactive",
  "interactive": {
    "type": "flow",
    "header": {
      "type": "text",
      "text": "Talk to our team"
    },
    "body": {
      "text": "Share a few details and the right person will contact you within one business day."
    },
    "action": {
      "name": "flow",
      "parameters": {
        "flow_message_version": "3",
        "flow_token": "<UNIQUE_FLOW_TOKEN>",
        "flow_id": "<FLOW_ID>",
        "flow_cta": "Get in touch",
        "flow_action": "navigate",
        "flow_action_payload": {
          "screen": "CONTACT"
        }
      }
    }
  }
}

交互式消息只能在 24 小时客户服务窗口内发送。如需由您主动发起对话,请将 Flow 附加到带有 Flow 按钮的已审核消息模板上。

这些模板遵循的 WhatsApp Flows 规则

  • Flow JSON 7.3 是 Meta 推荐用于发布新 Flow 的版本。
  • 不带数据端点的 Flow 只需 version 和 screens;路由模型由 Meta 生成。
  • 每个 Flow 都以带有 Footer 的结束界面收尾,由 Footer 执行 complete 操作。
  • 每个界面的上限:50 个组件、1 个 Footer、2 个内嵌链接、3 张图片和 5 个授权项。
  • 标签要简短:文本输入框和下拉菜单 20 个字符,单选和复选框组 30 个字符,Footer 按钮 35 个字符。
  • 界面 id 只使用字母和下划线,SUCCESS 为保留字。

规则已于 2026-10-10 对照 Meta 的 WhatsApp Flows 文档核对。

我们为您构建并托管带数据端点的 Flow

需要在 Flow 中展示实时时段、价格或账户数据?我们的团队负责设计界面,构建并托管加密的数据端点,并把答复接入您的 CRM。请联系销售获取按范围报价。

您在此输入的任何内容都不会发送到我们的服务器。

简短回答

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

如何使用 WhatsApp Flow 模板

  1. 1

    选择模板

    选择线索收集、餐桌预订或客服工单等使用场景,再切换各语言版本。

  2. 2

    预览界面

    点击手机预览中的按钮,按客户看到的先后顺序逐个浏览界面。

  3. 3

    复制或下载 JSON

    将 Flow JSON 粘贴到 WhatsApp Manager 的 Flow 编辑器中,或通过 Flows API 上传,然后发布。

  4. 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 的校验器还会检查表达式和数据模型,所以请在它不报错之后再发布。

更多免费工具