wix-manage

管理操作指南索引

本指南中所有 curl 示例的标准调用格式。 示例 curl 中的 <AUTH> 占位符仅代表 Authorization 标头；包含请求体的调用还需要 Content-Type: application/json。

什么是管理操作指南？

管理操作指南适用于 REST API 操作，用于配置、设置和管理网站上的 Wix 业务实体。这些指南使用 REST API 调用，适用于：

• 网站设置与配置——初始设置商店、预约、支付及其他业务应用
• 实体管理——创建、更新和删除产品、服务、员工、定价方案
• 管理操作——批量更新、联系人标记、数据迁移
• 后端集成——服务器间自动化、Webhook、数据同步

这些指南不涵盖前端开发或用于向用户展示数据的 SDK 用法。

---

应用安装

安装 Wix 应用

使用 Apps Installer API 在网站上安装 Wix 应用。涵盖启用 Velo（Wix Code）、应用安装以及常见的应用定义 ID。

列出已安装的应用

使用 Apps Installer API 列出网站上安装的所有应用。可用于在调用 API 前验证应用是否已安装，以及诊断授权错误。

应用管理控制面板导航

"构建指向 manage.wix.com 上应用管理控制面板页面的直接链接，包括 App Market 和已安装应用管理页面。将已安装的应用与 List Installed Apps 读取 API 配合使用。当用户询问 Wix 控制面板中的某项内容在哪里、需要控制面板页面的直接链接，或你需要将控制面板 URL 与 API 操作结果一并提供时使用。"

---

自定义应用

使用应用工具

"发现并运行应用工具，即 Wix 网站上已安装的应用向 AI Agent 提供的操作和查询功能，例如使用定价应用转换价格，或使用配送应用追踪包裹。涵盖列出网站的应用工具、根据描述选择工具，以及使用根据其输入架构构建的载荷运行工具。当用户需要使用已安装应用提供的功能而非 Wix 内置功能、询问其应用能做什么，或提及某个应用或应用工具时使用。"

---

SEO

管理 Wix 网站的 SEO 标签

在正确的层级读取并更新 SEO 标题和标签。对于“更改我网站的 SEO 标题”，在发现或写入前先确认是首页、特定页面还是页面类型模式；网站级标签仅接受元标签，不接受标题。发现项目 ID 和模式变量，每次全量替换写入前先读取，并报告已解析的标签及其来源。

管理 Wix 网站的 URL 重定向

"使用公开的 SEO Redirects API 获取、创建和删除 Wix 网站上的 URL 重定向。涵盖精确重定向和分组重定向、多语言网站的按语言限定重定向、最多 100 项的批量创建和最多 500 项的批量删除，以及已存在重定向的变更流程。此 API 不提供查询、搜索或更新方法：List Redirects 是唯一的批量读取方法。重定向不会串联，因此，创建一个指向另一条重定向起始路径的重定向，会永久删除那条已有重定向；每次写入前都要先列出并检查。"

生成并读取 Wix 网站的内容计划

为 Wix 网站生成 SEO 内容计划，读取建议的博客文章主题和关键词，或诊断并继续已有的停滞生成流程，包括缺少流程标识符的请求。

管理 Wix 网站的 Google Search Console

"通过公开的 GSC Connection 和 Site Readiness API，将 Wix 网站连接到 Google Search Console 并完成相关设置：检查连接状态和就绪状态、启动 Google 授权、验证所有权、添加资源、提交站点地图、请求编入索引、读取搜索效果、运行 URL 检查、恢复失效的连接，或断开连接。网站所有者通过一次性连接 URL 在自己的浏览器中授权。"

为 Wix 网站生成 AI SEO 建议

"通过公开的 Tag Suggestions 和 Page Optimization API，为 Wix 网站生成 AI 撰写的 SEO 文本：为页面提供标题标签和元描述选项，为页面、商店商品或博客文章中的图片撰写替代文本（每次调用处理一张图片或最多 20 张图片），更正页面标题的层级，并围绕页面的焦点关键词重写整页内容，包括标题、描述、各级标题和正文，并以修改前后对照的形式返回。适用于用户想要改进、优化、审核或撰写页面或首页的 SEO 文本的情况。建议会返回供审核；应用建议需要单独写入 SEO 标签。"

---

无障碍访问

扫描 Wix 网站的无障碍访问问题

运行 Wix 无障碍访问扫描，检查整个网站、单个页面，或任何受支持页面集合中的所有页面，包括商品、博客文章、预约服务、活动和餐厅页面。轮询异步扫描直至完成，单独报告扫描失败的页面，获取按优先级排序的发现结果，并使用返回的修复指南帮助用户解决并验证问题。

---

分析

查询网站分析数据

通过 Semantic Model API 获取 Wix 网站的分析数据。涵盖列出语义模型、查看模型架构（度量、维度、参数），以及使用必需的时间间隔、筛选条件、排序、分页和易读格式查询模型数据。

分析仪表板导航

"构建指向 manage.wix.com 上 Wix Analytics 仪表板页面的直接链接，包括概览、报告、按域名划分的总览（流量、行为、销售、营销）以及效果洞察和基准对比。将分析数据与其读取 API 配合使用，以便通过 API 回答问题，并提供“在仪表板中查看”链接。适用于用户询问 Wix 仪表板中某项内容的位置、需要仪表板页面的直接链接，或需要将仪表板 URL 随 API 操作结果一并提供的情况。"

---

博客

如何创建博客文章

使用 Blog Posts API 创建并发布博客文章。涵盖解析必需的作者 memberId（包括在网站没有作者成员时创建作者成员）、Ricos 富文本内容格式、通过 Media Manager 上传图片、分配分类和标签，以及批量创建文章。

博客仪表板导航

"构建指向 manage.wix.com 上 Wix Blog 仪表板页面的直接链接，包括文章列表（已发布和草稿标签页）、分类、标签、作者、评论审核、博客分析、变现和设置。将每个主要 Blog 实体与其读取 API 配合使用，以便获取实体并提供“在仪表板中查看”链接。适用于用户询问 Wix 仪表板中某项内容的位置、需要仪表板页面的直接链接，或需要将仪表板 URL 随 API 操作结果一并提供的情况。"

