HubSpot 應用指南

OOMOL 支援你連接一次 HubSpot，然後把經過授權的 HubSpot CRM 工具提供給你已經在使用的 AI Agent 和可重複使用的 Skills。本文說明如何新增 HubSpot 應用、OOMOL 會使用哪些權限、可以用它完成什麼、常見問題如何排查，以及如何移除應用。

前置條件

• 一個 OOMOL 帳號。
• 一個允許授權第三方應用的 HubSpot 帳號。
• 可以存取 OOMOL Console。
• 在 HubSpot 中擁有授權 CRM object 和 CRM schema scopes 的權限。
• 如果你要測試搜尋、讀取或更新工具，需要準備測試聯絡人、公司和交易記錄。
• 如果你的 HubSpot 組織限制第三方應用，可能需要 HubSpot 管理員先允許 OOMOL 應用。

新增應用

1. 登入 OOMOL Console。
2. 開啟 連接服務，或直接存取 Connections。
3. 搜尋 HubSpot。
4. 選擇 HubSpot，然後點擊 Connect。
5. OOMOL 會跳轉到 HubSpot。如有提示，請登入 HubSpot。
6. 檢查 HubSpot 授權頁面，包括請求的 CRM 權限。
7. 選擇你要連接的 HubSpot 帳號。
8. 點擊 Connect app，或 HubSpot 頁面中顯示的等效授權操作。
9. HubSpot 跳回 OOMOL 後，確認 HubSpot 已顯示為已連接。

如果任一步驟失敗，請查看常見問題排查。

授權後，OOMOL 會儲存呼叫 HubSpot 工具所需的連接資訊。之後，你就可以在 OOMOL 支援的 Agent、可重複使用的 Skills 和工作流中使用 HubSpot 工具。

使用方式

HubSpot 工具需要先連接 HubSpot 帳號後才能使用。OOMOL 中展示的具體工具列表可能隨 connector 更新而變化；目前 HubSpot connector 支援讀取 CRM 屬性定義，以及搜尋、讀取、建立、更新 contacts、companies 和 deals。

透過 oo CLI 使用 HubSpot 工具

如果你要在支援的 AI Agent 環境中使用已連接的 HubSpot 工具，請在登入 OOMOL 後安裝並設定 oo CLI。

1. 登入 OOMOL Console。
2. 開啟 oo CLI 安裝頁面。
3. 按照頁面中的說明操作。該頁面會提供一鍵複製的提示詞，用於在支援的 AI Agent 環境中安裝並設定 oo CLI。
4. 完成 oo CLI 設定，並在 OOMOL 中連接 HubSpot 後，就可以讓 Agent 使用已連接的 HubSpot CRM 工具處理 demo CRM data。

具體 prompt 可以根據 Agent 環境調整。例如，你可以讓 Agent 建立 demo contact、按 email 搜尋該 contact、更新 job title 等可編輯欄位，或列出 HubSpot CRM properties。

使用的權限

OOMOL 使用這些 HubSpot scopes，讓已授權的 HubSpot 使用者可以把 HubSpot 作為一個 App 連接到 OOMOL，然後把經過授權的 CRM 工具提供給 Agent 和可重複使用的 Skills。

Required scopes：

支援的 HubSpot 工具

搜尋和讀取 CRM 記錄

使用情境：讓 Agent 在客戶電話、交接、研究任務或後續跟進前，找到正確的 HubSpot contact、company 或 deal。

前置條件：

• 已在 OOMOL 中連接 HubSpot。
• 已連接的 HubSpot 帳號有權限讀取請求的 CRM object。
• Agent 或工作流已經取得搜尋關鍵詞、篩選條件、record ID 或唯一屬性值。

工具行為：

• 搜尋或讀取已連接 HubSpot 帳號可存取的 contacts、companies 和 deals。
• 在可用時傳回工具輸入請求的 HubSpot 欄位。
• 唯讀操作不會建立、更新或刪除記錄。

建立 CRM 記錄

使用情境：讓 Agent 根據使用者提供的資訊建立 HubSpot contact、company 或 deal，例如新的客戶、帳號或機會。

前置條件：

