WooCommerce 订单状态聊天智能体，带 DHL 物流追踪

WooCommerce 订单状态聊天智能体，带 DHL 物流追踪

一个把 AI 智能体放到 WooCommerce 店铺聊天后面的 n8n 工作流。顾客问起一个订单。智能体按你的网站提供的邮箱地址找到顾客，通过 WooCommerce API 读取他的订单，订单上有物流单号的，就加上 DHL 的物流事件。邮箱地址是加密后送进工作流的，所以聊天只会回答它所属那位顾客的事。

包里有什么

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

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

• OpenAI Chat Model 原来调用 gpt-4，OpenAI 已于 2026 年 10 月 23 日关停它。OpenAI 的弃用页面（2026 年 11 月 12 日查阅）指定 gpt-5.6-sol 为替代，所以这个节点现在调用它。
• 智能体的系统消息原来用 {{ $json.email }} 告诉它顾客的邮箱。聊天条目里没有这个字段，因为 Mock Data 和解密那一步都把邮箱放在 metadata.email 下。现在消息读 {{ $json.metadata.email }}，所以被问到时智能体能复述这个邮箱。
• WooCommerce Get Orders 原来指向作者自己的测试店铺。它的地址现在是 https://YOUR_STORE_DOMAIN/wp-json/wc/v3/orders。
• 三个给邮箱加密和解密的 Code 节点原来用密码 a random password。现在每个都是 YOUR_SHARED_PASSWORD。
• 示例顾客邮箱以及它的加密形式，在 Mock Data、Encrypt email、Example encrypted email 和示例页面里都换成了占位符：<CUSTOMER_EMAIL> 和 <ENCRYPTED_EMAIL>。页面里的聊天地址是 <YOUR_CHAT_WEBHOOK_URL>。
• 这个文件原来没有名字，我们给它起了一个。webhook ID 和凭据关联都已删除。
• 别的都没改。Code 节点的逻辑照原文件。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行。Code 节点使用 Node 的 crypto 模块。文件自己的便签说，环境变量 NODE_FUNCTION_ALLOW_BUILTIN 必须等于或包含 crypto，并说这是 n8n Cloud 的默认设置。自己的服务器请检查一下。
• 一家 WooCommerce 店铺，以及一个用于它 REST API 的 WooCommerce 凭据，有 consumer key 和 secret。
• 一个 OpenAI API 密钥。
• 一个 DHL 凭据，如果你保留物流分支的话。
• 每个订单的物流单号，存在订单元数据的 _wc_shipment_tracking_items 键下。物流分支读的就是这个键。
• 一个放聊天的网站，以及一个能给顾客邮箱加密的后端。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 在 WooCommerce - Get User 和 WooCommerce Get Orders 里选你的 WooCommerce 凭据，在 OpenAI Chat Model 里选你的 OpenAI 凭据，在 DHL 里选你的 DHL 凭据。
3. 在 WooCommerce Get Orders 里，把 YOUR_STORE_DOMAIN 换成你店铺的域名。
4. 要测试，打开 Mock Data，把 <CUSTOMER_EMAIL> 换成一位有订单的顾客的邮箱。文件原样是 Mock Data 开着、Decrypt email address 关着。点聊天按钮，问一个订单。
5. 打开 AI Agent，编辑系统消息。它里面写了一家店 Best Shirts Ltd.，并写明了它的发货和送达时间。
6. 要正式使用，选一个密码，填进 Decrypt email address 里的 YOUR_SHARED_PASSWORD。在你自己的后端，按 Encrypt email 的做法，用同一个密码给每位已登录顾客的邮箱加密，并把结果作为 metadata.email 交给聊天。
7. 启用 Decrypt email address，禁用 Mock Data。是禁用，不要删除：Window Buffer Memory 里的键从它那里读会话 ID。如果你还是删了它，就把那个键指向 Chat Trigger。
8. 发布工作流。把 Chat Trigger 里的正式地址，复制到你页面里写着 <YOUR_CHAT_WEBHOOK_URL> 的地方。Webhook Example Page（路径 website-chat-example）提供一个可以复制的示例页面。

一次运行的过程

一条聊天消息：

1. Chat Trigger 是公开的，所以任何拿到它地址的人都能开始聊天。它传下去消息、会话 ID，以及页面设置的 metadata 对象。
2. Decrypt email address 把 metadata.email 还原成邮箱地址。文件里它是关着的。Mock Data 改为把这个字段设成一个固定地址，它是开着的。
3. AI Agent（1.4 版）带着 OpenAI Chat Model、Window Buffer Memory（保留一个会话最近 10 条消息）和一个工具 WooCommerce_Tool 运行。它的系统消息定下语气，要求只使用顾客自己的邮箱，并写明订单在购买后 1 到 2 天内发出，再过 1 到 2 天送达。
4. WooCommerce_Tool 带着字段 email 调用这同一个工作流，这个字段取自 metadata.email。智能体传入它想要的订单 ID，用逗号隔开，或者什么都不传，表示全部订单。

工具调用，从 Execute Workflow Trigger 开始：

1. If email provided 把空邮箱拦在 No email provided。
2. WooCommerce - Get User 按这个邮箱找到一位顾客。If user found 把没找到的情况送到 No customer found。
3. WooCommerce Get Orders 向 /wp-json/wc/v3/orders 要这位顾客的订单，智能体给了 ID 时就只要这些。If order found 把没找到的情况送到 No order found。
4. Extract Tracking Data 从每个订单里读取 _wc_shipment_tracking_items。If contains DHL data 只放行至少有一条物流记录的订单，Split Out 为每条记录生成一个条目。
5. DHL 查询每个物流单号。它的错误输出接到 Add Error Information，那里写上找不到这个包裹的数据。Merge Tracking Data 和 Aggregate 把结果汇集到 tracking。
6. Merge Orders 和 Merge Order and Tracking Data 把每个订单和它的物流信息合在一起，Send Response 把一个 response 列表交给智能体。上面任何一步没找到时，就把它那句简短的话放进 response。

想改的地方

• 店名、语气和送达时间：AI Agent 里的系统消息。
• 模型：OpenAI Chat Model。gpt-5.6-terra 是 OpenAI 点名的两个替代模型里更便宜的一个。
• 聊天记住多少：Window Buffer Memory 里的 Context Window Length。
• 换一家承运商：把 DHL 换成那家承运商的查询，或者删掉物流分支，只留订单。
• 页面：Respond to Webhook 里的 HTML。

要知道的

• 只有加密后的值把一个聊天和一位顾客联系起来。它没有签名，也没有过期时间，谁知道了密码，就能为任何顾客写出一个值。别让密码出现在页面里，也别放进代码仓库。
• Chat Trigger 是公开的，所以任何找到它地址的人，都能用你的 OpenAI 密钥开始一次聊天。
• 每个物流单号都发给 DHL，不管它是哪家承运商。别家承运商的包裹会停在 Add Error Information。
• Mock Data 开着的时候，每个聊天都属于填在那里的那一个地址。聊天面对真实顾客之前，先把它关掉。
• 示例页面从 jsDelivr 以 @latest 加载聊天组件。在你自己的网站上请固定一个版本。
• 数据去向：每次查询都把整张订单发给 OpenAI，包括顾客的姓名、地址、电话号码和商品，物流单号发给 DHL。
• 费用：OpenAI 对每个智能体轮次收费，每次查询还会调用一次你店铺的 API，每个包裹调用一次 DHL。