HubSpot

連接 HubSpot 後，每一筆詢價請求都會同時成為您可以跟進的聯絡人，不需要任何人手動複製細節。

警告

**HubSpot 需要兩個值，而不只是一個：**一個 Portal ID 和一個 HubSpot access token。此外，發出該權杖的私人應用程式還必須勾選三個權限範圍。缺少任何一項，連線看起來都像已設定完成，但實際上不會傳送任何資料，步驟 1 涵蓋了這兩部分。

注意

HubSpot 屬於 PRO 方案。Klaviyo、Mailchimp 和 Shopify 則是 FREE 方案下的整合。請參閱方案比較。

如果您的方案不包含它，Third-party integration 清單中會顯示已停用的 Upgrade 按鈕，而不是設定圖示，旁邊還有一個掛鎖圖示。選取掛鎖圖示會說明該功能所需的方案，並連結到應用程式中的 Pricing plans。這是方案限制，並非故障。

步驟 1 — 從 HubSpot 取得 Portal ID 和存取權杖

HubSpot 已不再核發傳統的 API 金鑰。您需要改為在 HubSpot 帳號中建立私人應用程式，由它提供存取權杖。Portal ID 則是另外的項目，用來識別您的 HubSpot 帳號本身。

1. 找到您的 Portal ID

   您的 Portal ID（也稱為帳號 ID 或 hub ID）用來識別應用程式要寫入哪個 HubSpot 帳號。HubSpot 自己的指南：Check your current account。

   應用程式中該欄位下方的 Find your Portal ID 說明文字也提供了相同的連結。

2. 建立具有正確權限範圍的私人應用程式

   在您的 HubSpot 帳號中建立私人應用程式。HubSpot 自己的指南有詳細說明：Private apps。

   在完成建立之前，請至少勾選以下三個權限範圍：

   • forms
   • crm.objects.contacts.write
   • crm.schemas.contacts.write

   應用程式在權杖欄位下方也列出了相同的三項，方便您日後與私人應用程式對照檢查。

   

   需要截圖。HubSpot 私人應用程式的權限範圍畫面，已勾選 forms、crm.objects.contacts.write 和 crm.schemas.contacts.write。

3. 複製它的存取權杖

   私人應用程式建立後，HubSpot 會顯示權杖。請複製下來，並在完成設定期間妥善保存。

危險

權限範圍是最容易悄悄出錯的地方。建立時沒有 forms、crm.objects.contacts.write 和 crm.schemas.contacts.write 的權杖，本身仍是有效的權杖：Enable 會維持開啟，應用程式儲存時也不會報錯，但 HubSpot 會拒絕收到的每一筆聯絡人。如果聯絡人一直沒有送達，請先檢查權限範圍，再檢查其他項目。

警告

應用程式是將詢價請求連接到 HubSpot 的表單，而不是聯絡人清單。請在開始之前先在 HubSpot 中建立該表單，下拉選單只能提供已存在的表單。

步驟 2 — 在應用程式中連接

1. 開啟 Integrations 分頁

   在 Shopify 後台中，開啟 SA Request a Quote，選取 Advanced settings，然後開啟 Integrations 分頁。

2. 選取 HubSpot

   在 Third-party integration 下，選取 HubSpot，應用程式中的說明為「Seamlessly connect your submissions to your data」。

   HubSpot 頁面會開啟，並附有 Third-party 導覽路徑，方便您返回清單。

   

   選擇服務，然後開啟其設定。

3. 開啟 Enable

   開啟 Enable，這是頁面上的第一個控制項。在開啟之前，不會有任何資料傳送到 HubSpot。

4. 貼上兩項憑證

   這兩個欄位就在 Enable 下方，順序如下：

   1. Portal ID — 貼上步驟 1 取得的帳號 ID。其說明文字為 Find your Portal ID。
   2. HubSpot access token — 貼上步驟 1 取得的私人應用程式權杖。其說明文字為 Find or generate your access token，在它下方，應用程式會列出權杖所需的權限範圍：forms、crm.objects.contacts.write 和 crm.schemas.contacts.write。

   這個欄位名稱是 HubSpot access token，而不是「API key」，因為權杖是由私人應用程式核發的。

   請兩者都填寫。應用程式要取得這一組憑證後，才會擷取您的 HubSpot 表單，因此只填權杖的頁面會卡在沒有任何可選擇的項目。如果輸入後下拉選單沒有出現，請選取權杖欄位旁的 Merge fields，讓應用程式重新擷取。

   

   HubSpot 需要兩個值，而且兩者不能互換。