---

预约

Booking Service Policy Setup

使用 Booking Policies API 设置预约政策、取消规则和候补名单配置：查询（默认）bookingPolicy 实体，然后使用其版本修订号执行 PATCH。涵盖 cancellationPolicy、reschedulePolicy、预约通知限制、waitlistPolicy 和参与者人数限制，例如“客户最晚可在预约开始前 24 小时取消”。

Bookings Staff Setup

“使用 Staff API 和 Calendar Events API 创建员工并配置自定义工作时间。关键的两步流程：创建员工 → 分配日程 → 创建工作时间事件。”

Create and Update Booking Services

“根据简单请求创建和更新各种类型的 Wix Bookings 服务，包括预约、课程和培训班，例如‘一场 75 美元的 60 分钟咨询’、‘每周二面向 12 人的瑜伽课’或‘为期 6 周的摄影培训班’。涵盖选择服务类型、为请求中未说明的内容设置默认值、定价（免费、固定价格、免费转付费）、员工、容量、时长、分类、可见性、图片、在日历中安排课程和培训班场次，以及修改现有服务。”

Check Bookings Availability (and Diagnose Issues)

“回答基于预约的 Wix Bookings 服务当前是否有可预约时段这一首要问题；只有在没有可预约时段或所有者询问原因时，才诊断问题。诊断时，首先排除可预约时段接口无法检测到的服务级阻碍因素（服务已隐藏、已关闭在线预约），然后运行 DiagnoseAvailability，按顺序获取机器可读的员工/设置问题原因；如果问题由预约政策或容量导致，则手动排查。当有人询问服务是否有可预约时段，或为什么服务没有显示时段／客户无法预约时使用。”

End-to-End Booking Flow

使用网站所有者的凭据预订并完成预约、课程和培训班的结算，适用于管理预约的运营人员，或以所有者身份预订的服务器端代码。涵盖服务发现、使用 Time Slots V2 查询可预约时段、创建预约，以及通过直接确认或通过 eCommerce 结账收款来完成预约。访客为自己预约时需要使用访客令牌；本指南链接到相应流程。

External Calendar Integration

基于 OAuth 与 Google Calendar、Microsoft Outlook 和 Apple Calendar 集成。涵盖身份验证流程、同步配置和双向事件管理。

Multi-Resource Service Creation

使用 Resources API 创建资源类型和单个资源。支持需要多个资源（房间 + 设备 + 员工）的服务，并自动分配资源。

Bookings Dashboard Navigation

“为 manage.wix.com 上的 Wix Bookings 控制面板页面创建直达链接，包括服务列表、特定服务的编辑页面、日历、预约列表、员工、可预约时段、资源和设置页面。将每个主要 Bookings 实体与其读取 API 配对，以便获取实体并返回‘在控制面板中查看’链接。当用户询问在 Wix 控制面板的什么位置可以找到某项内容、想要某个控制面板页面的直达链接，或你需要将控制面板 URL 与 API 操作结果一并提供时使用。”

---

日历

配置默认营业时间

使用 Calendar Events API 在营业日程中创建 WORKING_HOURS 事件。重点说明设置基本可用时间时，Calendar Events API（正确）与 Site Properties API（错误）之间的关键区别。

日历相关界面（可用时间、默认营业时间）的控制面板链接见预订控制面板导航。

---

CMS

CMS 数据项 CRUD

“在 CMS 集合中逐个或批量添加、查询、更新和删除数据项。还涵盖数据项计数、使用批量保存进行插入或更新、清空集合、通过管道聚合数据、通过单引用和多引用字段关联数据项，以及读取并展开其引用数据项的数据项。”

CMS 电商目录集成

通过 Wix 结账销售现有 CMS 集合数据项（门票、预订、会员资格）的推荐方式。添加 CATALOG 插件，将任意 CMS 集合转换为可购买商品，并集成购物车和付款。

CMS 架构管理

创建和修改 CMS 集合结构。涵盖集合列表、创建含字段的集合、添加或移除字段（包括关联两个集合的单引用和多引用字段），以及更新集合设置。

CMS 草稿与发布工作流（Draft Items 插件）

“通过 Draft Items 插件，与启用草稿/发布工作流的 CMS 集合进行交互。涵盖检测插件、定位配对的草稿集合、读取已发布或草稿数据项、撰写和编辑草稿，以及发布、取消发布、还原和删除数据项。关键端点：/wix-data/v2/items/publish-draft、/wix-data/v2/items/unpublish、/wix-data/v2/collections/add-draft-items-plugin，以及 draftItemsPluginOptions.draftsCollectionId 引用的配对草稿集合。”

CMS 控制面板导航

“构建指向 manage.wix.com 上 Wix CMS（内容管理器）控制面板页面的直接链接，包括集合列表和特定集合的数据项视图。将集合和数据项与其读取 API 配对，以便获取数据并返回‘在控制面板中查看’链接。当用户询问某项内容在 Wix 控制面板中的位置、想要控制面板页面的直接链接，或需要随 API 操作结果附上控制面板 URL 时使用。”

---

联系人

批量删除联系人

使用基于筛选条件的批量删除功能删除多个联系人。涵盖安全删除模式、GDPR 合规、软删除替代方案和批处理策略。

批量添加和移除联系人标签

创建联系人标签定义，或为符合条件的联系人添加或移除标签。仅创建标签时使用 Find or Create Label；只有用户要求为联系人分配标签时，才使用批量标记。

创建联系人

使用 Contacts API 创建联系人。涵盖最少必需的身份识别字段、email 和 phone 的单对象结构，以及使用州、地区和省代码所需的 ISO 3166-2 细分格式添加实际地址。

更新联系人

使用 Contacts API 更新现有联系人的电子邮件、电话、姓名或地址。涵盖用户通过姓名标识联系人时如何查找联系人、如何传入当前版本号，以及州、地区和省代码所需的 ISO 3166-2 细分格式。

联系人仪表板导航