• 已在 OOMOL 中連接 HubSpot。
• 已連接的 HubSpot 帳號有權限建立請求的 CRM object。
• Agent 或工作流已經取得新記錄所需的屬性。
• 如果包含關聯關係，關聯記錄必須有效，並且對已連接帳號可用。

工具行為：

• 根據輸入建立 HubSpot contact、company 或 deal。
• 傳回 HubSpot 提供的記錄資訊，例如 record ID 和選定屬性。
• 不會憑空編造缺失的 CRM 值。必填值必須由使用者、工作流或已連接資料來源提供。

更新 CRM 記錄

使用情境：當使用者要求修改某個 contact、company 或 deal 欄位時，讓 Agent 保持 HubSpot 記錄最新。

前置條件：

• 已在 OOMOL 中連接 HubSpot。
• 已連接的 HubSpot 帳號有權限更新請求的 CRM object。
• Agent 或工作流可以透過 HubSpot record ID 或自訂唯一屬性定位目標記錄。
• 更新後的值符合 HubSpot 屬性定義。

工具行為：

• 根據輸入更新支援的 HubSpot contact、company 或 deal 屬性。
• 傳回 HubSpot 提供的更新結果。
• 不會刪除記錄。

測試應用

你可以使用任意允許授權第三方應用的 HubSpot 帳號測試 HubSpot 應用。建議使用 demo contacts、companies 和 deals，這樣可以安全測試搜尋、建立和更新動作。

範例測試 prompts

• Create a HubSpot contact named Demo Contact with email demo-contact@example.com.
• Search HubSpot contacts for demo-contact@example.com.
• Get the HubSpot contact with email demo-contact@example.com.
• Update the HubSpot contact with email demo-contact@example.com and set the job title to Demo Buyer.
• Search HubSpot companies for Demo Company.
• Create a HubSpot company named Demo Company.
• Search HubSpot deals for Demo Deal.
• Create a HubSpot deal named Demo Deal with sample test values.
• Update the Demo Deal amount or close date.
• List HubSpot contact properties.
• Get the HubSpot contact property definition for email.

測試時請只使用 demo data，不要在測試 prompt 中使用真實客戶資料。

常見問題排查

無法新增 HubSpot 應用

• 確認你登入的是正確的 OOMOL 帳號。
• 確認你正在登入想要連接的 HubSpot 帳號。
• 確認 HubSpot 帳號允許請求的 CRM scopes。
• 如果 HubSpot 帳號屬於某個組織，請詢問 HubSpot 管理員：第三方應用是否需要審批。
• 如果 OOMOL 中已有失敗或不完整的 HubSpot 連接，先中斷它，再重新連接。
• 如果問題仍然存在，請聯絡 OOMOL 支援，並附上 OOMOL 帳號信箱、HubSpot 帳號或 portal ID、嘗試連接的時間、錯誤訊息或截圖。

HubSpot 工具找不到記錄

• 確認已連接的 HubSpot 帳號有權限存取請求的 contact、company 或 deal。
• 確認工作流使用了正確的 record ID、唯一屬性、搜尋關鍵詞或篩選條件。
• 檢查該記錄是否存在於已連接到 OOMOL 的 HubSpot 帳號中。
• 如果你最近調整過 HubSpot 權限，請在 OOMOL 中重新連接 HubSpot，以重新整理授權狀態。

HubSpot 工具無法建立記錄

• 確認已連接的 HubSpot 帳號可以直接在 HubSpot 中建立請求的 contact、company 或 deal。
• 檢查是否包含所有 HubSpot 必填屬性。
• 檢查提供的值是否符合 HubSpot 屬性定義。
• 如果包含關聯關係，確認關聯記錄和 association types 有效。

HubSpot 工具無法更新記錄

• 確認已連接的 HubSpot 帳號有權限更新請求的記錄。
• 確認工作流使用了正確的 HubSpot record ID 或自訂唯一屬性。
• 檢查更新欄位和值是否符合 HubSpot 要求。
• 如果某個屬性在 HubSpot 中是唯讀或受限屬性，請從更新請求中移除它，或直接在 HubSpot 中更新。

移除應用

你可以從 OOMOL 或 HubSpot 任一側移除 HubSpot 應用。如果你不再希望 OOMOL 存取 HubSpot，建議兩邊都移除。

