測試版使用 HubSpot Agent CLI

HubSpot Agent CLI 可將 AI 程式設計助理（例如Claude Code、Claude Cowork 及OpenAI Codex）與您的 HubSpot 帳戶連接起來。 將 Agent CLI 連接到 HubSpot 後，您可以要求 AI 助理完成重複性的 CRM 任務、分析資料、生成摘要，並協助管理您帳戶中的各項流程。當您將任務委派給 AI 助理時，牠們可以透過 Agent CLI 代表您自動化處理例行工作，讓您的團隊能將更多時間投入於策略性計畫。

舉例來說，您無需每週手動審查記錄，而是可以要求 AI 代理根據 HubSpot 中的資訊，識別不完整的記錄、彙整銷售管道活動，或準備客戶帳戶審查報告。

若您是開發人員，希望撰寫自訂腳本或在終端機上手動使用 HubSpot Agent CLI，請參閱我們的開發人員文件。

開始之前

在開始使用 HubSpot Agent CLI 之前，請確保您擁有 AI 程式設計代理的存取權限。支援的代理包括 Claude Code、Claude Cowork、OpenAI Codex 以及許多其他相容的 AI 程式設計代理。

請注意：若您在「團隊」或「企業」帳戶中使用 Claude Cowork，您的組織管理員可能需要將api.hubapi.com加入白名單，CLI 才能進行安裝或執行。進一步了解Claude Cowork 中的白名單設定。

HubSpot Agent CLI 可存取哪些 AI 代理程式

HubSpot Agent CLI 可利用已連線的 HubSpot 使用者權限執行各項操作。根據您的使用者權限，這可能包含在您的帳戶中建立、更新或刪除記錄。

連接 HubSpot Agent CLI 後，AI 代理程式即可處理您整個 HubSpot 帳戶中的資訊，包括：

• 聯絡人、公司、商機、服務單、自訂物件及其他 CRM 記錄。
• 工作流程。
• 銷售管道及銷售管道階段。
• 屬性與自訂屬性。
• 記錄之間的關聯。
• 活動歷史紀錄。

請注意：在對您的 CRM 資料進行變更前，請務必審閱 AI 生成的建議與擬議動作。

最佳實務

當您使用連接到 HubSpot 的 AI 代理時：

• 請先從報表、摘要和分析任務著手，再使用會修改資料的操作。
• 在套用變更前，請先審閱生成的建議及大規模更新。
• 某些操作可能會刪除或覆寫 HubSpot 資料。若功能支援，請在套用變更前使用--dry-run 選項預覽變更。
• 請使用清晰明確的提示語來描述預期結果。
• 請遵循貴組織的資料治理與資安政策。

連接 HubSpot Agent CLI

請依照以下步驟，指示您的代理程式安裝 HubSpot Agent CLI。若您是開發人員，請進一步了解如何手動安裝 HubSpot Agent CLI。

1. 開啟您的 AI 代理程式，例如Cowork或Codex。
2. 將以下提示語貼入您的 AI 代理程式工作區，以安裝 Agent CLI。

Install the HubSpot Agent CLI in this agent workspace. If this workspace uses a POSIX shell (macOS, Linux, WSL, or Bash), run `curl -fsSL https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.sh | sh`. If it uses Windows PowerShell, run `irm https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.ps1 | iex`. Then authenticate with `hubspot auth login`, install HubSpot Agent CLI Skills with `npx skills add hubspot/agent-cli-skills`, and use `hubspot --help` to explore what's available.

3. 出現提示時，請登入您的 HubSpot 帳戶。
4. 檢視所請求的權限。
5. 點擊「連接應用程式」。

驗證完成後，AI 助理即可根據您的權限存取 HubSpot 資料。

要開始使用，請選用以下其中一個範例提示。

使用案例範例

以下範例展示不同團隊如何運用透過 HubSpot Agent CLI 連接的 AI 代理程式。此代理程式特別適用於需要審閱大量 CRM 資料的重複性營運工作。

行銷團隊

任務：識別需要後續跟進或資料清理的聯絡人。

AI 代理的提示範例：每週一上午 8 點，找出符合高匹配度條件、但未關聯任何交易、近期無銷售活動，或缺少關鍵資料豐富化欄位的聯絡人，然後向 RevOps 發送一份按優先順序排列的清理清單，並附上建議的後續行動。

其他範例包括：

• 檢視電子郵件行銷活動，找出不符合品牌語調指南的郵件主旨和行動呼籲（CTA）。
• 識別高成效著陸頁中與更高轉換率相關的訊息模式。
• 建立一份重新互動名單，納入在培育序列中未開啟電子郵件的聯絡人。
• 追蹤來自網路研討會活動所產生的商機當前銷售管道狀態。
• 分析最符合條件的客戶群中，其產業、公司規模及潛在客戶來源的模式。
• 監控活躍的電子郵件序列，並針對電子郵件開啟率出現顯著下滑的情況進行標記。

