> ## 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.

# Webhooks

> 将实时事件数据发送到您自己的接口。

Webhooks 是将 Scanova 数据接入您自己系统的通用方式：选择一个数据流，向 Scanova 提供一个接口网址，Scanova 就会在事件发生时实时将该数据以 POST 请求发送到您的服务器——中间不需要任何第三方应用。

## 前提条件

* 一个接受 `POST` 请求、并在确认送达时返回 2xx 状态码的 HTTPS（或 HTTP）接口。
* 如果您计划发送潜在客户数据：至少需要一个已设置好作为数据来源的 Lead List 或 Form-builder 表单。

## 设置 Webhook

Webhooks 会打开为其自己的完整页面（而非侧边面板）。

<Steps>
  <Step title="打开 Webhooks 集成">
    从 **Integrations** 中选择 **Add Integration**，然后找到 **Webhooks** 卡片并选择 **Setup**。
  </Step>

  <Step title="选择要发送的数据">
    选择以下之一：

    * **Scan Analytics Data** — 您二维码的扫码事件。
    * **Event Tracking Data** — 自定义的事件跟踪数据。
    * **Lead List Data** — 表单或 Lead List 的提交内容。
  </Step>

  <Step title="选择数据来源（仅限 Lead List Data）">
    如果您选择了 **Lead List Data**，还需选择提交内容应来自哪个 Lead List 或 Form-builder 表单。
  </Step>

  <Step title="输入接口网址">
    输入 Scanova 应发送 POST 请求的完整 `https://`（或 `http://`）网址。选择 **Add another URL** 可将相同的负载最多发送到 5 个接口。
  </Step>

  <Step title="创建该 webhook">
    选择 **Create webhook**。一旦匹配的事件发生，Scanova 就会立即开始向您配置的每个网址发送 POST 请求。
  </Step>
</Steps>

<Note>
  Scanova 会实时向您的接口发送事件负载。您的接口应返回 2xx 响应以确认送达——非 2xx 响应不会自动触发重试。
</Note>

## 编辑现有的 webhook

从 **Active Connections** 打开一个 webhook 会重新打开同一个预填充的表单。由于读取模型每个连接只暴露一个解析后的网址，即使原始设置中包含多个网址，编辑时也只会显示单个网址字段。

## 数据流向

根据所选的数据类型，Scanova 会将扫码事件、事件跟踪事件，或潜在客户/表单提交内容作为 JSON 负载发送到每个已配置的接口网址，在底层事件发生时立即发送。

## 相关内容

* [Slack](/zh/integrations/slack) — 一个类似的事件驱动集成，专门作用于 Slack 频道。
* [Zapier](/zh/integrations/zapier) — 通过 Zapier 的应用目录而非原始网址来路由同类事件数据。
* [Google Analytics (GA4)](/zh/integrations/google-analytics) — 另一个用于扫码/事件数据的服务端数据输出集成。
* [Management API overview](/zh/api-reference/management-api/overview) — 按您自己的节奏拉取相同的数据，而非接收推送事件。