---
title: "连接 HubSpot"
description: "从 Scratcher 登录 HubSpot，并使用你选择的属性创建或更新联系人，分步说明。"
url: https://scratcher.io/zh/help/integrations/hubspot
language: zh-Hans
---

1. [帮助中心](https://scratcher.io/zh/help)
2. [集成](https://scratcher.io/zh/help/integrations)
3. 连接 HubSpot

# 连接 HubSpot

从 Scratcher 登录 HubSpot，并使用你选择的属性创建或更新联系人，分步说明。

通过 HubSpot 集成，每位注册用户都会在 HubSpot 中被创建为联系人。如果已存在电子邮件地址相同的联系人，则会更新该联系人。

## 准备工作

- 一个 HubSpot 账户。所有 HubSpot 版本均可使用，包括免费 CRM。
- 一位有权连接应用的 HubSpot 用户。在 HubSpot 中，这是 **Super Admin**，或拥有 **App Marketplace** 访问权限的用户。
- 一个包含所有原生集成的 Scratcher 套餐。如果按钮被锁定，请参阅[你的试用、套餐以及试用结束后的情况](https://scratcher.io/zh/help/billing/trial-and-plans)。

你不需要 API 密钥。只需登录 HubSpot 并批准访问即可。

## 第 1 步：连接 HubSpot

1. 在 Scratcher 中，前往**设置** > **集成**，然后点击 **HubSpot**。
2. 点击**安装集成**。你会被转到 HubSpot。
3. 登录 HubSpot。如果你有多个 HubSpot 账户，请选择要连接的账户。
4. HubSpot 会显示 Scratcher 请求的权限。点击连接该应用。
5. 你会返回 Scratcher，HubSpot 即安装完成。

## Scratcher 请求的访问权限

HubSpot 会要求你批准以下权限：

- 读取和写入联系人（`crm.objects.contacts.read` 和 `crm.objects.contacts.write`）：用于按电子邮件查找联系人、创建新联系人和更新现有联系人。
- 读取和写入联系人属性（`crm.schemas.contacts.read` 和 `crm.schemas.contacts.write`）：用于在字段映射中显示你的联系人属性。

Scratcher 只处理联系人。它不会读取或更改交易、公司、电子邮件或任何其他内容。

## 第 2 步：在活动中启用

1. 在编辑器中，前往**连接** > **集成** > **HubSpot**，然后点击**激活**。
2. 如果你连接了多个 HubSpot 账户，请在**选择账户**下选择要使用的账户。
3. 在**字段映射**下，点击**添加字段映射**，将你的字段与 HubSpot 联系人属性对应起来。例如将“潜在客户 - 名字”对应到 **First Name**，将“潜在客户 - 姓氏”对应到 **Last Name**。
4. 在\*\*按许可筛选（可选）\*\*下，选择你的营销同意复选框，这样只会发送表示同意的用户。
5. 点击**保存**，然后点击**测试**发送一个测试联系人。

> 须知：HubSpot 在此处没有可供选择的列表，因此你一点击**激活**，Scratcher 就会开始发送。如果活动已有潜在客户，请尽快设置映射和筛选，或在活动上线之前激活 HubSpot。

## 字段映射

- **目标字段**列表显示你的 HubSpot 联系人属性，包括你自己的自定义属性。HubSpot 的内部属性不会显示。
- 电子邮件地址和电话号码始终会发送到 HubSpot 属性 **Email** 和 **Phone Number**。其他所有内容（包括名字和姓氏）都需要你自行映射。
- 复选框属性接收是或否，日期属性接收日期，因此请将同意的**已接受**字段映射到复选框属性，将日期映射到日期属性。
- 要标记联系人的来源，请将**使用自定义值**（例如“Scratcher 夏季游戏”）映射到你用于记录潜在客户来源的属性。之后你就可以在 HubSpot 中基于该属性创建列表或工作流。

## 同意

HubSpot 不会从 Scratcher 获取订阅或营销状态。使用**按许可筛选**只发送已同意的用户，或将同意的**已接受**、**日期**和**内容**字段映射到属性，以便在 HubSpot 中保留同意证明。

## 发送内容和时间

新注册用户会在一两分钟内发送。现有潜在客户会在你激活集成时发送。当有人再次参与时，其联系人信息会被更新。

## 故障排除

发送失败的记录会显示在**设置** > **集成** > **发送状态**下，并附有 HubSpot 自身的信息。

- **属性值无效**：该值不符合 HubSpot 中的属性，例如在数字或下拉属性中填入了文字。请检查映射，或在 HubSpot 中更改属性类型。
- **连接停止工作**：连接该应用的 HubSpot 用户已被移除，或该应用已在 HubSpot 中被卸载。请在**账户**选项卡上删除该账户，重新连接 HubSpot，并在活动中选择新账户。
- **联系人没有名字**：请将“潜在客户 - 名字”映射到 **First Name**。只有电子邮件和电话会自动填写。

集成

- [集成的工作原理](https://scratcher.io/zh/help/integrations/how-integrations-work)
- [所有集成](https://scratcher.io/zh/help/integrations/other-integrations)
- [查看发送状态并重新发送潜在客户](https://scratcher.io/zh/help/integrations/delivery-status)
- [连接 HubSpot](https://scratcher.io/zh/help/integrations/hubspot)
- [连接 Salesforce Marketing Cloud](https://scratcher.io/zh/help/integrations/salesforce-marketing-cloud)
- [通过 Zapier 连接 Microsoft Dynamics 365](https://scratcher.io/zh/help/integrations/microsoft-dynamics-365)
- [连接 Emarsys](https://scratcher.io/zh/help/integrations/emarsys)
- [连接 Klaviyo](https://scratcher.io/zh/help/integrations/klaviyo)
- [连接 Mailchimp](https://scratcher.io/zh/help/integrations/mailchimp)
- [连接 ActiveCampaign](https://scratcher.io/zh/help/integrations/activecampaign)
- [连接 Apsis One](https://scratcher.io/zh/help/integrations/apsis-one)
- [连接 Drip](https://scratcher.io/zh/help/integrations/drip)
- [连接 HeyLoyalty](https://scratcher.io/zh/help/integrations/heyloyalty)
- [连接 Peytz](https://scratcher.io/zh/help/integrations/peytz)
- [连接 Marketingplatform](https://scratcher.io/zh/help/integrations/marketingplatform)
- [通过 Zapier 连接 Campaign Monitor](https://scratcher.io/zh/help/integrations/campaign-monitor)
- [通过 Zapier 连接 ActiveTrail](https://scratcher.io/zh/help/integrations/activetrail)
- [连接 Bloomreach](https://scratcher.io/zh/help/integrations/bloomreach)
- [连接 Iterable](https://scratcher.io/zh/help/integrations/iterable)
- [连接 Mapp](https://scratcher.io/zh/help/integrations/mapp)
- [连接 Agillic](https://scratcher.io/zh/help/integrations/agillic)
- [连接 Ortto](https://scratcher.io/zh/help/integrations/ortto)
- [连接 Emarketeer](https://scratcher.io/zh/help/integrations/emarketeer)
- [连接 Shopify](https://scratcher.io/zh/help/integrations/shopify)
- [连接 Hello Retail](https://scratcher.io/zh/help/integrations/hello-retail)
- [通过 Zapier 连接 8,000 多款应用](https://scratcher.io/zh/help/integrations/zapier)
- [通过 Zapier 连接 monday.com](https://scratcher.io/zh/help/integrations/monday-com)
- [通过 Zapier 连接 Asana](https://scratcher.io/zh/help/integrations/asana)
- [通过 Zapier 连接 Podio](https://scratcher.io/zh/help/integrations/podio)
- [通过 Zapier 连接 Intercom](https://scratcher.io/zh/help/integrations/intercom)

继续学习

## 相关文章

- [集成的工作原理](https://scratcher.io/zh/help/integrations/how-integrations-work): 只需连接一次你的邮件工具或 CRM，在每个活动中启用，选择列表，映射字段，并只发送已给予同意的用户。
- [查看发送状态并重新发送潜在客户](https://scratcher.io/zh/help/integrations/delivery-status): 查看哪些潜在客户已发送到你的工具，理解错误信息，解决问题并重新发送。
- [征求同意并添加条款和条件](https://scratcher.io/zh/help/forms/consent-and-permissions): 为新闻通讯添加同意复选框，链接您的条款，选择哪个复选框用于订阅，并只把表示同意的用户发送到您的邮件工具。

需要帮助？

## 仍需要帮助？

真人团队随时为您提供帮助。如果您已在使用 Scratcher，最快的方式是使用平台内的聊天功能。

- **[与我们聊天](https://platform.scratcher.io/zh-Hans/login)**

    登录后点击右下角的聊天按钮。Rex 会立即回复，我们的团队也只需一键即可联系。
- **[预约会议](https://scratcher.io/zh/book-a-meeting)**

    与我们的团队进行免费 30 分钟视频通话：产品演示、活动创意或设置协助。
- **[给我们发邮件](mailto:contact@scratcher.io)**

    发送邮件至 contact@scratcher.io，我们会尽快回复您。
