WooCommerce 店铺的 WhatsApp 客服智能体

WooCommerce 店铺的 WhatsApp 客服智能体

一个通过 Twilio 在 WhatsApp 上回复你店铺顾客的 n8n 工作流。一个 AI 智能体在 WooCommerce 里查库存、读订单，需要真人接手时在 Google Sheets 里登记一张客服工单，并记住每位顾客的对话。

包里有什么

• workflow.json：工作流，九个节点，没有便签。里面没有任何凭据。
• README.md：这份说明，压缩包里的是英文版。

和原来的副本相比的改动

• Message a model 调用的是一个存放在作者 OpenAI 账号里的 assistant。OpenAI 的弃用页面（2026 年 11 月 2 日查阅）写明 Assistants API 于 2026 年 8 月 26 日关闭，所以这个节点已经无法运行。那个 assistant 的指令也从来不在文件里。现在它是一个 AI Agent 节点，名称、消息、Simple Memory 和三个工具都不变。一个新的 OpenAI Chat Model 让它跑在 gpt-4.1-mini 上，系统消息是 Mindket 写的一段短文字，里面有 YOUR_SHOP_NAME。
• 作者的客服表格已经去掉。Create Tickets 需要填 YOUR_SHEET_ID，并按名称 Sheet1 找到标签页。
• 导出的工作流原本是开启状态，现在导入后是关闭的。

开始之前

• 一个 Twilio 能通过 HTTPS 访问到的 n8n 实例，n8n Cloud 或自己的服务器都行。
• 一个 Twilio 账号、它的 Account SID 和 Auth Token，以及一个 WhatsApp 发送号码。测试时可以用 Twilio 的 WhatsApp Sandbox。
• 一个 OpenAI API 密钥。
• 一个 WooCommerce 店铺，以及一对有读取权限的 REST API consumer key 和 secret（WooCommerce、Settings、Advanced、REST API）。
• 一个 Google 账号，和一张 Google 表格，里面有一个名为 Sheet1 的标签页，第一行是这些表头：Issue Number、Name、Phone Number、Email、Issue、Created。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 用你的 Account SID 和 Auth Token 添加一个 Twilio 凭据，在 Twilio Trigger 和 Send an SMS/MMS/WhatsApp message 里选中它。
3. 添加一个 OpenAI 凭据，在 OpenAI Chat Model 里选中它。
4. 用你店铺的地址、consumer key 和 secret 添加一个 WooCommerce 凭据，在 Get Inventory 和 Get Orders 里选中它。
5. 建好表格，复制它的 ID，也就是地址里 /d/ 和 /edit 之间那一长段。添加一个 Google Sheets OAuth2 凭据，在 Create Tickets 里选中它，再把 YOUR_SHEET_ID 换成这个 ID。
6. 打开 Message a model。把系统消息中的 YOUR_SHOP_NAME 换掉，再加上你自己的规则：发货时间、退货、营业时间、什么时候转给真人。
7. 保存并点 Publish。触发器随后订阅你 Twilio 账号收到的消息。
8. 用你自己的手机，向你的 WhatsApp 号码问一件商品，读一读回复。

一条消息怎么得到回复

1. Twilio Trigger 收到消息。文字在 data.body，发送者在 data.from。
2. 智能体 Message a model 拿到文字和当前时间。Simple Memory 补上和这个电话号码最近 50 轮的往来。
3. 问题需要时，智能体就调用一个工具：
   - Get Inventory 列出每一件标为有货的商品。
   - Get Orders 按模型传来的订单号读取一张订单。
   - Create Tickets 新增一行：Issue Number 是以毫秒计的那一刻，Created 是时间，姓名、电话、邮箱和问题都来自模型。
4. Remove Annotations 删掉用【】括起来的来源标记。原来的 assistant 会加这种标记，智能体很少加，所以留着它作为保险。
5. Send an SMS/MMS/WhatsApp message 从顾客发消息的那个号码把回复发出去。

改变结果

• 规则和语气：Message a model 的系统消息。
• 记忆：Simple Memory 里的 Context Window Length，文件里是 50。
• 工单：Create Tickets 的列映射。想记下顾客发消息用的号码，就把 {{ $('Twilio Trigger').item.json.data.from }} 映射到 Phone Number，替换模型给的值。
• 模型：OpenAI Chat Model，设为 gpt-4.1-mini。

注意事项

• Twilio 对每条进出的 WhatsApp 消息收费。OpenAI 对智能体的调用收费，用到工具时调用更多。
• 顾客打出任何订单号，Get Orders 都会返回那张订单，不检查它是不是对方的。告诉智能体，在透露任何内容之前，先把订单上的账单电话和发送者的号码对比一下。
• Get Inventory 每次被调用，都会把你整个有货商品目录发给模型。大店铺要为很长的提示词付钱。
• 回复按智能体写的原样发出。在顾客看到之前，先用自己的手机测试你的规则。
• Simple Memory 存在 n8n 内部，重启一次，每个对话的记录都会清空。
• Sandbox 只能联系用它的代码加入过的手机。要服务顾客，需要一个通过 Twilio 审核的 WhatsApp 发送号码。
• OpenAI 的弃用页面列出 GPT-4.1 mini（gpt-4.1-mini-2025-04-14）将于 2027 年 1 月 14 日从 API 下线，替代模型是 gpt-6-luna。在那之前把 OpenAI Chat Model 的模型换掉。
• 顾客的消息、订单详情和你的商品清单会发给 OpenAI。工单把姓名、邮箱和电话号码留在你的表格里。