Agent Skills
返回列表
💻

WooCommerce Webhook 编排器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/woocommerce-webhook-orchestrator 到你的 AI 助手中

技能介绍

要解决的问题

在 WooCommerce 生态里，Webhook 数量一旦上来，管理就很散：订单状态变更、商品信息更新、客户资料修改各自触发的回调分散在不同插件或自建服务里，签名校验逻辑也常常各写一套。结果就是重复造轮子、事件路由规则难以统一维护，排查问题时要在多个接收端之间来回翻日志。

这个技能做什么

这个技能把 WooCommerce Webhook 的生命周期管理收敛到一处，基于 wc/v3/webhooks REST API 和 PHP 端的 WC_Webhook 类来完成常见操作。

核心能力包括：

  • 事件路由：围绕订单、商品、客户三类主题，把回调分发到对应的处理端
  • 签名校验：使用 X-WC-Webhook-Signature 请求头对 payload 做校验，避免伪造请求
  • 生命周期管理：创建、读取、更新、停用 Webhook，统一走同一套代码路径

关键步骤上，接收端先从请求头取出签名，再与本地计算出的期望值做比对，通过后再按事件类型进入对应的处理分支。这一套逻辑直接复用 WooCommerce 官方的 Webhook 实现，减少自己拼装 HTTP 调用和解析 JSON 的工作量。

适用边界与注意点

  • 技能面向 WooCommerce 核心自带的 Webhook 机制，不覆盖第三方插件自定义的事件类型
  • 需要 PHP 7.4 或更高版本来运行相关构建脚本与 Composer 命令
  • 假设环境是 POSIX 兼容系统，在 Windows 上建议通过 WSL 运行
  • 签名校验依赖 WooCommerce 的密钥机制，接收端需要妥善保管 API secret

使用场景

  • 维护 WooCommerce 订单回调时，需要按订单状态变更把请求路由到不同处理模块
  • 处理商品上下架事件时，需要统一校验 payload 签名并更新外部库存系统
  • 接收客户资料修改回调时，需要确认 X-WC-Webhook-Signature 后同步到内部 CRM
  • 排查 Webhook 回调失败时，需要按 wc/v3/webhooks 接口逐项核对订阅配置

适合人员

  • WooCommerce 店铺后端工程师，需要统一管理订单、商品、客户的 Webhook 订阅与回调路由
  • 搭建 WooCommerce 与外部系统对接的集成开发者，需要在接收端校验 X-WC-Webhook-Signature 并处理事件
  • 维护 WooCommerce Monorepo 的 PHP 工程师，需要在 POSIX 环境下跑通 Composer 与构建脚本并调整 Webhook 逻辑
  • 排查线上回调失败的技术支持，需要根据 wc/v3/webhooks 接口与 WC_Webhook 类定位订阅配置问题