测试版连接 HubSpot 和 Jira（数据同步）

连接 HubSpot 和 Jira，将 HubSpot 工单与 Jira 问题同步。这使支持团队能够在 HubSpot 和 Jira 中清晰可见，从而更快解决客户问题。了解如何连接您的 Jira 工作区并配置同步以满足您的业务需求。 

开始前须知

在开始连接 Jira 之前，请注意以下事项：

• 若您是超级管理员，请将您的账户加入由数据同步驱动的新版Jira应用测试版。
• 您必须拥有Jira Cloud账户。该集成无法与运行在客户自有服务器上的Jira实例同步。
• 工单状态仅支持从Jira单向同步至HubSpot。

连接应用

连接 HubSpot 与 Jira 的步骤：

1. 在 HubSpot 帐户中，单击顶部导航栏中的“商城”图标 marketplace，然后选择 HubSpot 商城。
2. 搜索并选择Jira (数据同步)。 
3. 点击安装，然后点击连接至Jira。 
4. 在对话框中输入您的Atlassian 凭据。确认所需权限后，点击"接受"。 

配置同步设置

同步设置分为两个阶段：

1. 设置HubSpot 工单与 Jira 问题同步（单向或双向）。 

2. 设置HubSpot 笔记与 Jira 问题评论的同步（单向或双向）。 

设置HubSpot工单与Jira问题同步

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击Jira（数据同步）。 
3. 导航至CRM 同步选项卡。 
4. 点击同步更多数据。
5. 在"选择要同步的数据"页面，点击Jira（数据同步）下拉菜单并选择 "问题"。随后选择站点、项目和 问题类型。若需跨多个站点、项目或问题类型同步，则需配置额外同步项。同步项数量无上限。 
6. 点击同步方向箭头并选择同步方向。

1. • 应用间数据同步：数据 在HubSpot与Jira间双向同步。任何变更都将同步至双方系统，并在两个应用中创建新记录。
   • 数据仅同步至HubSpot：根据设定条件将Jira问题转换为HubSpot工单。仅更新HubSpot工单属性。
   • 数据仅同步至Jira（数据同步）：根据条件将从HubSpot工单创建Jira问题。仅创建Jira问题属性。

7. 接着点击“下一步”。 
8. 在配置页面 ：

• • 点击"数据冲突解决"下拉菜单，选择当无法确定哪个应用程序拥有最新信息时，哪个应用程序将覆盖另一个。
  • 在映射 字段部分设置 您的 字段映射。
    • 默认字段映射不可删除或编辑。若需关闭字段映射，请点击开关将其关闭。 
    • 要添加自定义字段映射，请点击添加映射进行设置。

9. 在限制页面：

1. • 在映射工单流程与阶段部分，选择工单流程并将每个HubSpot工单阶段映射至Jira状态。 

请注意：工单状态仅支持从Jira单向同步至HubSpot。

• • 在筛选器部分，点击编辑以添加筛选条件，限定需在两个应用间同步的工单或问题。可通过AND或OR条件添加多个筛选器。默认情况下所有记录均参与同步。 
    • 若选择 HubSpot 与 Jira 之间的双向同步，必须分别设置过滤器：当 HubSpot 工单需创建 Jira 问题时，以及当 Jira 问题需创建 HubSpot 工单时。 
    • 若需阻止Jira问题创建HubSpot工单，请配置限制性筛选器。未设置筛选器时，每个新增的HubSpot工单或Jira问题都将在另一系统中创建对应记录。

10. 在“审核”页面，检查同步配置后点击“保存并同步”。 

设置HubSpot备注与Jira问题评论的同步

完成HubSpot工单与Jira问题同步设置后，请配置第二项同步：将关联工单的HubSpot备注同步至Jira问题评论：

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击Jira（数据同步）。
3. 导航至CRM 同步选项卡。
4. 点击同步更多数据。
5. 在"选择要同步的数据"页面，点击HubSpot下拉菜单并选择"备注"。在Jira（数据同步）下，"问题评论"将自动选中在第一个下拉菜单中。

6. 在Jira（数据同步）下的 中，选择与您为HubSpot 工单数据同步 所选相同的 站点、项目和 工单类型，确保相关备注/工单评论在关联工单/问题间同步。
7. 点击同步方向箭头并选择同步方向。

• • 应用间数据同步：数据 在HubSpot与Jira间双向同步。任何变更都会同步到HubSpot笔记和Jira问题评论中，并在两个应用中创建新记录。
  • 仅向HubSpot同步数据：根据设定条件，Jira问题评论将自动生成对应的HubSpot笔记。 
  • 仅向Jira同步数据（数据同步）：根据设定条件，将从HubSpot笔记创建Jira问题评论。

8. 然后点击下一步。
9. 在配置页面 ：

• • 点击数据冲突解决下拉菜单，选择当无法确定哪个应用程序拥有最新信息时，哪个应用程序将覆盖另一个应用程序。
  • 在映射 字段部分设置 您的 字段映射。
    • 默认字段映射不可删除或编辑。若需关闭字段映射，请点击开关将其关闭。 
    • 要添加自定义字段映射，请点击添加映射进行设置。

10. 在限制页面：