5. 選擇 HubSpot 表單

   開啟 Select a HubSpot form to integrate，選擇詢價請求要送入的表單。在您選擇之前，會顯示「Please select a HubSpot form」。

   如果應用程式顯示「It looks like you don’t have any HubSpot forms」，表示表單尚未建立、兩項憑證其中之一有誤，或權杖缺少 forms 權限範圍。請先解決這個問題再繼續，在選擇表單之前，欄位對應會維持隱藏。

6. 對應您的表單欄位

   只有在 Portal ID、HubSpot access token 和表單都設定完成後，才會出現對應列。這些列來自您剛選擇的 HubSpot 表單，所以是該表單本身的欄位，而不是固定的清單，先選擇表單，對應列就會跟著出現。

   請由左至右閱讀每一列：

   • 左側 — HubSpot 欄位，因為無法重新命名而呈現灰色。
   • 中間 — 值的提供方式：has no value、is dynamic value by（取自詢價表單）或 is fixed value by（每筆報價都傳送相同的文字）。
   • 右側 — 您要傳送的詢價表單欄位，或您輸入的固定文字。

   因此，您是在右側選擇詢價表單的值，來填入左側指定的 HubSpot 欄位，而不是反過來。

   電子郵件那一列是不能略過的，沒有它就無法建立聯絡人。如果您的表單有收集 Company information，也請對應公司名稱，讓業務可以看到是誰在詢問。如果 HubSpot 表單上的某個欄位被標示為必填，而您沒有對應，應用程式會標示該列並拒絕儲存。

   

7. 儲存

   選取 Save。在儲存之前不會保存任何內容，未儲存的頁面也不會傳送任何資料。

   當您有未儲存的變更時，應用程式會顯示含有 Save 和 Discard changes 的儲存列，Discard changes 會捨棄您在頁面上輸入的所有內容。儲存成功後會顯示 Changes saved 訊息。

注意

Mailchimp 有同樣欄位對應表格的特寫說明。請僅參考其中的對應部分，因為 Mailchimp 只需要一個 API 金鑰並選擇清單，而 HubSpot 還需要 Portal ID，並且是選擇表單。

步驟 3 — 測試

從您的商店前台提交一筆真實的詢價請求，然後到 HubSpot 檢查新的聯絡人。請確認您所對應的欄位都確實送達，而不只是電子郵件地址。

警告

請不要略過測試。如果欄位對應錯誤，連線即使看起來已啟用，也可能沒有傳送任何有用的資料，而且在您實際使用這些資料之前都不會發現。

這是適合的工具嗎？

如果報價是由業務團隊而不是行銷團隊處理，這會是正確的選擇。

如果您原本沒有在使用 HubSpot，請不要只為了這個用途而採用，Zapier 幾乎可以將詢價資料連接到任何服務，而提交後建立 Shopify 顧客則能在 FREE 方案下讓一切都留在 Shopify 內。

如果聯絡人沒有送達

• 檢查私人應用程式的權限範圍。forms、crm.objects.contacts.write 和 crm.schemas.contacts.write 都必須授予。沒有這些權限範圍的權杖可以順利儲存，但不會傳送任何資料。這是最常見的原因。
• **檢查 Enable 是否仍然開啟。**關閉時不會傳送任何資料。
• **除了權杖，也要檢查 Portal ID。**權杖正確，但 Portal ID 遺漏或輸入錯誤，會使連線只完成一半，應用程式無法載入您的表單，因此不會傳送任何資料。
• **檢查權杖是否仍然有效。**在 HubSpot 中輪替權杖後，連線會中斷，直到您貼上新的權杖為止。已儲存的權杖會以遮罩方式顯示，如有疑慮，請貼上新的權杖。
• **檢查您是否選對了表單。**聯絡人可能已送到您沒有查看的地方。
• **檢查電子郵件那一列是否已對應。**沒有它就無法建立聯絡人。

仍然無法解決？請寄電子郵件至 [email protected]。

後續步驟

• 整合總覽 — 您可以連接的其他工具
• 建立 B2B 表單 — 收集值得傳送到 CRM 的公司詳細資料
• 方案比較 — PRO 方案包含的內容