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

# HubSpot

> 与 HubSpot 同步潜在客户和联系人。

HubSpot 集成通过 OAuth 将您的 Scanova 账户连接到一个 HubSpot 门户，然后引导您完成一个向导，将某个表单或二维码的提交内容映射到某个 HubSpot CRM 对象——Contact、Company、Deal 或 Ticket——这样每次提交都会自动生成一条 HubSpot 记录。

## 前提条件

* 一个拥有为该门户授权新应用连接权限的 HubSpot 账户。
* 一个包含 HubSpot 集成的 Scanova 套餐。如果没有该权限，连接时会返回"Your plan does not include HubSpot integration"错误。
* 至少一个已设置好提交来源（自定义表单、反馈表单、RSVP、房产咨询或餐厅反馈）的 Form-builder 表单或二维码，因为该向导需要一个可供同步的数据来源。

## 设置连接

HubSpot 会打开为其自己的完整页面（而非侧边面板），因为该向导需要更多空间。

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

  <Step title="连接 HubSpot">
    选择 **Connect HubSpot**。您会被重定向到 HubSpot 以授权 Scanova，随后返回到该向导。授权成功后，一个绿色横幅会显示已连接的门户 ID。
  </Step>

  <Step title="选择要同步的内容">
    选择提交来源类型：**Forms**（任意 Form-builder 表单）、**Custom Form Component**、**Feedback Form (Feedback QR Code)**、**RSVP Form Component**、**Inquiry Form (Real Estate QR Code)**，或 **Feedback Form (Restaurant QR Code)**。
  </Step>

  <Step title="选择数据来源">
    根据所选的类型，搜索并选择应同步其提交内容的具体表单或二维码。
  </Step>

  <Step title="选择 HubSpot 操作">
    选择每次提交应创建的 HubSpot 对象：**Create Contact**、**Create Company**、**Create Deal**，或 **Create Ticket**。
  </Step>

  <Step title="映射字段">
    将您来源中的字段与 HubSpot 属性进行匹配。所选对象的 HubSpot 特色属性会预先列出；使用 **Add a field** 可从完整目录中映射其他属性。不兼容的映射会被内联阻止——例如，一个 HubSpot 数字属性不能映射到文本字段，一个日期属性也不能映射到非日期字段。

    <Note>
      向导未标记为无效、但实际上无法转换为该 HubSpot 属性类型的映射，会在同步时被静默丢弃，而不会导致错误——内联校验的存在正是为了在这种情况发生之前捕获它。
    </Note>
  </Step>

  <Step title="查看、测试并完成">
    为连接命名（之后会在 Active Connections 中用于识别它），查看映射摘要，并可选择使用 **Send test** 向 HubSpot 推送一条示例记录，确认送达后再选择 **Complete setup**。
  </Step>
</Steps>

## 管理连接

* **Disconnect**（在已连接的横幅中）会停止整个门户的同步——与之关联的每个 HubSpot 连接都会停止发送数据。
* 从 **Active Connections** 编辑一个现有连接会重新打开同一个预填充的 5 步向导。

## 数据流向

每当配置好的表单或二维码收到一条新的提交内容时，Scanova 都会将映射的字段值作为一条新记录发送到 HubSpot，记录类型为所选的对象类型（Contact、Company、Deal 或 Ticket），并存入已连接的门户中。

## 相关内容

* [Slack](/zh/integrations/slack) — 另一个通过 OAuth 连接的集成，拥有自己的命名规则构建器。
* [Webhooks](/zh/integrations/webhooks) — 如果您需要将提交数据发送到 HubSpot 未覆盖的地方，这是一种通用的替代方案。
* [Form management](/zh/api-reference/management-api/forms/list) — 该向导同步数据所依赖的 Forms 来源背后的 API。
* [Lead list management](/zh/api-reference/management-api/leads/list) — 传统 Lead List 同步来源背后的 API。