JIKA與HubSpot資料串接使用説明

功能介紹

JIKA已支持與HubSpot實現顧客、公司、產品和訂單資料互通，請參考以下説明進行串接設定並了解實際應用。

資料串接範圍

從JIKA串接至HubSpot

以下資料可從JIKA串接至HubSpot：

1. 顧客

   • 展示在JIKA中 顧客 > 所有顧客 中的資料，可串接至HubSpot的Contacts，支援資料創建與更新。

   • 具體可串接的欄位及串接至HubSpot後對應的HubSpot欄位，請於 JIKA > 夥伴技術整合 > HubSpot > 設定 > 地圖管理 > 同步 > 顧客 中查看。

     

     Magento欄位 – 會串接至HubSpot的Magento欄位

     HubSpot欄位 – 該欄位資料會串接至HubSpot的哪個欄位

2. 公司

   • 展示在JIKA中 JIKA > 業務營運 > 商業 > 所有公司 中的資料，可串接至HubSpot的Companies，支援資料創建與更新。

   • 具體可串接的欄位及串接至HubSpot後對應的HubSpot欄位，請於 JIKA > 夥伴技術整合 > HubSpot > 設定 > 地圖管理 > 同步 > 公司 中查看。其中：

     Magento欄位 – 指會串接至HubSpot的Magento欄位

     HubSpot欄位 – 指該Magento欄位資料會串接至HubSpot的哪個欄位

3. 商品

   • 展示在JIKA中 目錄 > 產品 中的資料，可串接至HubSpot的Products，支援資料創建與更新。

   • 具體可串接的欄位及串接至HubSpot後對應的HubSpot欄位，請於 JIKA > 夥伴技術整合 > HubSpot > 設定 > 地圖管理 > 同步 > 商品 中查看。其中：

     Magento欄位 – 指會串接至HubSpot的Magento欄位

     HubSpot欄位 – 指該Magento欄位資料會串接至HubSpot的哪個欄位

4. 訂單

   • 展示在JIKA中 銷售 > 訂單 中的資料，可串接至HubSpot的Orders，支援資料創建與更新。

   • 具體可串接的欄位及串接至HubSpot後對應的HubSpot欄位，請於 JIKA > 夥伴技術整合 > HubSpot > 設定 > 地圖管理 > 同步 > 訂單 中查看。其中：

     Magento欄位 – 指會串接至HubSpot的Magento欄位

     HubSpot欄位 – 指該Magento欄位資料會串接至HubSpot的哪個欄位

從HubSpot串接至JIKA

當在HubSpot修改以下從JIKA串接至HubSpot的那部分資料時，修改後的内容可回傳至JIKA：

1. 聯絡人

   • HubSpot的Contacts資料

   • 可回傳的欄位及回傳至JIKA後對應的JIKA欄位，請於 JIKA > 夥伴技術整合 > HubSpot > 設定 > 地圖管理 > Webhooks > 聯絡人 中查看。其中：

     HubSpot欄位 – 指會回傳至JIKA的HubSpot欄位

     Magento欄位 – 指該HubSpot欄位資料會回傳至JIKA的哪個欄位

2. 公司

   • HubSpot的Companies資料

   • 可回傳的欄位及回傳至JIKA後對應的JIKA欄位，請於 JIKA > 夥伴技術整合 > HubSpot > 設定 > 地圖管理 > Webhooks > 公司 中查看。其中：

     HubSpot欄位 – 指會回傳至JIKA的HubSpot欄位

     Magento欄位 – 指該HubSpot欄位資料會回傳至JIKA的哪個欄位

HubSpot設定

要實現JIKA與HubSpot資料互通，需先於 HubSpot > Settings > Account Management > Integrations > Private Apps 中創建Private app。

1. 點擊轉至Private APPs創建頁面。

2. 填寫Basic Info，Scopes和Webhooks資訊。請依照HubSpot提示進行填寫，其中：

   a) Scopes

   • Scope決定JIKA可向HubSpot傳送的資料範圍以及可執行的操作。

   • 目前JIKA僅支援以下Scope：

     • crm.objects.line_items.read
     • crm.objects.line_items.write
     • crm.schemas.line_items.read
     • crm.pipelines.orders.write
     • crm.pipelines.orders.read
     • crm.schemas.orders.write
     • crm.schemas.orders.read
     • crm.objects.orders.write
     • crm.objects.orders.read
     • conversations.custom_channels.read
     • conversations.custom_channels.write
     • integration-sync
     • e-commerce
     • crm.lists.write
     • crm.objects.companies.read
     • crm.lists.read
     • crm.schemas.companies.read
     • crm.objects.contacts.read
     • crm.schemas.companies.write
     • crm.schemas.contacts.write
     • crm.objects.subscriptions.read
     • crm.schemas.subscriptions.read
     • crm.schemas.commercepayments.read
     • crm.objects.commercepayments.read
     • conversations.read
     • conversations.write
     • conversations.visitor_identification.tokens.create
     • crm.objects.contacts.write
     • crm.objects.contacts.sensitive.read
     • crm.objects.contacts.sensitive.write
     • crm.objects.companies.sensitive.read
     • crm.objects.companies.sensitive.write
     • crm.objects.companies.write
     • crm.schemas.contacts.read

   • 各個Scope的詳細説明請參考HubSpot官方文檔：https://developers.hubspot.com/docs/guides/apps/authentication/scopes#list-of-available-scopes。

   b) Webhooks

   • Webhooks 是 HubSpot 用來實時向外部應用發送資料更新的機制。當HubSpot 中的某些資料發生變更（例如修改聯絡人），Webhooks 會自動觸發並將變更資訊推送到指定的URL，這樣外部應用程式就能夠即時接收到資料更新。

   • 這裏的Target URL請參考 JIKA > 夥伴技術整合 > HubSpot > 設定 > 基礎設定 > Webhooks已啓用 下方的説明，在黏貼時請去掉'https://'。

     

   • Webhook裏的subscriptions用於訂閲具體的資料或事件通知。目前JIKA僅支援以下subscriptions：

     Object types	Contact	Properties	説明
     Contact	Property changed	firstname
     Contact	Property changed	lastname
     Contact	Property changed	date_of_birth
     Company	Property changed	magento_email	該property在完成JIKA設定后，才會在Hubspot中生成。
     Company	Property changed	industry
     Company	Property changed	magento_taxvat	該property在完成JIKA設定后，才會在Hubspot中生成。

   • 各個Subscription的詳細説明請參考HubSpot官方文檔：https://developers.hubspot.com/docs/guides/api/app-management/webhooks#webhook-subscriptions。