• • 在筛选器部分，Jira dataSyncRightHubSpot 项下将设置默认筛选器以同步所有问题评论。您应确保其逻辑与HubSpot 工单 dataSyncRightJira 问题 同步功能保持一致。
  • 在筛选器部分的HubSpot dataSyncRight Jira下，默认筛选器将确保HubSpot笔记关联的工单信息完整。此设置可防止未关联工单的笔记同步至Jira。 
    • 点击编辑以修改此过滤器。 
    • 添加AND过滤器以补充您在HubSpot 工单dataSyncRightJira问题同步中设置的其他过滤条件。例如：若HubSpot工单存在名为"支持严重性"的属性（取值范围1-5，5为最高级别），且您仅同步严重性≥3的工单至Jira，则需在此处设置相同过滤条件以匹配工单筛选规则。

• • • 点击编辑可添加其他筛选条件，限制应用间同步的评论或笔记范围。您可通过AND或OR条件添加多个筛选器。这些条件应与您在HubSpot 工单数据同步权限设置中配置的 Jira问题同步逻辑一致，且每个新增筛选器均需包含"工单名称已知"条件（如上例所示），以确保仅同步关联工单的笔记。

11. 在“审核”页面，检查同步配置后点击“保存并同步”。
    同步过程将检查HubSpot中的每条笔记，但仅根据上述筛选条件进行同步。

在Jira问题中添加HubSpot工单链接

安装Jira（数据同步）应用后，您可在对应Jira问题中直接显示HubSpot工单记录链接。此功能支持从Jira问题快速跳转至相关HubSpot工单，需在HubSpot的Jira同步设置中配置新字段映射。

在Jira中设置HubSpot工单链接：

1. 在 Jira 中，导航至您正在处理的Jira 项目。 
2. 在右下角点击配置。
3. 创建一个新的Jira字段。 

• • 为该字段在Jira中输入唯一名称，例如"HubSpot工单链接"。
  • 字段类型请选择URL。 

• • 完成设置后，点击右下角的“保存更改”。

4. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
5. 点击Jira（数据同步）。
6. 点击工单同步项的编辑按钮。
7. 在“配置”页面 ，于“映射字段 ”部分点击 “添加映射”。
8. 点击Jira（数据同步）下拉 菜单，选择 您在Jira中创建的新Jira字段 。
9. 点击HubSpot下拉菜单，选择工单属性“工单链接”。 

请注意：安装Jira（数据同步）集成后，HubSpot中的工单属性"工单链接"将自动创建。

10. 在“审核”页面，检查同步配置后点击“保存并同步”。
11. 完成上述步骤后，在Jira中查看问题时，HubSpot工单链接字段将显示指向HubSpot工单记录的链接。点击Jira中的链接即可跳转至HubSpot中的工单记录。

检查同步设置

查看同步设置：

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击Jira（数据同步）。
3. 点击CRM同步选项卡。该选项卡显示同步记录数、同步失败记录数、排除同步记录数以及上次编辑同步的时间戳。 

• • 要查看单条记录，请点击各列中的数字。
  • 要立即运行同步，请点击“立即同步”。 
  • 创建新同步或额外同步时，请点击“同步更多数据”。
  • 要编辑现有同步任务，请将鼠标悬停在任务上并点击编辑。
  • 要关闭同步，请将鼠标悬停在同步项上，点击“更多”>“关闭同步”。
  • 要删除同步任务，请将鼠标悬停在同步任务上，点击“更多”>“删除同步”。在对话框中输入所需文本后，点击“删除同步”。 

使用 Jira（数据同步） 同步卡片

连接集成后，您可在与Jira问题同步的工单记录中查看Jira（数据同步）同步卡片。这将为您提供更精确的记录同步状态视图，包括：

• HubSpot工单记录正在与哪个Jira记录同步。 
• 同步状态。 
• 记录上次同步的时间。 

添加同步卡片 

若未自定义记录右侧边栏，Jira（数据同步）同步卡片将自动添加至记录中。

若您已自定义记录右侧边栏，请将集成同步卡片添加至工单对象的右侧边栏： 

1. 在 HubSpot 帐户中，单击顶部导航栏中的 settings “设置”图标。
2. 在左侧边栏菜单中，导航至对象，然后选择工单。 
3. 点击 “记录自定义”选项卡。

• • 要编辑默认视图，请点击“默认视图”。该视图将显示给所有未被分配到团队的用户。
  • 创建或编辑团队视图（仅限专业版和企业版用户）：点击“创建团队视图”，或点击现有视图名称。团队视图仅向所选团队的核心成员显示。

4. 在视图编辑器中，将鼠标悬停在右侧边栏上，点击添加卡片。 

5. 点击卡片库选项卡。 
6. 搜索并选择集成同步卡片 。
7. 点击右上角的X关闭面板。随后点击右上角的保存并退出按钮保存更改。

查看同步卡片

在同步卡片添加至工单记录后，您可查看以下信息：

• 外部记录：该工单正在与哪个Jira问题同步。点击记录名称可在Jira中打开该记录。

• 状态：HubSpot与Jira（数据同步）之间的同步状态。同步状态包括：
  • 最新状态：记录同步成功。
  • 未找到同步：集成处于活动状态，但当前 HubSpot 记录未与 Jira 同步。
  • 已关闭同步：集成设置页面中已关闭同步功能。 
  • 记录未同步：因错误导致记录未同步。更多信息请将鼠标悬停在同步状态上，或点击同步状态跳转至同步健康页面。
  • 未知同步：记录正在与Jira同步，但无法获取同步健康信息。
  • 记录被排除：该记录属于同步排除范围。更多信息请将鼠标悬停在 状态上。
• 最后更新时间：显示HubSpot与Jira数据上次同步的时间点。