> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier

> 通过 Zapier 将 Scanova 连接到数千款应用。

Zapier 让您无需编写代码，即可将 Scanova 接入数千款其他应用——Google Sheets、Slack、HubSpot 等等。在 Scanova 这一侧，连接 Zapier 只需一步：生成一个作用域为 `zapier` 环境的 Management API 令牌，然后将其粘贴到您 Zapier 账户中的 Scanova 应用里。从此之后，Zap 的构建和管理完全在 Zapier 中进行。

<Note>
  此集成是一次**令牌握手**，而不是 Scanova 内部的可视化触发器/操作构建器。您认知中"Zapier 设置"的一切——选择触发器、操作和字段映射——都发生在 Zapier 的平台上，使用其发布的 Scanova 应用。Scanova 这一侧只负责签发和吊销该应用用于身份验证的令牌。
</Note>

## 前提条件

* 一个 Zapier 账户。
* 一个包含 Zapier 集成配额（`INTEGRATION_ZAPIER`）的 Scanova 套餐。如果您的令牌因配额错误被拒绝，请联系 [support@scanova.io](mailto:support@scanova.io)。

## 设置连接

<Steps>
  <Step title="打开 Zapier 集成">
    从 **Integrations** 中选择 **Add Integration**，然后找到 **Zapier** 卡片并选择 **Setup**。这会打开一个设置面板——Zapier 不需要多步骤向导，因为除了令牌本身之外，Scanova 这一侧没有其他需要配置的内容。
  </Step>

  <Step title="生成一个令牌">
    选择 **Generate token**。Scanova 会创建一个 `environment=zapier` 的 Management API 密钥，命名为 `zapier_<您的账户邮箱>`。该令牌只会显示一次——请立即使用掩码值旁的复制图标将其复制下来。之后没有办法再次查看它；如果您弄丢了它，请吊销它并生成一个新的。
  </Step>

  <Step title="在 Zapier 中连接 Scanova 应用">
    在您的 Zapier 账户中打开 **Scanova** 应用，并在提示进行身份验证时粘贴该令牌。
  </Step>

  <Step title="构建一个 Zap">
    使用 Scanova 触发器创建一个 Zap——例如一次新的扫码或一条新的潜在客户记录——然后连接目标应用（Sheets、Slack、HubSpot，或 Zapier 支持的其他任何应用）。
  </Step>

  <Step title="开启该 Zap">
    一旦该 Zap 被开启，Scanova 的事件就会自动流向您选择的目标应用。
  </Step>
</Steps>

<Warning>
  吊销令牌（设置面板中的 **Revoke token**）会立即禁用 Zapier 中基于该令牌配置的每一个触发器和操作——基于此连接构建的任何正在运行的 Zap 都会停止工作。
</Warning>

## 该令牌的实际工作原理

Zapier 集成完全建立在 Management API 之上——没有专门针对 Zapier 的后端。有关底层的请求/身份验证机制（主机、请求头格式，以及 `environment=zapier` 配额检查与其必需的 `User-Agent: zapier` 请求头之间如何配合），请参阅：

<Card title="Management API overview" icon="key" href="/zh/api-reference/management-api/overview">
  Management API 令牌如何进行身份验证，包括 `zapier` 环境的配额和 User-Agent 要求。
</Card>

## 数据流向

一旦某个 Zap 上线，Scanova 就会将触发事件（例如新的扫码或新的潜在客户）推送到 Zapier，由 Zapier 将其交给您在目标应用中配置的操作。回调到 Scanova 的 Zap（例如根据另一个应用的事件创建一个二维码）会使用同一个令牌调用常规的 Management API 数据接口。

## 相关内容

* [Management API overview](/zh/api-reference/management-api/overview) — `zapier` 环境令牌所对应的双主机身份验证架构。
* [Create an API token](/zh/api-reference/management-api/tokens/create) — 交给 Zapier 的 `environment=zapier` 密钥是如何生成的。
* [MCP overview](/zh/mcp/overview) — 另一个基于 Management API 密钥、拥有自己专属环境的集成。