"生成指向 manage.wix.com 上 Wix 联系人（CRM）仪表板页面的直接链接，包括联系人列表、特定联系人的查看页面、联系人导入页面和细分页面。将每个主要联系人实体与其读取 API 配对，以便你可以获取实体并返回一个“在仪表板中查看”的链接。当用户询问某项内容在 Wix 仪表板中的位置、需要仪表板页面的直接链接，或者你需要在 API 操作结果中附上仪表板 URL 时使用。"

---

仪表板导航

仪表板 URL 是配方数据，不是通用知识。 manage.wix.com 路由是应用注册的 slug，不会出现在任何 API 参考中，也无法根据实体名称或其 API 路径推导出来（Forms 页面位于 wix-forms 下，而不是 contacts/forms；Stores 产品位于 wix-stores/products 下）。因此，对于每一个仪表板链接请求——即使不需要调用 API，即使路由看起来显而易见——也要打开下方解决方案的仪表板导航配方，并从其表格中复制路由。这些配方旨在防止的唯一错误，就是凭记忆作答。

仪表板导航

"用于构建指向网站 Wix 仪表板（manage.wix.com）的直接链接的入口。介绍所有仪表板页面共用的 URL 结构（网站和账户级别、应用 ID 回退、实体深层链接、机器可读的 routes.json），并提供每个涵盖的解决方案对应的配方，包括预订、商店/电商、活动、博客、定价方案、餐厅、CMS、联系人、表单、营销、收款、分析、Google Ads、应用管理、网站设置、网站和域名。当用户询问某项内容在 Wix 仪表板中的位置、需要仪表板页面的直接链接，或者你需要在 API 操作结果中附上仪表板 URL 时使用。"

---

域名

搜索、购买和连接域名

通过 Wix 购买域名，或连接用户已拥有的域名——包括意图、可用性、建议、网站解析、注册、隐私、购物车和结账，以及包含所有权查询和将域名绑定到网站的连接流程。

域名仪表板导航

"生成指向 manage.wix.com 上域名管理页面的直接链接，包括网站级别的域名设置页面和账户级别的“我的域名”页面。将域名搜索/购买与其读取 API 配对。当用户询问某项内容在 Wix 仪表板中的位置、需要仪表板页面的直接链接，或者你需要在 API 操作结果中附上仪表板 URL 时使用。"

---

电商

路由 — 选择合适的入口：

• 任何销售/业务改进请求（提升销量、促销、帮助我的业务、节日优惠、提高收入、折扣、配送、优惠券、清仓、礼品卡）→ 使用 推荐：电商策略。这是默认入口——它会分析所有领域（折扣、配送、礼品卡），并生成跨领域建议。不要提出澄清问题。
• 流量获取不属于电商策略请求（“增加我的流量”、SEO、广告、社交媒体、内容）→ 不要使用“推荐：电商策略”；它只会转化商店已有的访客。请将这些请求路由至营销。
• 定价与促销（优惠券、折扣规则、飘带、促销）→ 使用 定价与促销 调度器。
• 配送设置（费率、地区、自提、免费配送、修复覆盖范围）→ 使用 配送 调度器。
• 礼品卡（“我应该卖礼品卡吗”、“添加一张礼品卡”、“我的礼品卡应该有哪些面额”）→ 这些属于建议，因此应通过 推荐：电商策略 处理，该入口会激活其 GIFT_CARDS 领域并自行加载礼品卡目标。发行/兑换单张礼品卡属于礼品卡 API，而不是建议。

电商：加载上下文

L1 加载器——加载每个电商类别所需的网站常规数据（siteId、国家/地区、货币、行业、目录分析数据）。每个类别调度器都会在标签匹配前加载此数据；每个会话只运行一次。

推荐：电商策略

**所有电商建议请求的入口。**统一技能，可分析所有领域（折扣 + 配送 + 礼品卡）的网站数据，生成最多 5 条跨领域建议，并将其保存到跟踪数据库。涵盖折扣策略（季节性、追加销售、库存周转、组合销售）、配送优化（覆盖缺口、免费配送、费率策略、承运商备用方案），以及销售礼品卡（根据网站自身的 AOV 和目录价格确定面额）。对于有关从现有访客中获得更多收入的业务改进请求，请使用此入口。流量获取（SEO、广告、社交媒体、内容）不在范围内——请将“增加我的流量”路由至营销。

定价与促销

将折扣、优惠券、促销和组合销售路由至促销方案，并将可视化产品飘带路由至 Catalog Ribbons API。对于混合定价/退款/支付/产品价格/配送请求，请加载此调度器以选择适当的 API。

配送

调度器——将配送设置请求（费率、地区、自提、免费配送、修复覆盖范围、优化费率）路由至合适的叶级方案。Shipping Options + Delivery Profiles API 没有公开文档页面；ecom-shipping-api.md 是权威的内联参考文档。

内部技能（由上述调度器/协调器自动加载——不要直接使用）

#### 定价与促销叶节点（由定价分发器或策略编排器加载） - [定价：创建优惠券](references/ecommerce/pricing-promotions/ecom-pricing-create-coupon.md) - [定价：创建折扣规则](references/ecommerce/pricing-promotions/ecom-pricing-create-discount-rule.md) - [定价：折扣未生效](references/ecommerce/pricing-promotions/ecom-pricing-troubleshoot-not-applying.md) - 目标：[提高 AOV](references/ecommerce/pricing-promotions/ecom-pricing-goal-increase-aov.md)、[清理库存](references/ecommerce/pricing-promotions/ecom-pricing-goal-clear-inventory.md)、[季节性营收](references/ecommerce/pricing-promotions/ecom-pricing-goal-seasonal-revenue.md)、[推动交叉销售](references/ecommerce/pricing-promotions/ecom-pricing-goal-drive-cross-sells.md) - 流程：[提升追加销售](references/ecommerce/pricing-promotions/ecom-pricing-flow-upsell-boost.md)、[捆绑优惠](references/ecommerce/pricing-promotions/ecom-pricing-flow-bundle-and-save.md)、[库存促销](references/ecommerce/pricing-promotions/ecom-pricing-flow-stock-mover.md)、[季节性促销](references/ecommerce/pricing-promotions/ecom-pricing-flow-seasonal-promotion.md)

