如何在扣子中配置Webhook接收在线表单提交的实时数据通知

说一个我最近被问得最多的场景：怎么让扣子Bot实时接收在线表单的提交数据？无论是Typeform、JotForm，还是自建HTML表单，本质需求都一样——每次用户一提交，Bot那头立刻能收到通知，而不是手动导出、定时拉取。这里只有一条路：用Webhook，让表单主动推给扣子。下面把整套流程拆开说清楚。

先确认表单平台是否支持Webhook

打开你的表单后台，比如Typeform在「Logic」→「Webhooks」里找，JotForm则在「Settings」→「Integrations」→「Webhook」里。关键看有没有一个叫“Send submission data to URL”的选项。如果没有，这条路就走不通——比如早期版本的Google Forms，它不支持Webhook，那就得绕道用Zapier做中间桥接。

这一步不能跳过，因为扣子本身并不会主动监听外部HTTP请求，它只响应你配置好的那个Webhook入口地址。

在扣子中创建Webhook插件

进入Bot编辑页，左侧菜单点「Plugins」，右上角「+ Add Plugin」，选「Webhook」，填个插件名称（比如“表单通知”），然后点击「Create」。创建完成之后，会立即生成一串以https://webhook.coze.com/...开头的URL——这是扣子专门为你生成的接收地址，每次创建新插件都会不同。

把表单提交目标指向扣子Webhook地址

这一步有两种做法：

方法一：直接粘贴。适合Typeform、JotForm这类可视化配置平台。复制上一步拿到的完整Webhook URL，粘贴到表单平台的「Webhook URL」输入框，保存，完成。

方法二：手动构造POST请求。适合自建表单或需要定制字段的场景。在表单提交的Ja vaScript里调用fetch，目标URL填扣子Webhook地址，method必须为POST，headers里得带上{"Content-Type": "application/json"}，否则扣子会拒收。

有个省心的地方：表单字段名不需要跟扣子变量名保持一致，后面可以在Bot工作流里任意映射——只要JSON结构合法，扣子就能解析出原始数据。

配置Bot工作流处理Webhook数据

第一步：在Bot「Workflow」里新增一个节点，选「Webhook」触发器，从下拉菜单中选中刚刚创建的Webhook插件。

第二步：拖入一个「Text」或「Code」节点，用来处理接收到的event.body——这是表单提交的原始JSON字符串，比如{"name":"张三","email":"zhang@xxx.com","score":95}。

第三步：添加「Send Message」节点，在消息内容里用{{event.body.name}}引用字段——支持点号路径访问嵌套值，比如{{event.body.address.city}}。配置好之后，连接到聊天窗口或飞书/企微群机器人即可。

实际操作很简单，直接把{{event.body.xxx}}写进消息模板就行。但有一个坑要留意：如果字段名里包含空格或特殊符号，比如"user email"，必须改用方括号语法：{{event.body["user email"]}}，否则解析会失败。