ConnectWiz + WooCommerce

已上线的集成

双向的 WooCommerce 同步——外加一份归属权约定

大多数所谓的“Woo 集成”,无非是一个导入按钮加一句祈祷。这一个是受管控的双向同步:每一类数据由哪套系统说了算,由你来定——而每一次冲突都会落进台账,而不是悄悄把数据盖掉。

一键配对 字段级的归属权 冲突都进台账
WooCommerce × ConnectWiz
先彩排,再上线
商品、图片、变体流入
归属权:Woo / 这边 / 双向——你来定
发现冲突 → 进台账,可重试
30+
项字段随每个商品一起搬过来——图片、促销时间段、GTIN、标签、追加销售/交叉销售、变体
15 分钟
配对链接的有效期——连接握手会过期,而不是一直挂在那里
4
个 Webhook 主题自动开通——商品、订单和客户的变更都会流进来
2,000
件商品,每次导入的上限——这是明说的上限,而不是到第 2,001 行才给你的惊喜

电商

它到底能做什么

一键配对

标准的 WooCommerce 授权流程会自动开出 API 密钥和 Webhook——不用复制密钥的仪式,也没有 Webhook 检查清单。

深度导入

图片、分类树、原价与促销价及其生效时段、GTIN、标签、追加销售与交叉销售、变体的价格和图片——商品目录是整个搬过来的,而不是一副只有名称和价格的骨架。

真正的写回

在这边改商品可以写回 Woo——由逐项操作的开关管着,还带彩排模式,所以在任何东西真的变动之前,你先看得到会变什么。

字段级的归属权

每一类数据你都可以单独选:归 Woo、归这边,或者双向同步。归属在别处的字段会以只读方式呈现,并在界面上写明原因——不会出现两个主人的混乱。

一本冲突台账

失败或冲突的同步会落进一本看得见的台账,可以处理完再重试——绝不会变成盘库时才发现的一次静默覆盖。

订单也进这条流

Woo 订单会带着来源标记出现,和来自聊天商城、AI 与 API 的订单并排——所有入口共用同一份订单事实。

技术细节

多数集成跳过的那部分同步工程

一次疑心很重的配对握手

连接链接 15 分钟后失效,回调在做别的任何事之前就先被标记为已消费,因此不可能被人拿旧凭据重放——而真正使用的商店地址,是你自己输入的那个,绝不是回调声称的那个。

从设计上就不怕重试

Woo 每次重试都会给投递重新编号,所以去重刻意忽略这些编号,改以消息内容为键。出站方向上,幂等键放在订单自己的元数据里,靠搜索重新找回来——因为真正危险的情况是:写入成功了,响应却丢了。

关联留到第二趟处理

追加销售和交叉销售过来时只是一串商店 ID,指向的商品可能还不存在——所以它们要等商品目录落地之后,在第二趟里才被解析;分类树则单独拉取,因为商品数据里只写了叶子节点的名字。

币种只读一次,读对为止

Woo 只在订单上给出币种,从不在商品上给——所以商店币种是在导入目录之前,从商店自己的设置里读一次,而不是逐行去猜。

一张保守的状态映射表

履约状态只在两边术语真正对得上的地方才做映射;“已退货”的订单绝不会被硬翻过去——它会作为一条订单备注送到人手里。状态备注发布时会关掉客户通知,免得 Woo 又给你的客户发一封邮件。

你手敲的内容说了算

在这边被人手动改过的字段,绝不会被一次导入覆盖掉——同步尊重人的判断,并在每个条目的来源卡片上写明这一点。

接入设置

连接方式

01

配对商店

点击连接,在你的 WooCommerce 后台点确认——密钥和 Webhook 都会替你配好。

02

选定归属权

按数据类别逐一选定谁说了算:Woo、ConnectWiz,还是双向。

03

先彩排,再上线

写回操作先在彩排模式里跑一遍;差异看着没问题,再切到正式。

搭配更好用

能与什么搭配

WordPress 插件

我们的 WordPress 插件 ——把已登录的 Woo 客户直接带进聊天:同步早就认识这个人,订单一并附上,不用重新注册。

商品源

导入后的商品目录可以发布成 Google Shopping / Meta Commerce 的商品源——一个变体一行,跳过的都如实写明原因,绝不凭空换算币种。详见 Commerce。

Wiz + Flows

AI 会用商店的实时数据回答“我的订单到哪了?”,而 Flows 则可以对电商事件做出反应——这套同步是其他一切赖以站立的地基。

安全与保证

无聊但管用的保证

密钥自动下发,不用粘贴

wc-auth 流程让你的商店在服务端把密钥交给我们——加密存储,也就没有那套让人有机会泄露的复制粘贴仪式。

每个 Webhook 都要验证

入站投递用我们按商店单独生成的密钥做 HMAC 签名,并以恒定时间比对——伪造的“商品更新”在门口就被弹回去。

对你的商店很客气

已验签但我们暂不处理的投递,照样回成功,因为 Woo 在连续五次失败后会停用一个 Webhook——怪东西由我们吞下,而不是让你的商店对我们死心。

出站有 SSRF 防护

每一次对你商店地址的调用都要过一道出站防护——恶意的“商店地址”无法被拿去探测内网。

不加粉饰的细则

边界,写清楚

不做支付处理

订单会同步;扣款仍然归你的商店和支付服务商——假装不是这样,正是平台把自己做成半个蹩脚银行的路径。

媒体随归属权走

凡是内容字段归 Woo 所有的地方,在这边就是只读的,这是刻意的设计——归属权约定的意义,正在于它同样约束我们。

2,000 件商品的上限

一次导入最多带 2,000 件商品——这是明说的工程边界。更大的商品目录是一场关于扩容的谈话,我们宁愿坦率地谈,也不愿让它悄无声息地超时。

订单是读取,不是复制

商店订单直接实时显示在联系人上(缓存一分钟,取最近十条),而不是被复制进第二本台账——这是一个刻意的单一事实来源决定,写在这里。

WooCommerce FAQ

直接的回答

更多内容见完整的 FAQ, 也可以直接联系我们。

商品及其图片、分类、原价/促销价及生效时段、GTIN、标签、追加销售与交叉销售,还有各自带价格和图片的变体——配对时入站,出站则通过你按数据类别逐一启用的写回操作。订单进来时会带上 WooCommerce 的来源标记。

不会——这正是整个设计的核心。写回按操作逐项执行,前面还挡着彩排模式;字段级归属权让归属在别处的字段变成只读;确定性的幂等键让重试是安全的;任何冲突都会落进一本看得见的台账,交给人来处理。

它们解决的是不同的问题:这个集成同步的是商品目录和订单;WordPress 插件负责嵌入聊天挂件,并通过 SSO 把客户登录进来,让已登录的 Woo 客户在聊天里被认出来。多数商店两个都用。

这个集成分得清“商店挂了”和“这位客户从没买过东西”——传输失败会作为错误显示出来,绝不会被悄悄画成一条空白的购买记录。读取失败会退避后重试,而不是拼命捶你的服务器。

每一笔镜像过去的订单,元数据里都带着一个确定性的幂等键;创建之前,集成会先搜索这个键——所以即便是“写入成功但响应丢失”那种恶劣情况,也不会产出第二笔订单。这道查重在彩排模式下同样会跑。

可以——有账号的按账号身份匹配,游客订单则通过邮箱或手机号搜索找到,所以在聊天里问“我的包裹在哪”的那个人,两种情况下都认得出来。

诚实的连接,胜过响亮的连接。

这里的每一个集成都按它实际的行为来描述——数据方向、归属权和限制,一并写清楚。