3. 點擊以保存Private app。

JIKA設定

進入JIKA後台 JIKA > 夥伴技術整合 > HubSpot > 設定 > 基礎設定，完善JIKA串接設定。

啓用 – 是否啓用JIKA與HubSpot的串接功能。

Webhooks啓用 – 是否啓用HubSpot的Webhooks通知功能。如果關閉該配置，在HubSpot修改資料後，將不再更新至JIKA。

用戶端密碼 – 請填寫於HubSpot創建的Private app > Auth頁籤 > Client secret資訊。

訪問令牌 - 請填寫於HubSpot創建的Private app > Auth頁籤 > Access token資訊。

授權 – 點擊，系統會驗證當前已保存的用戶端密碼和訪問令牌是否可成功放問HubSpot。

授權Cron啓用 – 是否透過Cron，讓系統自動驗證當前已保存的用戶端密碼和訪問令牌是否可成功放問HubSpot。

授權Cron運算式 – 設定Cron運行的頻率。

從JIKA串接至HubSpot

要想將JIKA資料串接至HubSpot，可以選擇通過Cron設定固定的串接頻率進行自動串接，或手動將特定資料進行串接。

自動串接

請前往 JIKA > 夥伴技術整合 > HubSpot > 設定 > 同步設定 設定自動串接頻率。設定完成後，JIKA將按照設定頻率自動將所有顧客、公司、商品、訂單資料串接至HubSpot。

啟用 Cron – 是否啓用Cron。關閉後JIKA將不再自動串接客戶/公司/產品/訂單資料。

運算式 – 設定Cron運行頻率，設定説明可參考Magento官方文檔：https://experienceleague.adobe.com/en/docs/commerce-cloud-service/user-guide/configure/app/properties/crons-property#specification。Cron運行時區為 商店 > 設定 > 設定 > 基礎設定 > 基礎設定 > 本地化選項 > 時區 中設定的時區("預設設定"範圍下)。

立即同步所有客戶/立即同步所有公司/立即同步所有產品/立即同步所有訂單 – 點擊後，JIKA會立即將所有客戶/所有公司/所有產品/所有訂單資料串接到HubSpot。

手動串接客戶資料

方式一：

1. 前往 顧客 > 所有顧客

2. 勾選需串接的顧客，並在執行中點擊

3. 隨後，JIKA會將已勾選的顧客資料批量串接至HubSpot

   

方式二：

1. 前往 顧客 > 所有顧客

2. 找到需串接客戶，點擊進入該客戶的詳情頁

3. 點選頁籤

4. 點擊

5. 隨後，JIKA會將該顧客的資料串接至HubSpot

   

手動串接公司資料

方式一：

1. 前往 JIKA > 業務營運 > 商業 > 所有公司

2. 勾選需串接的公司，並在執行中點擊

3. 隨後，JIKA會將已勾選的公司資料批量串接至HubSpot

   

方式二：

1. 前往 JIKA > 業務營運 > 商業 > 所有公司

2. 找到需串接公司，點擊進入該公司的詳情頁

3. 點選頁籤

4. 點擊

5. 隨後，JIKA會將該公司的資料串接至HubSpot

   

手動串接產品資料

方式一：

1. 前往 目錄 > 產品

2. 勾選需串接的產品，並在執行中點擊

3. 隨後，JIKA會將已勾選的產品資料批量串接至HubSpot

   

方式二：

1. 前往 目錄 > 產品

2. 找到需串接產品，點擊後進入該產品的詳情頁

3. 選擇具體的商店視圖

4. 點選[Hubspot CRM]分類

5. 點擊

6. 隨後，JIKA會將該產品的資料串接至HubSpot

   

手動串接訂單資料

方式一：

1. 前往 銷售 > 訂單

2. 勾選需串接的訂單，並在執行中點擊

3. 隨後，JIKA會將已勾選的訂單資料批量串接至HubSpot

   

方式二：

1. 前往 銷售 > 訂單

2. 找到需串接的訂單，點擊進入該訂單的詳情頁

3. 點選頁籤

4. 點擊

5. 隨後，JIKA會將該訂單的資料串接至HubSpot

   

從HubSpot串接至JIKA

當用戶在HubSpot更新並保存從JIKA串接至HubSpot的公司和聯係人資料時，更新後的内容可回傳至JIKA。

串接日志

1. 前往 JIKA > 夥伴技術整合 > HubSpot > 同步日志，可查看資料從JIKA串接至HubSpot的日志，包括手動串接和自動轉接記錄。

2. 前往 JIKA > 夥伴技術整合 > HubSpot > Webhook日志，可查看資料從HubSpot串接至JIAK的日志。