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

​
前提条件

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

​
设置 Webhook

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

打开 Webhooks 集成

从 Integrations 中选择 Add Integration，然后找到 Webhooks 卡片并选择 Setup。
2

选择要发送的数据

选择以下之一：
  • Scan Analytics Data — 您二维码的扫码事件。
  • Event Tracking Data — 自定义的事件跟踪数据。
  • Lead List Data — 表单或 Lead List 的提交内容。
3

选择数据来源（仅限 Lead List Data）

如果您选择了 Lead List Data，还需选择提交内容应来自哪个 Lead List 或 Form-builder 表单。
4

输入接口网址

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

创建该 webhook

选择 Create webhook。一旦匹配的事件发生，Scanova 就会立即开始向您配置的每个网址发送 POST 请求。
Scanova 会实时向您的接口发送事件负载。您的接口应返回 2xx 响应以确认送达——非 2xx 响应不会自动触发重试。

​
编辑现有的 webhook

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

​
数据流向

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

​
相关内容

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