礼品卡叶节点（策略编排器激活 GIFT_CARDS 域时加载）

• 目标：销售礼品卡 — 现有产品检查（每个网站一个）、资格条件、根据 AOV / 商品目录价格确定面额、默认不设置到期日的政策，以及与 Create Gift Card Product 的映射

配送叶节点（由配送分发器加载）

• 设置费率
• 设置区域
• 设置自提 / 本地配送
• 添加免费配送
• 优化费率
• 修复覆盖范围缺口
• API 参考 — Shipping Options + Delivery Profiles 的内嵌规范

跨领域跟踪

• API：推荐跟踪 — 生成任何推荐之前加载；持久化 PROPOSED 状态，并跟踪 MarkExecuting → MarkDone/MarkFailed。

eCommerce 功能（订单、弃置的结账、礼品卡、配送、税费、结账设置）的控制面板链接位于 商店控制面板导航。

---

捐赠

创建和更新捐赠活动

创建、查看、更新和归档 Wix Donations 活动，包括建议金额和影响说明、自定义限额、捐赠频率、目标、捐赠者备注、手续费承担方式和图片。

---

活动

使用 Wix Events API 创建活动

“使用 Wix Events V3 API 创建活动——包括单次或定期活动、RSVP、售票活动、免注册活动或带外部注册的活动；涵盖日期和时间、场地或线上地点、宾客人数上限、说明和票档。介绍准确的字段格式以及 API 容易引起误解的验证消息。适用于用户想要创建或设置活动、仅供了解信息的活动或重复举办的活动——包括在指定日期于场地或线上举办的每周工作坊、课程或聚会系列；Bookings 课程或培训则按场次预约。”

管理 Wix Events — 发布、取消、克隆和计数

"使用 Wix Events V3 API 操作已存在的 Wix 活动，包括查找、更新（日期、场地、详情、页面设置）、控制注册（关闭、重新开放、免费注册、外部注册、仅限会员、人数限制）、在 RSVP 和售票模式之间切换（创建新活动前请先询问）、发布、取消、删除、克隆和计数，也包括定期活动的单次场次。用于关闭注册、调整活动时间或取消活动，或更改访客的注册方式。"

管理活动门票

"使用 Ticket Definitions V3 API 管理售票活动的门票类型，包括添加、编辑、调整价格、隐藏、重新排序和删除门票，安排或结束门票销售，以及更改门票币种。用于用户希望为现有活动添加早鸟票、VIP 票、儿童票或捐赠票，更改门票价格或数量，或设置门票停售时间的情况。"

管理活动访客

"管理注册 Wix 活动的人员——包括 RSVP 活动中的 RSVP，以及售票活动中的订单、门票和持票人：列出并统计访客、添加或移除访客、更改 RSVP、为访客签到，以及将订单标记为已付款。用于用户询问谁会参加或有多少人已注册，或希望添加、移除访客或为访客签到的情况。说明 API 无法执行的操作，例如退款和重新发送电子邮件。"

活动控制面板导航

"构建指向 manage.wix.com 上 Wix Events 控制面板页面的直接链接，包括已发布和草稿活动列表、新建活动、类别、员工、定期系列的场次，以及单个活动的页面：概览、编辑、门票、访客（RSVP 或售票）、订单、日程、注册设置和表单，以及政策。将每个 Events 实体与其读取 API 配对，以便获取实体并返回“在控制面板中查看”的链接。用于用户询问 Wix 控制面板中的某项内容在哪里、需要控制面板页面的直接链接，或需要将控制面板 URL 与 API 操作结果一并提供的情况。"

---

表单

创建表单

"使用 Form Schemas v4 创建访客可填写的 Wix 表单，包括联系或咨询表单、报名或候补名单、申请表、调查问卷、报价请求，以及提交后会创建联系人的表单。提供完整的创建请求，以及 Wix 支持的所有类型字段表，包括下拉菜单、选项、文件上传、评分、地址、付款，以及那些会导致表单为空或不可见的隐蔽问题。若要更改已存在的表单，请使用 Update Form。"

更新表单

"使用 Form Schemas v4 PATCH 更改已存在的 Wix 表单——例如向表单添加字段、添加下拉菜单、将字段设为必填或选填、重命名标签、重新排序问题或停用问题。涵盖读取表单以获取其 revision（以及必需的 namespace 查询参数）、PATCH 所需的完整表单请求正文、会静默软删除任何未包含字段的整体 formFields 替换操作、原位更改字段的组件类型、停用已有提交记录的字段，以及用于确认存储内容的回读操作。表单已存在且用户的请求会改变表单收集的内容时，请使用此项；尚无表单时，请使用 Create Form。"

读取表单和提交内容

"读取网站的 Wix 表单及访客提交的内容——我有哪些表单、按名称查找表单、显示最新提交内容、谁填写了我的联系表单、上周收到了多少份提交、某位联系人的提交内容、未读提交内容。涵盖如何查找表单的命名空间，而不是猜测它是什么；每次读取时命名空间应放在哪里；Form Schemas 和 Form Submissions 端点（以及那些看起来相似、但会返回 404 的 URL）；默认列表中隐藏的表单；可用于筛选和排序的有限提交字段列表；日期范围；游标分页；每个表单的提交总数；以及按字段读取答案。此操作为只读；修改表单请使用 Update Form，创建表单请使用 Create Form。"

表单控制台导航

"为 manage.wix.com 上的 Wix 表单控制台页面生成直接链接。这些路径无法猜测，也未出现在任何 API 参考文档中，因此请在此查找：在 https://manage.wix.com/dashboard/{metaSiteId}/ 下，表单列表路径为 wix-forms，表单构建器路径为 wix-forms/form/{formId}，该表单的提交内容路径为 wix-forms/form/{formId}/submissions——没有适用于整个网站的提交内容页面，而且 contacts/forms、forms、form-builder 或 wix-forms-and-payments（旧版应用）下都没有相关内容。还包括独立表单，以及每个 Forms 实体对应的控制台链接；读取表单和提交内容请使用 Read Forms and Submissions。"

