文档WorkfrontWorkfront 指南

HubSpot CRM模块

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined

通过Adobe Workfront Fusion HubSpot CRM模块，您可以监视事件、记录、联系人、预约、文件和表单提交，或者创建、检索、更新和删除您HubSpot CRM帐户中的记录、联系人、预约、事件或文件。

访问要求

您必须具有以下权限才能使用本文中的功能：

Adobe Workfront 计划*
Pro或更高版本
Adobe Workfront 许可证*
计划，工作
Adobe Workfront Fusion 许可证**

当前许可证要求：无Workfront Fusion许可证要求。

或

旧版许可证要求：Workfront Fusion for Work Automation and Integration

产品

当前产品要求：如果您有Select或Prime Adobe Workfront计划，则贵组织必须购买Adobe Workfront Fusion和Adobe Workfront才能使用本文中描述的功能。 Workfront Fusion包含在Ultimate Workfront计划中。

或

旧版产品要求：您的组织必须购买Adobe Workfront Fusion和Adobe Workfront，才能使用本文中介绍的功能。

要了解您拥有什么计划、许可证类型或访问权限，请与Workfront管理员联系。

有关Adobe Workfront Fusion许可证的信息，请参阅Adobe Workfront Fusion 许可证。

先决条件

要使用HubSpot CRM模块，您必须具有HubSpot CRM帐户。

将Adobe Workfront Fusion连接到HubSpot CRM

有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与 Adobe Workfront Fusion 的连接 — 基本说明

NOTE
配置连接时，请选择​ HubSpot CRM ​连接类型。 HubSpot CRM（已弃用）类型支持现有连接，但我们不建议使用它来创建新连接。

HubSpot CRM模块及其字段

配置Hubspot CRM模块时，Workfront Fusion显示下面列出的字段。 除此以外，可能还会显示其他Hubspot CRM字段，具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

如果看到字段或函数上方的映射按钮，则可以使用该按钮设置该字段的变量和函数。 有关详细信息，请参阅在 Adobe Workfront Fusion中将信息从一个模块映射到另一个模块。

CRM对象

搜索CRM对象

此搜索模块按自定义属性或查询搜索CRM对象。 要搜索产品或行项目，请使用具有所需自定义范围的特殊连接。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
限制
输入或映射模块在一个执行周期中返回的最大项数。
要搜索的对象类型
选择要搜索的Hubspot CRM对象的类型。
输出属性
选择要显示在模块输出中的属性。 可用字段取决于您选择的对象。
过滤方式

选择您希望如何筛选搜索

  • 查询

    输入或映射查询

  • 属性

    输入搜索的组或筛选器。

排序方式

如果要对结果进行排序，请单击。 如果选择对结果进行排序，则会显示以下字段。

  • 属性名称

    选择要按其排序结果的属性

  • 方向

    选择是否要以升序或降序方向对结果进行排序。

记录（交易、联系人和公司）

创建记录（旧版）

此操作模块创建联系人、公司或交易。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型
选择要创建的记录类型
属性
填写要为记录设置的任何属性。 可用字段取决于您要创建的记录类型。

获取记录

此操作模块可获取联系人、公司或交易的详细信息。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型

选择记录类型。

  • 联系人
  • Company
  • 交易
搜索类型
如果您正在获取联系人，请选择是要通过ID还是电子邮件地址来识别联系人。
ID
输入要检索的联系人、公司或交易的ID。
电子邮件
输入要检索其详细信息的联系人的电子邮件地址。

更新记录

此操作模块可更新联系人、公司或交易。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型
选择要更新的记录类型。
搜索类型

如果您要获得联系人，请选择您希望如何识别记录：

  • ID

  • 电子邮件

ID
输入要更新的联系人、公司或交易的ID。
电子邮件
输入要更新其详细信息的联系人的电子邮件地址。
属性
填写要为记录设置的任何属性。 可用字段取决于您要创建的记录类型。

删除记录

此操作模块可删除联系人、公司或交易。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型
选择要删除的记录类型。
ID
输入要删除的联系人、公司或交易的ID。

获取记录属性

此操作模块通过特定记录属性的（内部）名称获取该属性的元数据。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型
选择具有您要为其检索元数据的属性的记录类型。
属性名称
选择要为其检索元数据的属性。
选项ID
某些属性具有一组可用选项，用户可以选择这些选项作为属性值。 输入表示要检索的属性值的选项的ID。

观看记录

此触发器模块会在联系人、公司或交易在过去30天内被修改或创建时启动场景。 输出限制为10,000条记录。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
记录类型
选择具有要监视的属性的记录类型。
搜索
选择您要监视最近修改的记录还是最近创建的记录。
输出属性
选择要包含在模块输出中的属性。
限制
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

联系人

创建/更新联系人（旧版）

如果门户中不存在联系人，则创建联系人；如果门户中不存在联系人，则使用最新属性值更新联系人。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
属性
填写您要为联系人设置或更新的任何属性。

创建/更新联系人组

创建联系人组或更新他们（如果已经存在）。 当批次大小限制为100个或更少联系人时，性能最佳。 通过此端点进行的更改是异步处理的，因此可能需要几分钟才能将更改应用到联系人记录。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
要创建/更新的联系人批次

