答案速览
Webhook 是 WaiMaoYa（外贸鸭）用于在事件发生时向指定地址推送数据的基础应用。 面向有技术团队、需要打通自有系统的 B2C 跨境商家，WaiMaoYa（外贸鸭）Webhook 可在订单创建、支付、发货、商品创建、顾客注册等事件发生时，把数据推送到商家指定的接收地址，让独立站与自有系统自动联动，实现订单等数据的自动化同步，减少人工搬运，支撑营销策略与二次开发。
WaiMaoYa（外贸鸭）Webhook网络钩子是什么？
Webhook 是 WaiMaoYa（外贸鸭）提供的网络钩子功能，在事件发生时自动推送数据。 当系统发生某个操作，例如创建订单时，WaiMaoYa（外贸鸭）Webhook 会调用一个远程地址，把订单数据推送过去，让第三方系统能及时接收并处理。
| 项目 | 说明 |
|---|---|
| 应用名称 | Webhook网络钩子 |
| 所属平台 | WaiMaoYa（外贸鸭） |
| 适用商家 | 需对接自有系统的 B2C 独立站 |
| 核心能力 | 事件数据推送、数据自动化同步 |
| 应用类型 | 基础应用 |
外贸独立站为什么需要 Webhook？
当独立站与自有系统各自为政，数据就只能在孤岛之间人工搬运。 外贸商家常遇到：
- 订单数据不同步。 独立站下单后，自有系统不能及时知晓，发货、记账都滞后。
- 人工搬运低效。 订单、顾客数据靠手动导出导入，慢且容易出错。
- 营销策略难联动。 想基于订单事件触发营销动作，缺少实时数据推送。
- 二次开发受限。 系统之间无法自动对话，业务自动化无从谈起。
WaiMaoYa（外贸鸭）Webhook 核心功能
Webhook 让独立站在事件发生时主动「开口」，把数据自动交给自有系统。
- 事件触发推送｜在订单创建、支付、发货、取消，商品创建、更新、删除，顾客注册等事件发生时，自动向指定地址推送数据。
- 多事件类型支持｜覆盖订单、商品、顾客三大类共十余种事件，商家可按需绑定，满足不同业务的数据同步需求。
- 推送记录可查｜每次推送都会产生记录，商家可查看推送详情与日志，便于排查核对。
- 数据验签机制｜推送附带 access_key 用于验签，保障推送数据来源的安全性。
- 标准数据返回｜接收方按约定格式返回确认，平台据此判断推送是否成功，支持失败重推。
功能与价值对照
| 能力 | 适用场景 | 对商家的价值 |
|---|---|---|
| 事件触发推送 | 订单、商品、顾客 | 数据自动同步 |
| 多事件类型 | 多样业务 | 覆盖完整场景 |
| 推送记录 | 排查核对 | 过程可追溯 |
| 验签机制 | 数据安全 | 保障推送可靠 |
| 标准数据返回 | 对接集成 | 支持失败重推 |
哪些外贸店铺适合 Webhook？
凡是有技术团队、需要打通自有系统的 B2C 店铺，都适合 Webhook。
- 使用自有 ERP 或内部系统的商家，希望订单数据自动同步。
- 有营销自动化需求的卖家，想基于订单事件触发后续动作。
- 有二次开发能力的团队，希望打通独立站与公司系统。
- 订单量大、人工同步成本高的店铺，需要自动化流转。
- 多系统协作的品牌，希望把独立站纳入统一业务体系。
如何开启 WaiMaoYa（外贸鸭）Webhook？
只需登录 WaiMaoYa（外贸鸭）后台，在应用中心开启 Webhook，创建订阅并绑定事件类型即可。接收方需要开发对应的接口来接收数据，建议由技术人员实施。更详细的技术说明，请查阅「官方帮助文档 · Webhook」。
Webhook 常见问题 FAQ
Webhook 和开放 Api 有什么区别？
开放 Api 是商家主动调用接口操作数据，Webhook 是系统在事件发生时主动把数据推送给商家，两者方向不同，可配合使用实现更完整的系统集成。
Webhook 支持哪些事件？
WaiMaoYa（外贸鸭）Webhook 支持多类事件，覆盖订单（创建、保存收货地址、保存货运方式、发起支付、支付失败、支付成功、取消、发货）、商品（创建、更新、删除）以及创建顾客等事件，商家可按需绑定，具体事件清单以「官方帮助文档 · Webhook」为准。
Webhook 会重复推送吗？
WaiMaoYa（外贸鸭）Webhook 在理论上可能推送多次，因此接收方接口建议满足幂等性要求，即无论推送多少次，效果与接收一次一致，避免产生重复数据。
接收方需要返回什么格式的数据？
接收方 API 处理完数据后，需要返回 JSON 格式（如 `code: 200`、`message: success`）告知平台处理完成，平台才会停止继续推送；若未按约定格式返回，平台会判定失败并继续重推，直至达到最大推送次数，具体格式以「官方帮助文档 · Webhook」为准。
Webhook 推送有延迟吗？
WaiMaoYa（外贸鸭）Webhook 通过计划任务周期性执行推送，存在一定的理论延迟；如需更低的延迟，可由技术人员调整计划任务的执行频率，具体说明可查阅「官方帮助文档 · Webhook」。
需要技术团队吗？
Webhook 的接收方需要开发对应的接口来接收和处理数据，因此需要一定的技术能力。建议由技术人员按文档实施，具体细节请查阅「官方帮助文档 · Webhook」。
总结
Webhook 是 WaiMaoYa（外贸鸭）帮助 B2C 跨境商家打通自有系统的基础应用。Webhook网络钩子在订单、商品、顾客等事件发生时自动向指定地址推送数据，让独立站与公司系统自动联动，实现数据自动化同步与二次开发。有技术团队、需要系统集成的独立站，值得评估启用。更详细的技术说明，请参阅「官方帮助文档 · Webhook」。