---

收款

创建付款链接

创建付款链接，无需结账流程即可收款。涵盖商店商品（目录商品）、自定义行项目、变体、到期日期，以及通过电子邮件发送链接。

如何设置 Wix Payments

将 Wix Payments 配置为支付提供商。涵盖资格检查、企业验证、银行账户设置，以及支付方式配置（银行卡、PayPal、Apple Pay）。

预订付款链接

使用 Payment Links API 为未付款的预订创建付款链接。将预订 ID 与付款请求关联，并妥善处理重定向。

收款控制台导航

"为 manage.wix.com 上的 Wix 付款和发票控制台页面生成直接链接——付款链接、发票（列表、创建、设置）、定期发票，以及收款设置页面。将每种主要收款实体与其读取 API 配对，以便获取实体并返回一个“在控制台中查看”的链接。当用户询问某项内容在 Wix 控制台中的位置、想要控制台页面的直接链接，或需要将控制台 URL 随 API 操作结果一并提供时，请使用此内容。"

Google Ads

路由 — 网站的 Google 付费广告系列（Smart 和 Performance Max）。 所有流程都需要 Google Ads 账户，该账户通过设置指南创建一次即可。预算以微单位计（1,000,000 = 1 个货币单位）。REST 基础 URL：https://www.wixapis.com/_serverless/pa-google/v1。

• 首次设置 /“连接 Google Ads”/ ACCOUNT_NOT_FOUND → 安装并创建账户（请在执行其他操作之前完成此步骤）。
• 建议关键词 / 地理位置 / 预算 / 广告文案 / 图片 → 获取 AI 广告系列建议。
• 改进现有广告系列 / 查看下一步要修复的问题 / Campaign Success Guide / 标记或重新打开建议 → 管理 Campaign Success Guide。
• 创建多渠道 / 潜在客户开发 / Shopping 广告系列 → 创建 Performance Max 广告系列。
• 暂停 / 恢复 / 启动 / 更新预算 / 删除 / 历史记录 → 管理广告系列生命周期。
• 效果、转化、搜索字词、每种产品 / 每个素材资源的指标 → 查询广告系列效果分析。
• 广告支出、费用、即将扣款、信用余额 → 查看账单和付款详情。

安装 Google Ads 并创建账户

"在 Wix 网站上投放 Google 付费广告的一次性设置：安装 Wix Google Ads 应用，然后创建 Google Ads 账户；每次广告系列、建议和分析调用都依赖此账户。涵盖检查账户是否已存在、选择货币、选择性地附加促销优惠（信用额度优惠）、关联 Google Merchant Center 账户，以及删除账户。当用户想要“设置 Google Ads”“连接 Google Ads”“开始在 Google 上投放广告”“创建 Google Ads 账户”，或在创建广告系列前遇到 ACCOUNT_NOT_FOUND / 未安装应用错误时使用。Google Ads REST API，基础 URL 为 https://www.wixapis.com/_serverless/pa-google/v1。"

获取 Google Ads 的 AI 广告系列建议

"Wix 网站上的 Google Ads Suggestions API 参考：帮助创建有效广告系列的 AI / Google 生成输入，包括关键词主题（根据 URL 或自动补全生成）、地理位置定位选项、带有预估点击次数的低 / 建议 / 高每日预算档位、PMAX 预算建议、文本素材（标题 / 描述）、AI 图片素材（自动上传到 Wix Media）、搜索主题、促销优惠，以及根据广告系列简介生成的完整 AI 广告系列配置。当用户询问“为我的广告建议关键词”“应该使用什么预算”“应该定位到哪里”“生成广告文案 / 标题”“生成广告图片”“建议一个完整广告系列”，或创建广告系列的流程需要建议值时使用。REST 基础 URL 为 https://www.wixapis.com/_serverless/pa-google/v1。"

创建并启动 Performance Max 广告系列

"为 Wix 网站创建并启动 Google Ads Performance Max（PMAX）广告系列——这是一种以目标为导向的广告系列，通过包含标题、说明、图片和（针对 PMAX Leads）搜索主题信号的素材组，在所有 Google 渠道（搜索、展示广告、YouTube、Gmail、Discover、Maps）上投放。涵盖生成 AI 文本和图片素材、生成搜索主题、获取 Google 预算建议、使用所需的最低素材数量组建素材组、选择 PERFORMANCE_MAX、PERFORMANCE_MAX_LEADS（潜在客户：电话／表单目标、否定关键字、28 天学习期）或零售／购物广告系列（Merchant Center 商品 Feed）、以 PAUSED 状态创建并启动。适用于“创建 Performance Max 广告系列”“PMAX”“在所有 Google 渠道投放广告”“Google 潜在客户开发广告系列”或“Google 购物广告”等请求。需要已有 Google Ads 账号。REST 基础 URL：https://www.wixapis.com/_serverless/pa-google/v1。"

管理广告系列生命周期

"管理 Wix 网站上的现有 Google Ads 广告系列：列出／获取、启动（首次启用）与恢复（暂停后重新启用）、暂停正在运行的广告系列——可选择设置计划自动恢复日期——更新名称／预算／定向、更改每日预算、永久删除，以及查看状态历史记录／更改日志。适用于用户想要“暂停我的 Google 广告”“恢复我的广告系列”“停止广告系列”“更改我的每日预算”“重命名广告系列”“删除此广告系列”“列出我的 Google Ads 广告系列”或“为什么我的广告系列状态发生变化”等请求。需要已有 Google Ads 账号和广告系列。REST 基础 URL：https://www.wixapis.com/_serverless/pa-google/v1。"

管理广告系列成功指南

"适用于现有 Wix Google Ads Performance Max Leads 广告系列的成功指南。创建受支持的广告系列后即可使用，即使广告系列仍在学习或尚无指标；用户询问如何改进广告系列、接下来要修复什么、查看指南，或标记／重新打开建议时也可使用。涵盖广告系列和网站选择、按优先级排列的可执行建议、去重且按目标位置定制的 Editor 和 Google Ads 导航、经批准后提供受支持操作、Merchant Center 和 Business Profile 连接后续操作，以及建议状态跟踪。"

