支持聊天机器人 webhook，把对话记到 Google 表格

支持聊天机器人 webhook，把对话记到 Google 表格

一个通过 webhook 回答顾客问题的 n8n 工作流。你的网站或应用把问题作为 POST 请求发来。OpenAI 模型根据你填进一个节点里的公司信息作答，回复是 JSON，带一个置信度和一个类别。每个问题和回答还会加进一张 Google 表格。它没有向量数据库，消息之间也没有记忆。

包里有什么

• workflow.json：n8n 导出的工作流，七个节点，其中六个运行，一个是便签。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• AI: Generate Response 原来是一个 n8n-nodes-base.openAi 节点，1.8 版。在 n8n 当前的源码里（2026 年 11 月 12 日查阅），这个类型只有 1 和 1.1 两个版本，用于旧式的文本补全调用。接收聊天消息的节点是 @n8n/n8n-nodes-langchain.openAi。副本用的是它的 1.8 版，设置相同：模型 gpt-4o-mini、两条消息、温度 0.3 和 500 个 token。Output Content as JSON 取代了旧的 responseFormat 设置。
• 这个节点返回的是已经解析好的 JSON，而旧节点给的是文字。Merge Response 原来按文字读取，所以副本两种形式都接受。
• Validate Input 用 Node 的 crypto 模块生成 ID，而 Code 节点在实例不允许时会拒绝这个模块。副本用一个简短的函数生成两个 ID，不需要任何模块。
• 系统消息原来从环境变量读取公司名和公司信息，Log to Sheets 又从第三个变量读取表格 ID。环境变量只有在你自己运行 n8n 时才能设置，所以副本改从节点里取这些值。占位符是 <YOUR_COMPANY_NAME>、<YOUR_COMPANY_INFO> 和 YOUR_SHEET_ID。规则 3 里的客服地址是 <YOUR_SUPPORT_EMAIL>。
• webhook 路径现在是 support-chatbot。
• 便签已按这些改动更新。凭据关联和 webhook ID 都已删除。
• 别的都没改。系统消息里的规则和表格的列照原文件。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行。
• 一个 OpenAI API 密钥。
• 一个用于 Google Sheets 凭据的 Google 账号，以及一张有名为 Lite Conversations 的标签页的表格。它的第一行需要这些表头：Message ID、Session ID、Customer、Question、Answer、Confidence、Category、Received 和 Responded。
• 一个能向 webhook 发 POST 请求的页面、脚本或工具。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 在 Log to Sheets 里，把 YOUR_SHEET_ID 换成表格地址里的 ID，也就是 /d/ 和 /edit 之间的那一段。选中一个 Google Sheets 凭据。
3. 添加一个 OpenAI 凭据，在 AI: Generate Response 里选中它。
4. 在同一个节点里编辑第一条消息。把 <YOUR_COMPANY_NAME> 换成你的名称，<YOUR_COMPANY_INFO> 换成机器人该知道的内容，<YOUR_SUPPORT_EMAIL> 换成它转交时给出的地址。尖括号要去掉。
5. 点 Test workflow，向 Receive Message 里显示的测试地址发一个请求：

   curl -X POST "<YOUR_N8N_URL>/webhook-test/support-chatbot" -H "Content-Type: application/json" -d '{"message":"What are your opening hours?","session_id":"demo-1","customer_name":"Sam"}'

1. 查看回复，再到表格里看有没有新的一行。
2. 点 Publish，调用正式地址，它是把 /webhook-test/ 换成 /webhook/。

一次运行的过程

1. Receive Message 接收路径 support-chatbot 上的 POST 请求。它之后才通过 Respond to Customer 作答。
2. Validate Input 从请求体里读取 message 或 text。它取 session_id，缺少时会自己生成一个，还取 customer_name，缺少时用 Customer。短于 2 个字符的消息会让这次运行报错停止。
3. AI: Generate Response 把系统消息和 Customer <name> asks: 加上问题发给 gpt-4o-mini。系统消息要求回答友好、简短、不超过 150 个词，并且只依据你的公司信息。模型必须回复 JSON，包含 answer、confidence 和 category，类别是 faq、billing、technical、complaint 或 other 之一。
4. Merge Response 把这个回复和请求的字段合在一起。如果回复读不出来，它就回答 Sorry, I had trouble processing that. Please try again.，并把 confidence 设为 0。
5. Log to Sheets 往 Lite Conversations 追加一行，Respond to Customer 把这些 JSON 字段返回给调用方：success、messageId、answer、confidence 和 category。两条分支同时从 Merge Response 出发。

想改的地方

• 公司信息、语气和规则：AI: Generate Response 里的系统消息。
• 模型、长度上限和温度：同一个节点。
• 类别：系统消息里列出它们的那一行。
• 表格的标签页或列：Log to Sheets。
• 回答记到哪里：把 Log to Sheets 换成 Airtable、数据库或别的节点。

要知道的

• 这个 webhook 没有登录。谁知道了它的地址，谁就能用你的 OpenAI 密钥发问题，并往你的表格里加行。要保密这个地址，或者在 Receive Message 里加上 Header Auth。别的网站上的页面还需要设置这个节点的 allowed origins。
• 每条消息单独作答。session_id 只会写进表格，所以机器人不记得之前的问题。
• 每个请求都会带上你的公司信息。请保持简短，别把机密放进去。
• confidence 是模型写的一个数字，不是测出来的值。没测试过就别拿它做分流。
• 空消息或只有一个字符的消息，结果是报错，而不是 JSON 回复。请先在你这边检查长度。
• OpenAI 的弃用页面（2026 年 11 月 12 日查阅）把 gpt-4o-mini-2024-07-18 列为 2027 年 1 月 14 日关停，替代模型是 gpt-6-luna。在这之前请在 AI: Generate Response 里换一个模型。
• 数据去向：每个问题和你的公司信息发给 OpenAI，表格行发给 Google Sheets，回答回到调用方。
• 费用：OpenAI 对每条消息收费，和公司信息以及回答的大小成正比。