必须完成商城后台数据对接才能实现数字人自动讲解、实时弹链和库存同步，具体需检查商品查询、订单回调、库存写入三类api，缺失则升级或通过中间件桥接，并配置webhook双向验证及动态话术变量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让百度一镜数字人自动讲解商品、实时弹出链接、同步库存状态，必须完成与商城后台系统的数据对接，否则数字人只能口播固定话术，无法响应真实订单和库存变化。
确认商城系统是否支持标准API接入
登录你的商城后台（如有赞、微店、Shopify、自建ERP等），进入【开发者中心】→【API管理】→【查看可用接口列表】。重点检查是否存在以下三类接口：【商品信息查询接口】、【订单创建回调接口】、【库存同步写入接口】。若缺失任意一类，需先联系商城服务商开通或升级为专业版/企业版。
没有标准API的老旧系统（比如部分本地部署的PHP小商城），无法直接对接，必须通过中间件做协议转换，跳过本阶段直接进入“自建中台桥接”方案。
使用百度一镜官方商城插件快速接入（推荐）
方法一：适用于有赞、微店、京东云小店、百度优选店铺
登录百度一镜控制台 → 左侧导航栏点击【电商集成】→ 选择对应商城品牌图标 → 点击【一键授权】→ 输入商城后台管理员账号密码 → 授权完成后，系统自动拉取商品库、分类、SKU及实时库存快照。
注意：该方式仅同步基础字段（名称、主图、价格、库存），不包含详情页富文本、视频、规格参数表。如需展示完整详情，须额外配置【详情页URL映射规则】。
方法二：适用于Shopify、Magento、WooCommerce等海外主流系统
在商城后台安装百度一镜官方Shopify App（搜索“Baidu Yijing Live”）→ 启用后获取API Key与Secret → 返回百度一镜【电商集成】页面，选择“Shopify”类型 → 粘贴Key/Secret → 点击【验证连接】→ 成功后勾选【启用实时库存监听】与【自动创建订单回传】。
手动配置Webhook实现双向通信
第一步：在百度一镜控制台【电商集成】→【Webhook设置】中，复制“订单创建通知地址”（形如 https://api.yijing.baidu.com/webhook/order/v1?token=xxx）
第二步：登录商城后台【Webhook管理】→ 新建订阅 → 事件类型选择【order.created】→ URL栏粘贴上一步复制的地址 → 签名方式选HMAC-SHA256 → 填入百度一镜提供的Secret（在Webhook设置页底部显示）→ 保存
第三步：返回百度一镜，点击【测试推送】，观察商城后台是否收到模拟订单JSON；若无响应，检查商城防火墙是否拦截了百度云IP段（110.242.0.0/16、220.181.0.0/16）
这一步必须完成双向验证——商城能向百度一镜发单，百度一镜也要能向商城回写履约状态。否则数字人说“已下单”，实际订单却卡在待支付，会触发大量客诉。
配置商品动态标签与话术绑定
进入【数字人直播】→【脚本管理】→ 编辑当前直播脚本 → 在商品讲解段落插入变量标签，例如{product.price}、{product.stock}、{product.discount}。
百度一镜会在每次口播前，自动调用已对接的商城API拉取最新值并渲染进语音合成引擎。若某商品库存≤3，系统默认触发预警话术：“手慢无！只剩最后{product.stock}件！”
变量名必须与商城API返回的JSON字段名完全一致，大小写敏感。例如商城返回的是"stock_num"，你就不能写{product.stock}，否则渲染为空白。