查询广告系列效果分析

"读取 Wix 网站上 Google Ads 广告系列的效果分析：每日效果指标（展示次数、点击次数、点击率、费用、潜在客户、电话），可选的上一时期对比和趋势；来自 Wix Analytics 的转化指标（订单、收入、潜在客户、每条潜在客户费用、广告支出回报率）；触发广告系列广告的搜索词；零售广告系列中各商品的购物效果；以及 PMAX Leads 各素材（标题、说明、图片）的效果。说明何时使用 campaignResourceName 与 Wix campaignId、dateRange 的结构、字段枚举、排序和分页。适用于用户询问“我的广告系列效果如何”“显示广告效果”“哪些搜索词触发了我的广告”“哪些商品／素材效果最好”“广告系列 ROI／ROAS”或“我的 Google 广告带来了哪些转化”等请求。REST 基础 URL：https://www.wixapis.com/_serverless/pa-google/v1。"

检索 Google Ads 账单和付款详情

"检索 Wix 站点的 Google Ads 账户的账单和付款详情：当前账单周期的广告支出（用量）、Wix 服务费、总费用、任何促销优惠券抵扣、账单周期日期，以及账户的信用余额（正数 = 可用额度，负数 = 尚未扣款的未结欠款）。还会说明如何从账户对象中读取当前预算与剩余预算。适用于用户询问“我在 Google Ads 上花了多少钱”“我下一笔 Google Ads 费用是多少”“显示我的广告账单”“我还剩广告额度吗”“为什么向我收费”或“即将扣款的 Google Ads 费用”。需要已有的 Google Ads 账户。REST 基础 URL 为 https://www.wixapis.com/_serverless/pa-google/v1。"

Google Ads 控制面板导航

"生成 Wix Google Ads 控制面板页面的直接链接，页面位于 manage.wix.com，用于管理通过 Google Ads API 配方创建的广告系列。适用于用户询问 Wix 控制面板中的某项内容位于何处、需要控制面板页面的直接链接，或需要在 API 操作结果中附上控制面板 URL。"

---

Google 商家资料

路由 — 商家在 Google 搜索和地图中的展示方式。 Google 连接是所有基于 Google 的地点操作的前提：先检查连接，并将“连接 / 重新连接 / 断开 Google”请求路由到连接配方。

将 Wix 站点连接到 Google 商家资料

将经过身份验证的 Wix 站点连接到 Google 商家资料账户，检查现有连接是否仍可使用，恢复凭据已丢失的连接，切换到其他 Google 账户，或断开连接。站点所有者通过一次性连接 URL 在自己的浏览器中授权；Agent 不会代其完成 Google 授权。重新连接前会发出警告，因为此操作会永久移除站点导入的地点。

管理 Wix 站点的 Google 商家资料地点

将 Google 商家资料地点导入经过身份验证的 Wix 站点；使用或不使用 Google 实时数据列出和查询地点；通过适用于各自操作的正确方法更新 Wix 端和 Google 端的详情；创建新的 Google 商家信息；检查资料是否已在 Google 上实际发布；以及从 Wix 中移除地点或删除其 Google 商家信息。会先检查站点的 Google 连接，并将连接缺失报告为设置步骤；在执行破坏性操作或会显示在 Google 上的写入操作前发出警告，并遵守 Google 的共享速率预算。

---

营销

创建并发布社交媒体帖子（含 AI 生成）

"端到端流程，用于创建社交媒体帖子（可选择使用 AI 生成），并通过 Wix Publisher API 将其发布或安排到站点已连接的渠道（Instagram、Facebook、LinkedIn、X/Twitter、TikTok、Pinterest、YouTube、Google 商家资料）。可以根据自由文本创意或站点自身的资源（产品、博客文章、活动、预订、优惠券、分类）生成各渠道的完整帖子，生成标题/帖子文案建议，并使用 AI 编辑现有图片。先与您敲定帖子内容，然后确认渠道已连接、检查高级版额度、创建草稿，最后立即发布或安排发布时间。适用于“创建帖子”“根据我的产品/创意生成帖子”“撰写标题”“标题创意/建议”“使用 AI 编辑帖子图片”“发布到 Instagram/Facebook/TikTok”“连接我的 Instagram/Pinterest/LinkedIn”或“安排帖子”。"

生成营销计划并安排帖子发布

"使用 Wix Marketing Plan API，为网站生成 AI 驱动的社交媒体营销计划，并安排生成的帖子发布，涵盖端到端流程。建议在首次生成前配置营销设置（目标、语气、发布频率、内容支柱），然后异步生成计划，并轮询直至准备就绪，最后安排 DRAFT 帖子发布。还包括为其他活动生成帖子。适用于用户提出“生成营销计划”“创建社交媒体计划／日历”或“安排计划中的帖子”等请求。"

营销控制面板导航

"为 manage.wix.com 上的 Wix 营销控制面板页面构建直达链接，包括社交帖子中心（涵盖已连接渠道中的草稿、已安排和已发布帖子）、帖子设计模板、已保存的设计，以及电子邮件营销页面（营销活动列表、营销活动模板、营销活动分析）。将每个主要营销实体（社交帖子项目、已连接的社交账号、营销计划帖子、电子邮件营销活动）与其读取 API 配对，以便获取实体并返回“在控制面板中查看”链接。当用户询问某项内容在 Wix 控制面板中的位置、需要控制面板页面的直达链接，或需要将控制面板 URL 随 API 操作结果一并提供时使用。"

---

媒体

将媒体上传到 Wix

使用 Import File API 将图片和文件上传到 Wix Media Manager。涵盖从外部 URL 导入、检查文件状态，以及在其他 API 中使用返回的 wixstatic.com URL。

使用 AI 生成图片

