測試版連接 HubSpot 和 Jira（資料同步）

將 HubSpot 與 Jira 連接，同步您的 HubSpot 票證與 Jira 問題。此舉能讓 HubSpot 與 Jira 中的支援團隊掌握問題全貌，加速解決客戶疑難。瞭解如何連接您的 Jira 工作區，並依業務需求設定同步功能。 

開始前須知

開始連接 Jira 之前，請注意以下事項：

• 若您是超級管理員，請將您的帳戶加入「由資料同步驅動的新版 Jira 應用程式」測試版。
• 您必須擁有 Jira Cloud 帳戶。此整合無法與客戶自有伺服器上運行的 Jira 實例進行同步。
• 工單狀態僅能從 Jira 單向同步至 HubSpot。

連接應用程式

要連接 HubSpot 與 Jira：

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的「Marketplace 圖示」marketplace，然後選取「HubSpot Marketplace」。
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：根據設定條件將從 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 dataSyncRightJira 下方，預設篩選器會確保 HubSpot 筆記的關聯工單已知。此設定可避免未關聯工單的筆記同步至 Jira。 
    • 點擊「編輯」以修改此篩選器。 
    • 新增AND篩選器以加入您在HubSpot 票證 dataSyncRightJira 問題同步中設定的其他篩選條件。例如：若您的 HubSpot 票證具備名為「支援嚴重性」的屬性（數值範圍 1 至 5，5 為最高），且僅同步支援嚴重性為 3 或更高的票證至 Jira，請在此區段設定相同篩選條件以匹配票證篩選規則。

• • • 點擊「編輯」可新增其他篩選條件，限制應用程式間同步的評論或筆記範圍。您可透過AND 或OR條件設定多重篩選規則。這些規則應與您在HubSpot 票證 dataSyncRightJira 問題同步設定的邏輯相符，且每項新增篩選條件皆須包含「票證名稱已知」篩選器（參照上述範例），以確保僅同步與票證關聯的筆記。

11. 在檢視頁面中，確認同步設定後點擊儲存並同步。
    同步程序將檢視 HubSpot 中的所有筆記，但僅依據上述篩選條件進行同步。

在 Jira 問題中添加 HubSpot 工單連結

安裝 Jira (Data Sync) 應用程式後，即可在對應的 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 數據上次同步的時間點。