從 OOMOL 移除 HubSpot

1. 登入 OOMOL Console。
2. 開啟 Connections。
3. 在已連接應用中找到 HubSpot。
4. 開啟 HubSpot 連接詳情。
5. 選擇 Disconnect、Remove，或 OOMOL 介面中顯示的等效移除操作。
6. 確認移除。

從 HubSpot 移除 OOMOL

1. 登入 HubSpot。
2. 開啟 Settings。
3. 開啟 Integrations，然後進入 Connected Apps。
4. 找到 OOMOL。
5. 選擇 uninstall、disconnect 或 remove app 的操作。
6. 確認移除。

移除後的影響

• 移除或取消授權 HubSpot 連接後，OOMOL 將無法再為你的帳號使用 HubSpot 工具。
• 依賴 HubSpot 的工作流、Agent 或 Skills 可能會失敗，直到你重新連接 HubSpot。
• 移除前已建立或更新的 HubSpot 記錄會保留在 HubSpot 中，除非你在 HubSpot 中修改或刪除這些記錄。
• 移除應用不會刪除你的 OOMOL 帳號。

資料處理

OOMOL 只會在 HubSpot 使用者授權應用，並且使用者或已批准的 Agent 動作需要使用 HubSpot 時存取 HubSpot 資料。OOMOL 只會為了提供透過 OOMOL 支援的 Agent、可重複使用的 Skills 和工作流請求的 HubSpot 工具而使用 HubSpot 資料。

• HubSpot OAuth tokens 會被加密儲存。
• OOMOL 不會向 AI Agent、提示詞、瀏覽器用戶端、應用程式碼或終端使用者暴露 HubSpot OAuth token。
• 當 HubSpot 工具被呼叫時，OOMOL 可能會處理 HubSpot contacts、companies、deals 和 CRM property metadata。
• HubSpot 資料只會在必要時儲存在使用者可見的工具結果、使用記錄、執行歷史或營運記錄中。
• 儲存的資料會靜態加密，並透過 TLS/SSL 傳輸。
• OOMOL 不會出售你的 HubSpot 資料。
• OOMOL 不會將 HubSpot 資料用於廣告。
• OOMOL 不會使用客戶私有內容訓練 AI 模型。
• 當你移除或取消授權 HubSpot 應用後，OOMOL 會停止使用已撤銷的 HubSpot 授權，並按照正常連接移除流程刪除或失效化已儲存的 HubSpot 授權 token。
• 某些日誌、支援記錄、安全記錄或帳務相關記錄可能會按照隱私權政策中的說明保留。

FAQ

OOMOL 會持續同步 HubSpot 資料嗎？

OOMOL 按需存取 HubSpot 資料：已授權使用者或已批准的 Agent 動作呼叫 HubSpot 工具時，才會讀取或修改對應資料。

連接後 Agent 會自動使用 HubSpot 嗎？

連接 HubSpot 會讓 HubSpot 工具在 OOMOL 中可用，但是否呼叫工具仍取決於你選擇的 Agent、工作流、Skill 和權限。基於帳號的服務仍然需要你的授權。

OOMOL 可以刪除 HubSpot 記錄嗎？

本文描述的目前 HubSpot connector 支援搜尋、讀取、建立和更新 contacts、companies 和 deals，不包含刪除記錄的工具。

可以連接多個 HubSpot 帳號嗎？

請在 OOMOL Console 中查看你的帳號或 workspace 目前支援的連接選項。如果你需要處理多個 HubSpot 帳號，可以聯絡支援團隊。

是否需要付費 HubSpot 帳號？

大多數 OOMOL HubSpot 工具需要一個可以授權請求的 CRM scopes 的 HubSpot 帳號。部分 HubSpot 功能、物件存取、屬性存取或管理員控制可能取決於你的 HubSpot 方案或組織設定。

聯絡支援

如果你在新增、使用、測試或移除 HubSpot 應用時需要協助，請聯絡 OOMOL 支援：

• 信箱：support@oomol.com
• 支援頁面：https://oomol.com/zh-tw/support/

請附上你的 OOMOL 帳號信箱、相關 HubSpot 帳號或 portal ID、你正在執行的操作，以及錯誤訊息或截圖。