使用 Wix AI API（Runware）根据文本提示词生成图片。返回的短期有效 URL 必须经过导入才能保留——导入工作由“将媒体上传到 Wix”负责，此处会将流程交接给它。涵盖如何选择模型及其成本／延迟／内容过滤方面的权衡、支持的输出尺寸、各模型的批量处理限制、每次调用消耗的 AI 点数，以及为什么内容拒绝会以成功响应但不含图片的形式返回。

---

定价方案

创建和更新定价方案

使用 Plans API 创建订阅和一次性付款方案。涵盖定价模式（周期性、一次性、免费）、试用期、权益配置和方案可见性。

定价方案与预订集成

使用 Benefit Programs API 将定价方案关联到 Bookings 服务。可创建授予预订权限的套餐优惠和会员资格。

定价方案控制面板导航

"为 manage.wix.com 上的 Wix 定价方案控制面板页面构建直达链接，包括方案列表、创建方案、编辑方案、记录手动订单和设置。将每个主要定价方案实体（方案、订单）与其读取 API 配对，以便获取实体并返回“在控制面板中查看”链接。当用户询问某项内容在 Wix 控制面板中的位置、需要控制面板页面的直达链接，或需要将控制面板 URL 随 API 操作结果一并提供时使用。"

---

餐厅

Wix Restaurants 设置

使用 Menus API 配置餐厅菜单、分区和项目。涵盖菜单结构（Menu → Section → Item）、项目修饰项／修饰项组的两步流程、定价、可用时间安排和订购设置。

餐厅仪表盘导航

“为 Wix Restaurants 仪表盘在 manage.wix.com 上的页面创建直达链接，包括菜单、菜单项、在线订单看板、在线订餐履约设置（自取、配送、堂食）、预约列表、平面图和预约体验设置。将每个主要 Restaurants 实体（菜单、分区、项目、订单、预约）与其读取 API 配对，这样你就可以获取实体，并返回一个‘在仪表盘中查看’链接。用户询问某项内容在 Wix 仪表盘的哪里、想要某个仪表盘页面的直达链接，或者你需要在 API 操作结果中附上仪表盘 URL 时使用。”

---

富内容

路由规则（请先阅读）。 对于任何要求手动编写、输出或返回 Blog、Stores、Events 或 CMS 的 Ricos / richContent JSON（nodes 树）的请求，在使用 API 架构搜索、转换/验证 API 或记忆内容之前，请使用可用的完整文档读取功能，检索并阅读权威指南 编写 Ricos 富内容。即使用户只要求 JSON，也适用此规则。

Ricos 转换器服务

使用 Ricos Documents API，在 Ricos 文档与 HTML/Markdown/纯文本之间验证并转换内容。涵盖插件配置、双向格式转换和文档验证。

编写 Ricos 富内容

权威指南，介绍如何手动编写有效的 Ricos 富内容 JSON（即 richContent/nodes 树），该结构用于 Wix Blog 文章、Stores 商品描述、Events 和 CMS 富文本字段。用户要求创建、输出或返回 Ricos、richContent 或 nodes 树 JSON 时使用；在搜索 API 架构或构造 JSON 之前，先检索并阅读完整指南。涵盖段落、标题、列表、引用块、分隔线、表格、代码块、图片、按钮、音频、视频、图库、可折叠列表、HTML 嵌入、行内装饰和嵌套规则。

---

站点属性

配方：通过 Site Properties API 更改站点的区域属性（货币、时区、语言）

“使用 Site Properties API 更新站点级付款货币（商店结算货币），包括必需的请求正文格式和字段掩码。介绍站点时区和主要语言；字段掩码用于指定顶层属性。”

站点设置仪表盘导航

“为 manage.wix.com 上的站点设置仪表盘页面创建直达链接，包括设置中心、网站设置以及语言和区域。将站点属性与 Site Properties 读取 API 配对。用户询问某项内容在 Wix 仪表盘的哪里、想要某个仪表盘页面的直达链接，或者你需要在 API 操作结果中附上仪表盘 URL 时使用。”

---

协作者

管理站点协作者

管理有权作为协作者（贡献者）访问 Wix 站点的人员，包括查找站点当前的协作者、邀请他人、移除协作者，以及重新发送或撤销待处理的协作者邀请。用户想授予他人站点访问权限、撤销访问权限，或跟进尚未接受的邀请时使用。

---

站点

从模板创建站点

使用账户级 API 从模板创建新的 Wix 站点。涵盖模板搜索、站点创建和发布。不适用于无头站点。

创建无头网站

创建 Wix 无头网站：在用户的 Wix 账户中创建一个网站，其前端是上传到 Wix 托管服务的文件，后端则通过 API 连接 Wix 商业后台。使用 Upload a Website or HTML Files 创建网站并发布页面，然后从冷启动开始，通过 Wix Headless 工具包将 Wix Business Solution（商店、博客、预约等）集成到网站中。

管理 OAuth 应用

为 Wix 无头网站创建、读取、更新和查询 OAuth 应用。每个 OAuth 应用的 id 就是前端用来生成匿名访客令牌并调用 Wix API 的 client_id。

查询网站

列出、计数和查找 Wix 账户中的网站。涵盖无头网站的命名空间筛选条件、枚举前计数、游标分页，以及按名称解析网站。

读取账户或网站上下文

通过一次调用，探查 Wix 网站或账户的完整上下文——已安装应用的显示名称、区域设置、货币、时区和状态。账户令牌 + siteId 用于指定一个网站；仅账户令牌最多返回 10 个；仅网站范围令牌则返回其作用范围内的网站。

向 Wix 发送反馈

将用户对使用 Wix 开发的反馈——包括 API、文档、配方、Wix MCP 和工具——转达给 Wix，并注明已通过身份验证的用户。涵盖何时提供此选项、如何撰写 Wix 能据此采取行动的消息，以及发送消息的调用。用户要求向 Wix 报告问题、对 Wix API 或流程感到沮丧，或配方流程未达到预期时使用。此工具不是支持渠道，也不适用于用户自己的网站内容。

网站导入