添加联系人批次。

单击 添加项 以添加新联系人。 在出现的窗口中，输入或映射以下信息：

  • 搜索类型

    选择您希望如何识别联系人：

    • ID

      输入要创建或更新的联系人的ID。

    • 电子邮件

      输入要创建或更新的联系人的电子邮件地址。

  • 属性

    填写您要为联系人设置或更新的任何属性。

将联系人添加到列表

此模块将系统中已创建的联系人记录添加到联系人列表。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
列表ID
选择要向其添加联系人的列表的ID。
ID/电子邮件

选择您希望如何识别要添加到列表中的联系人：

  • IDs

    添加要添加到列表中的联系人的ID。

  • 电子邮件

    添加要添加到列表中的联系人的电子邮件地址。

从列表中删除联系人

从联系人列表中删除联系人。

NOTE
您无法从动态列表中手动删除联系人。
Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
列表ID
选择要从中删除联系人的列表的ID。
联系人ID
输入要从列表中删除的联系人的ID。

合并联系人

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
ID 1
输入要合并的联系人的ID。
ID 2
输入要合并的其他联系人的ID。

搜索联系人

使用搜索查询检索联系人列表。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
Query
输入搜索查询。
限制
输入或映射在一个方案执行周期内应返回的最大联系人数Workfront Fusion。

列出联系人

返回在门户中创建的所有联系人。 输出限制为5000个联系人。 若要列出上一个或下一个联系人，您可以使用advanced参数偏移列表。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
限制
在一个方案执行周期内应返回的最大联系人数Workfront Fusion。
输出属性
选择要显示在模块输出中的属性。

列出公司的联系人

检索公司中的联系人列表。 输出限制为5000个联系人。 若要列出上一个或下一个联系人，您可以使用advanced参数偏移列表。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
ID
输入要列出其联系人的公司的ID。
限制
在一个方案执行周期内应返回的最大联系人数Workfront Fusion。

观看添加到列表中的联系人

此触发器模块会在向列表添加新联系人后启动方案。 这仅适用于拥有付费营销帐户的用户。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
列表ID
输入或映射包含要监视的联系人的列表ID。
输出属性
选择要包含在模块输出中的属性。
限制
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

交易

列出交易/票证管道

返回给定门户的所有交易和票证管道。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
对象类型
选择您要列出交易还是票证。

获取交易的CRM管道

返回特定的交易管道。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
管道ID
输入或映射要检索其详细信息的管道ID。
阶段ID
输入或映射要检索其详细信息的阶段的ID。

公司

按域搜索公司

根据与域属性的完全匹配检索公司列表。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
域
输入要搜索公司的域，如hubspot.com。
限制
在一个方案执行周期内应返回的最大公司数Workfront Fusion。
输出属性
选择要显示在模块输出中的属性。

文件

创建文件夹

此模块创建一个文件夹。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
文件夹名称
输入或映射新文件夹的名称。
父文件夹ID
为要创建的文件夹选择父文件夹的ID。

删除文件夹

将文件夹标记为已删除。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
ID
输入要删除的文件夹的ID。

移动文件

将文件移动到其他文件夹。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
文件ID
输入或映射要移动的文件的ID。
文件夹ID
选择要将文件移动到的文件夹的ID。
名称
输入已移动文件的名称。

票证

删除票证

按票证ID删除现有票证。

Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
ID
输入要删除的票证ID。

进行API调用

允许您执行自定义API调用。

NOTE
以下端点已于2023年8月31日在HubSpot API中弃用，并且在Fusion模块中无法再使用。
  • 列出内容事件
  • 列出社交事件
  • 列出日历任务事件
  • 列出所有日历事件
  • 创建日历任务
  • 按ID获取日历任务
  • 更新日历任务
  • 删除日历任务
Connection
有关将HubSpot CRM帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
URL

输入相对于https://api.hubapi.com/的路径。 例如， /contacts/v1/lists/all/contacts/all

有关可用端点的列表，请参阅HubSpot API文档。

方法

选择要使用的HTTP方法：

GET

检索条目的信息。

POST

以创建新条目。

PUT

更新/替换现有条目。

PATCH

更新部分条目。

DELETE

以删除条目。

Headers
输入所需的请求标头。 您无需添加授权标头；我们已经为您添加了这些标头。
查询字符串
输入请求查询字符串。
Body
以标准JSON对象的形式添加API调用的正文内容。在JSON中使用条件语句（如if）时，请将引号放在条件语句之外。
INFO
示例： ​以下API调用返回您HubSpot帐户中的所有联系人：
URL： /contacts/v1/lists/all/contacts/all
方法： GET
在包 > 正文 > 联系人下的模块输出中可以找到搜索匹配项。
在我们的示例中，返回了3个联系人：

创建新应用程序

  1. 登录到您的HubSpot开发人员帐户。

  2. 选择​ 创建应用程序 ​选项。

  3. 输入应用程序名称并保存对话框。

  4. 选择webhook所需的范围。

    例如，添加联系人范围，以便在创建或删除新联系人时触发模块。

    联系人范围是接收联系人、交易和公司活动Webhook所需的所有内容。

    note important
    IMPORTANT
    请勿填写重定向URL字段。
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43