HubSpot

OneSignal 与 HubSpot 的集成使您能够通过 HubSpot 工作流自动化推送通知、电子邮件、短信的传递，并管理应用内消息的数据标签。此集成还允许您在联系人时间线上查看 OneSignal 活动，并根据用户与 OneSignal 的交互对用户进行分段。对于 A/B 测试、智能传递、限流和重新定位等高级功能，您可以独立使用 OneSignal。

---

​

要求

• 您必须是 HubSpot 超级管理员或在您的 HubSpot 账户中拥有 应用市场权限。
• 升级的 OneSignal 账户（免费应用不可用）。

仅限传统客户：迁移到新的 HubSpot 集成

​

安装新的 HubSpot 集成

如一般指南中所述，用户现在需要从其 OneSignal 控制台的应用设置的 集成 部分激活 HubSpot 集成

​

迁移您的工作流

虽然不是必需的，但我们建议在替换现有工作流中的操作之前创建新的工作流来测试新集成。一些用户还为测试目的维护单独的暂存和生产 HubSpot 环境。

​

克隆您的工作流

在 HubSpot 的 工作流 页面上，您可以点击现有工作流旁边的 克隆 按钮来创建它的新副本。

​

从新工作流中删除触发器

克隆后，您应该首先删除新创建的工作流中的任何触发器。这将确保您可以发布新工作流而不会意外自动触发它。

​

使用新版本更新旧版 OneSignal 操作

然后您可以浏览工作流，删除所有旧版 OneSignal 操作并用新的操作替换它们。由于您可能同时安装了旧版 OneSignal 应用和新的 OneSignal 构建的集成，因此小心确保您从新应用创建操作非常重要。旧版应用会显示文本”Built by HubSpot”。

安装了旧版和新版 OneSignal 应用时的操作菜单。使用不显示 'Built by HubSpot' 的那个

​

测试工作流

替换工作流操作并保存发布工作流后，您将能够手动注册联系人来测试工作流。我们建议您首先只使用一个测试联系人进行此操作，以确保工作流正常工作。

从旧版集成迁移 HubSpot 工作流的示例。

注册联系人后，您将能够查看工作流的注册历史记录，以了解操作是否成功。如果遇到任何意外错误，请联系 OneSignal 支持。成功测试工作流后，您可以用副本替换原始工作流，或在原始工作流中进行相同的更改。

---

​

设置

​

在 OneSignal 中激活 HubSpot

在 OneSignal 中，转到您的应用的 Data > Integrations 页面，在 HubSpot 下选择 Activate。 点击 Authenticate，然后登录到您的 HubSpot 账户。系统可能会要求您选择要使用的 HubSpot 账户。 一旦您同意条款并选择 Connect app，您将被重定向到您的 OneSignal 应用，并需要打开新连接的 HubSpot 账户。

​

设置 OneSignal External ID

为了将 HubSpot 中的用户与 OneSignal 中的用户匹配，您需要将 OneSignal 中的 External ID 标识符设置为与您在 HubSpot 中收集的某个唯一用户属性相同的值。您将使用这个在下面描述的 HubSpot 工作流中进行匹配。 External ID 可以通过多种方式设置，但强烈建议使用移动应用或网站中容易获得的属性，这样您就可以使用我们的 SDK login 方法在用户的推送订阅上设置它。

---

​

定义 HubSpot 工作流

在 HubSpot 中，导航到 Automation > Workflows 并点击 Create workflow。 选择 Contact-based 并配置您的注册。 要添加 OneSignal 操作，请点击 + 并搜索 OneSignal。 我们的工作流操作允许您在 OneSignal 中创建用户和标签（它们是自定义用户属性或事件）并发送消息。要使用任一操作，您必须首先定义一些属性：

​

OneSignal App 字段

这是您在上述初始设置说明中连接到 HubSpot 账户的 OneSignal 应用。

​

External ID 字段

这是您在 OneSignal 应用中为用户设置的与 HubSpot 中设置的属性匹配的属性。

---

​

从 HubSpot 创建 OneSignal 用户

您可以在 HubSpot 中创建或通过工作流传递时在 OneSignal 中创建 用户。您可以使用创建用户节点来确保 OneSignal 和 HubSpot 保持同步。 如果设置了以下 HubSpot 属性，它将为该用户创建相应的订阅：

