HubSpot：获取联系人属性

HubSpot：获取联系人属性节点模板会读取您为一个 HubSpot 联系人指定的属性，并将它们传递给 Journey 的其余部分：消息可以打印它们，分割器可以根据它们进行分支。

此节点使用其自己的 HubSpot 私人应用令牌进行身份验证——它不使用在“设置”中其他地方配置的任何账户级别的 HubSpot 集成。

配置节点

1. 将 HubSpot：获取联系人属性 从 Integrations 部分拖到画布上。
2. 双击该节点并输入一个 Step Name。
3. 在 Private app token 中，输入一个具有 crm.objects.contacts.read 范围的 HubSpot 私人应用令牌。它会像 webhook 秘密标头一样被屏蔽存储。

4. 在 Look the contact up by 中，输入持有标识符的 HubSpot 属性的内部名称——默认为 email，或者您自己的持有 Pushwoosh User ID 的属性。HubSpot 仅通过其值保持唯一的属性来查找联系人。

5. 在 Identifier value 中，输入要查找的值，例如 {{device:user_id}} 或旅行者的标签。

6. 在 Properties to read 中，为每个 HubSpot 属性的内部名称添加一行（例如 firstname、lifecyclestage）——请参阅列表字段。至少保留一个非空值。

7. 点击 Save。

连接分支

保存后，该节点将在画布上显示两个分支。为每个分支连接下一步：

• Found： 标识符匹配到现有的 HubSpot 联系人。例如，继续使用 Condition split 或使用您读取的属性的消息。
• Not found： HubSpot 返回 404（无匹配联系人）。旅行者不会被丢弃。该节点不会像真正的失败请求那样重试或等待失败请求的冷却时间。例如，发送不同的路径或通用消息。

Not found 不是失败的请求。真正的失败请求会丢弃旅行者。请参阅错误和失败请求。

响应

在 Found 分支上，后续步骤可以使用：

• 您请求的每个属性，格式为 hubspot_<property>。例如，firstname 变为 hubspot_firstname。
• 联系人的 ID，格式为 hubspot_contact_id。

使用它们的方式与Webhook 响应属性相同。例如，使用 Condition split 进行分支，或使用 Update user profile 设置标签。

在 Not found 分支上，这些属性都不可用。

示例场景：使用 HubSpot 联系人的计划来个性化消息

一个团队希望推送消息中提及存储在 HubSpot 中的旅行者计划等级，而无需在 Pushwoosh 标签中保留其单独的副本。

1. 在 Journey 中需要读取计划的点上添加 HubSpot：获取联系人属性。将 Look the contact up by 保留为 email，并将 Identifier value 设置为 {{tag:Email}}。在 Properties to read 中，添加 plan。
2. 点击 Save，然后将 Found 连接到一个在其文本中使用 hubspot_plan 的 Push 步骤，并将 Not found 连接到一个发送通用推送的步骤。

一旦运行，具有匹配 HubSpot 联系人的旅行者将收到提及其实际计划的推送，而没有匹配的旅行者仍会收到消息，而不会被丢弃。