使用 Wix Site Import Agent，将现有商店或网站从其他平台（Shopify、WooCommerce、Magento 或任何 URL）迁移到 Wix——可以创建全新网站，也可以导入到用户现有的网站中；也可以在没有源网站的情况下，从 CSV/TSV 导出文件导入。用户想将商店/网站导入、迁移或克隆到 Wix，提到要从 Shopify/WooCommerce/Magento 迁出，或提供源商店 URL 并要求将其迁入 Wix 时，均使用此技能。涵盖开始导入、轮询进度、回答 Agent 在导入过程中提出的问题、处理部署/失败/身份验证过期状态，以及发送部署后的后续更改。

网站控制面板导航

“为 manage.wix.com 上账户级别的网站页面构建直接链接，包括‘我的网站’列表（账户中的所有网站）和每个网站自己的控制面板。将网站列表与 Query Sites 读取 API 配合使用。用户询问 Wix 控制面板中某项内容的位置、想要控制面板页面的直接链接，或你需要在 API 操作结果中附上控制面板 URL 时使用。”

上传网站或 HTML 文件

将 HTML、CSS、JavaScript 或静态构建内容发布为 Wix 无头网站；检查已部署的文件，并在同一网站和 URL 上编辑。涵盖文件和 ZIP 上传、选择性添加、替换和删除（同时保留其他文件）、完整替换网站、经过身份验证和匿名发布、验证，以及连接 Wix 商业后台；Wix Astro 构建会作为服务端渲染网站发布，而不是直接上传。适用于用户提供的文件或你为用户创建的页面。不适用于通过 URL 或 CSV 从其他平台迁移现有网站（使用 Site Import）、在编辑器构建的 Wix 网站中嵌入代码，或将资源上传到 Media Manager。

---

商店

更改商店货币

通过 Site Properties 更改商店的支付货币，并说明目录响应中的货币更新可能存在延迟。

将商店页面添加到网站

在安装了 Stores 应用时，为网站添加缺失的结账和购物车页面。用于迁移或设置问题导致商店页面缺失的情况。

创建产品（Catalog V1）

使用 Catalog V1 Products API 创建产品。当网站的目录版本为 CATALOG_V1 时，使用此操作指南。涵盖简单产品创建、带选项的产品，以及 V1 与 V3 请求结构的主要差异。

创建产品（Catalog V3）

这是每个 Wix Stores Catalog V3 创建产品请求都必须首先使用的操作指南。在执行任何变更之前，必须明确提供每个产品的名称和价格；未提供价格绝不代表价格为 0。如果未指定产品，请提供图片上传和文字描述两种方式，然后停止。如果缺少名称或价格，请询问用户或提供建议，然后停止。两者都已提供时，根据提供的详细信息创建产品，无需强制补充可选信息。涵盖单个/批量创建、库存、实体/数字产品、图片、选项、变体、SKU 和验证。

查找产品（查询与搜索，Catalog V3）

使用 Wix Store 的 Catalog V3 Search Products 和 Query Products 端点查找、搜索、查询和列出产品。说明各端点的适用场景、正确的字段枚举值、筛选（包括按价格筛选）、排序和分页。

查询产品（Catalog V1）

使用 Wix Store 的 Catalog V1 Query Products 端点查询和列出产品。当网站的目录版本为 CATALOG_V1 时，使用此操作指南。涵盖基本查询、筛选、排序和分页。

更新产品预购设置（Catalog V3）

使用 V3 Inventory API 管理产品变体的预购设置。涵盖启用/禁用预购、设置消息、配置限制，以及处理 trackQuantity 要求。

更新带选项的产品（Catalog V3）

现有 Catalog V3 产品更新请从这里开始，包括因 ITEM_NOT_FOUND_IN_CATALOG 而无法加入购物车的数字产品。通过一个流程完成名称查找、Get Product 和 PATCH，还可导入用户提供的 PDF 并将其附加到现有变体。涵盖选项、变体价格和 SKU、以网站重量单位表示的变体运输重量、产品可见性（通过 visible 隐藏/取消隐藏，绝不删除）、保留 Rich Content 的描述编辑，以及基于修订版本的更新。仅当此流程未涵盖某个字段或操作时，才阅读其他操作指南。

Stores 控制面板导航

“为 manage.wix.com 上的 Wix Stores 和 eCommerce 控制面板页面构建直接链接，包括产品列表、特定产品的编辑页面、类别、库存、订单列表、特定订单、弃购、礼品卡、配送和税费设置。将每个主要 Stores/eCommerce 实体与其读取 API 配对，以便获取实体并返回一个‘在控制面板中查看’链接。当用户询问 Wix 控制面板中的某项内容位置、需要控制面板页面的直接链接，或需要将控制面板 URL 随 API 操作结果一并提供时使用。”

自动化

构建和管理 Wix 自动化

使用公开的 Wix Automations API，通过应用操作、触发器筛选条件、条件、延迟、变量、分支和计划，创建、更新、启用或停用 Wix Automations，并检查其当前状态。

内部技能（由「构建和管理 Wix 自动化」按需加载——请勿直接使用）

• Automations API 目录 发现特定站点的触发器和操作，对公开的 Automation API 调用进行身份验证，并选择用于验证、持久化或目录查找的 API。

• 自动化图和数据模型 构建可在编辑器中编辑的自动化图，并确保节点关系、命名空间和祖先数据访问有效。

• 自动化触发器配置 使用站点目录选择和配置自动化触发器、触发器筛选条件及事件负载架构。

• 自动化操作配置 根据输入架构配置应用定义的自动化操作，并保留受支持的现有操作映射。

• 自动化映射表达式 编写与编辑器兼容的自动化映射表达式、字面值和数据引用。

• 自动化条件 配置可视化条件和代码条件，同时保留布尔意图、比较边界和编辑器可编辑性。

• 自动化延迟、变量和分支 配置延迟、速率限制、变量和并行分支步骤，并保留受支持的现有步骤元数据。

• 自动化架构和计划安排 配置动态架构和计划任务型自动化触发器，并确保时区和日历行为正确。

• 自动化验证和持久化 验证自动化配置、检查编辑器兼容性、持久化更改并验证保存结果。

• 自动化启用状态 检查或更改启用状态，并处理锁定检查、修订版本和回读；停用时无需先修复无关问题。