• HubSpot 邮箱属性将在 OneSignal 中为该用户创建电子邮件订阅。
• HubSpot 电话号码属性将在 OneSignal 中为该用户创建短信订阅。

如果您的 OneSignal 应用启用了双重选择加入，短信记录将发送选择加入消息。您可以在 HubSpot 的”创建用户”节点中禁用选择加入消息的自动发送。这意味着将在 OneSignal 中创建短信记录，但不会订阅短信消息，也不会向该用户发送选择加入消息。 您可以在”创建用户”节点中设置 External ID 和标签，这与”编辑标签”节点非常相似。

---

​

从 HubSpot 编辑 OneSignal 标签

OneSignal 使用 标签 向用户添加自定义属性。标签可用于将 HubSpot 联系人属性添加到 OneSignal 中，用于 消息个性化 和/或 分段，这可以用于许多事情，包括 发送应用内消息。

​

标签字段

输入格式为 { "key1" : "value1", "key2" : "value2" } 的 JSON 字符串并点击保存。 您可以将 HubSpot 属性作为标签注入，以便它们存储在 OneSignal 中。例如，添加用户姓名作为标签，这样您可以在消息中按姓名称呼用户。 您可以通过将 "value" 设置为空字符串来删除标签，如下所示： { "key" : "" }。如果您想删除 OneSignal 中的标签数据，这会很有用。如果标签不存在，它将被忽略。

---

​

发送 OneSignal 通知

您可以通过填写提供的表单发送推送通知，或选择预定义的 模板 来发送电子邮件或短信。 建议 通过 OneSignal external_id 匹配，因为通过电子邮件匹配是为传统客户或如果您使用我们的 addEmail SDK 方法设置电子邮件而设的。 然后您可以选择使用模板发送消息，或直接在工作流内定义推送通知。

​

模板选项

您可以在 OneSignal 控制台或我们的 API 中创建模板。通过使用模板，您可以发送短信、电子邮件或推送通知。

​

表单字段选项

如果不使用模板，您只能通过在各种字段（标题、副标题、消息、图像 URL、启动 URL）中输入文本来发送推送通知。电子邮件和短信只能通过模板使用。 此选项的好处是您还可以使用 HubSpot 联系人数据（例如，名字、喜欢的颜色）来个性化通知字段。OneSignal 将为不同的设备和消息传送渠道正确格式化消息。 完成后点击保存。

---

​

常见问题

​

HubSpot 和 OneSignal 之间共享什么数据？

HubSpot	方向	OneSignal App	描述
联系人	➡️	External ID	HubSpot 联系人数据用于通过 External ID 与 OneSignal 用户匹配。
工作流	⬅️	消息模板	OneSignal 消息模板可在 HubSpot 工作流中选择

​

如何使用 HubSpot 发送应用内消息？

在 OneSignal 控制台的 Audience 中，选择 New Segment。根据选择的标签为其命名，并选择 User Tag 过滤器。 输入在 HubSpot 中设置的 "key" 和 "value"，然后点击 Create Segment。 导航至消息 > 应用内并选择新建应用内。 为您的新 IAM 命名，以便您可以在控制台中识别它。 在”1. 受众”下选择显示给特定分段并选择您新创建的分段。 当用户通过 HubSpot 工作流时，他们将被标记，这将立即将他们放入此分段中。注意：获得标签不会触发 IAM。更多详细信息请参见下面的触发器选项。 对于”2. 消息”，请遵循发送应用内消息指南以获取有关创建应用内消息的详细信息。

​

触发器选项

应用内消息需要被触发才能在设备上显示。触发器可以是基于时间的或程序性的。注意：标签不是触发器。如果在设备当前使用应用时添加标签，IAM 将不会显示。应用内消息将在用户下次在新会话中返回您的应用时显示。应用失去焦点 30 秒后会计算新会话。 在”3. 触发器”下，您可以根据以下触发器设置 IAM 显示：

• 应用打开时
• 会话持续时间 > 或 < 设定的秒数
• 自显示另一个 IAM 以来的持续时间
• 使用 OneSignal SDK 以程序方式

触发器可以使用”AND”操作符组合，并使用”OR”操作符分成多个选项。 请参阅如何触发 IAM 指南获取更多详细信息。

---