銷售與營收營運團隊

任務：監控銷售管道健康狀況，並識別需要關注的交易。

AI 助理的提示範例：每天早上 7 點，檢查我的銷售管道中本週即將成交、且過去 5 天內無任何活動的交易，並將摘要發送給我。

其他範例包括：

• 找出需要跟進與審查的停滯高價值交易。
• 透過彙整交易、支援、電子郵件及備註歷史紀錄，為客戶會議做好準備。
• 分析延遲成交的交易，以找出商機在銷售管道中滯留最久的階段。
• 針對即將到期但近期缺乏活動的交易，生成每日摘要。

銷售主管

任務：分析通話記錄，找出教練指導與產品回饋的主題。

AI 代理人的提示範例：分析最近的通話記錄，找出通話時間、競爭對手提及、客戶回饋及潛在客戶猶豫的主題，然後建立一個包含通話記錄範例及原始通話連結的輔導與產品回饋儀表板。

其他範例包括：

• 識別通話時間模式異常偏高或偏低的業務代表或團隊。
• 找出近期銷售通話中反覆出現的競爭對手提及內容。
• 依客群、交易階段或產品領域，彙整潛在客戶猶豫的主題。
• 擷取能佐證輔導或產品回饋主題的通話紀錄範例。
• 建立一個儀表板，將通話洞察與原始記錄及通話紀錄相互連結。

營運（RevOps）與 CRM 管理員

任務：清理 CRM 屬性，同時確保不影響下游資產。

AI 代理的提示範例：找出重複或已廢棄的 CRM 屬性，並顯示它們在工作流程、報表和檢視中的使用位置。接著預覽清理方案，以在套用變更前替換、移除或重新排序欄位。

其他範例包括：

• 識別在不同物件中收集相同資訊的重複屬性。
• 找出仍出現在工作流程、報表、檢視或記錄佈局中的已廢棄欄位。
• 在進行變更前，預覽移除或替換 CRM 屬性所產生的影響。
• 重新排序記錄欄位，讓管理員和業務代表能優先看到最重要的資訊。
• 產生清理摘要，顯示哪些項目已變更以及哪些仍需審查。

營運團隊

任務：整合相關的支援單，並保留清理歷史紀錄。

AI 代理人的範例提示：整合重複的支援票證，保留原始票證的詳細資訊，將每張父票證導向正確的流程階段，並向團隊發送包含仍需審查記錄的清理摘要。

其他範例包括：

• 找出同一客戶或問題類型的重複或相關支援票證。
• 將工單背景資訊合併至父工單記錄中，同時保留原始詳情。
• 根據當前狀態，將整合後的工單路由至正確的流程階段。
• 在整合前標記需要人工審查的工單。
• 發送清理摘要，其中包含已合併的記錄、未解決的問題以及後續跟進負責人。

支援團隊

任務：無需手動開啟多筆紀錄，即可檢視客戶歷史紀錄。

AI 代理的提示範例：調取此聯絡人的最近 5 張工單，彙整每項解決方案，並標記任何反覆出現的問題模式。

其他範例包括：

• 在開啟新案件前，檢視近期服務單歷史紀錄並識別客戶反覆出現的問題。
• 將超過預期回應時間的服務單列為優先處理項目。
• 分析與帳單相關的服務單，以找出客戶聯繫支援服務的最常見原因。
• 根據相關交易、訂閱及升級處理紀錄，準備服務單回覆內容。

客戶成功團隊

任務：利用來自多個 HubSpot 工具的資訊，準備帳戶審查報告。

AI 代理的提示範例：針對我本週的帳戶審查，請彙整我業務範圍內每個帳戶的未結交易、近期支援活動，以及最近的 NPS 分數。

其他範例包括：

• 識別出存在較高流失風險跡象的客戶帳戶。
• 找出產品參與度較低的續約聯絡人，以便主動聯繫。
• 透過彙整近期銷售、支援及客戶回饋活動，準備客戶帳戶審查報告。
• 透過比較客戶帳戶的成長趨勢與歷史交易規模，找出業務擴展機會。

保持技能庫的更新

HubSpot Agent CLI 技能提供預先定義的指引，協助 AI 代理程式處理 HubSpot 資料及常見的 HubSpot 流程。技能庫包含 CRM 搜尋、批次操作、資料品質任務、工作流程、報表編製及其他營運活動的指引。

您可以在公開的 GitHub 儲存庫中檢視即將安裝的技能。

若要更新您 AI 代理工作區中的技能庫，請執行以下提示：

npx skills update

進一步了解如何在Claude和OpenAI Codex 中使用技能。

管理 HubSpot Agent CLI 的存取權限

超級管理員可透過加入「應用程式安裝治理」測試版，管理哪些使用者被允許連線至 HubSpot Agent CLI。

若使用者無權連接 HubSpot Agent CLI，則必須在連接前向管理員申請批准。

進一步了解如何管理可在您的 HubSpot 帳戶中安裝的應用程式。