使用 HubSpot Agent CLI
上次更新時間： 2026年9月29日
HubSpot Agent CLI 可將 AI 程式設計代理程式（例如ChatGPT 應用程式、Claude 應用程式及Claude Code中的代理程式）與您的 HubSpot 帳戶連接。 將 Agent CLI 連接到 HubSpot 後，您可以要求 AI 代理執行重複性的 CRM 任務、分析資料、生成摘要，並協助管理您帳戶中的各項流程。當您將任務委派給 AI 代理時，它們可以透過 Agent CLI 代表您自動化例行工作，讓您的團隊能將更多時間投入於策略性計畫。
舉例來說，您無需每週手動審查記錄，而是可以要求 AI 代理根據 HubSpot 中的資訊，識別不完整的記錄、彙整銷售管道活動，或準備客戶帳戶審查報告。
若您是開發人員，希望撰寫自訂腳本或在終端機上手動使用 HubSpot Agent CLI，請參閱HubSpot 的開發人員文件。
開始之前
在開始使用 HubSpot Agent CLI 之前，請確保您擁有 AI 程式設計代理的存取權限。支援的代理包括ChatGPT 應用程式、Claude 應用程式、Claude Code 以及許多其他相容的 AI 程式設計代理。
請注意：若您在團隊（Team）或企業（Enterprise）帳戶中使用 Claude Cowork，您的組織管理員可能需要將api.hubapi.com加入白名單，CLI 才能安裝或執行。進一步了解如何在 Claude Cowork 中加入白名單。
何時使用 HubSpot Agent CLI
Agent CLI 適用於需要檢視大量 CRM 資料的重複性或定期營運工作。這包括執行每週銷售管道審查、批量更新記錄，或在每月例會後向團隊發送預定摘要等任務。查看更多使用案例範例。
若您希望針對 HubSpot 資料提出一次性問題或草擬內容，可選擇「Claude 的 HubSpot 連接器」或「ChatGPT 的 HubSpot 連接器」，這兩種方案均無需安裝 CLI。
AI 代理程式可透過 HubSpot Agent CLI 存取哪些內容
HubSpot Agent CLI 可利用已連線 HubSpot 使用者的權限執行操作。根據您的使用者權限，這可能包括在您的帳戶中建立、更新或刪除記錄。
連接 HubSpot Agent CLI 後，AI 代理程式可處理您 HubSpot 帳戶中的各項資訊，包括：
- 聯絡人、公司、交易、服務單、自訂物件及其他 CRM 記錄。
- 工作流程。
- 銷售管道與銷售管道階段。
- 屬性與自訂屬性。
- 營收記錄（唯讀）：合約、發票、訂單、付款、報價單、報價單範本及訂閱（BETA）。
- 記錄之間的關聯。
- 活動歷史紀錄。
請注意：在對您的 CRM 資料進行變更前，請務必審閱 AI 生成的建議與提案。
最佳實務
當您使用已連線至 HubSpot 的 AI 代理時：
- 在執行會修改資料的操作之前，請先從報表、摘要和分析任務著手。
- 在設定排程或重複性任務時，請先從單一且範圍狹窄的使用案例開始，再逐步擴展至更廣泛的自動化。
- 在套用變更之前，請先檢視生成的建議及大規模更新。
- 某些操作可能會刪除或覆寫 HubSpot 資料。若可用，請在套用變更前使用--dry-run選項預覽變更。
- 請使用清晰且具體的提示語來描述預期結果。
- 請遵循貴組織的資料治理與資安政策。
連接 HubSpot Agent CLI
請依照以下步驟指示您的代理程式安裝 HubSpot Agent CLI。若您是開發人員，請進一步了解如何手動安裝 HubSpot Agent CLI。
- 開啟您的 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.
- 當系統提示時，請登入您的 HubSpot 帳戶。
- 檢視所請求的權限。
- 點擊「連接應用程式」。
完成驗證後，AI 代理程式即可根據您的權限存取 HubSpot 資料。
使用案例範例
以下範例展示不同團隊如何運用透過 HubSpot Agent CLI 連接的 AI 代理程式。
行銷團隊
| 任務 | AI 代理人的提示範例 |
| 識別需要跟進或資料清理的聯絡人。 | 每週一上午 8 點，找出符合高匹配度條件、但未關聯任何交易、近期無銷售活動，或缺少關鍵資料豐富化欄位的聯絡人，然後向 RevOps 發送一份按優先順序排列的資料清理清單，並附上建議的後續行動。 |
| 檢視電子郵件行銷活動，找出不符合品牌語調指南的主旨行和行動呼籲（CTA）。 | 檢視我最近的 10 個電子郵件行銷活動，並標記不符合品牌語調指南的主旨行或行動呼籲。請列出每個問題，並包含行銷活動名稱、被標記的內容以及建議的修訂方案。 |
| 識別高成效著陸頁中與較高轉換率相關的訊息模式。 | 根據轉換率分析我表現最佳的著陸頁。找出常見的訊息模式，例如標題結構、CTA 措辭或優惠類型，並總結其共同點。 |
| 建立一份重新互動名單，包含在培育序列中未開啟電子郵件的聯絡人。 | 找出目前已加入培育序列，且過去 30 天內未開啟任何電子郵件的所有聯絡人。建立一個包含其姓名、公司、生命週期階段及最後活動日期的受眾區段。 |
| 追蹤來自網路研討會活動的商機當前銷售管道狀態。 | 找出所有潛在客戶來源為「網路研討會」的交易，並顯示其當前銷售管道階段、負責人、金額及最後活動日期。彙整其中處於「活躍」、「停滯」或「已關閉」狀態的數量。 |
| 識別最符合條件的客戶在產業、公司規模及潛在客戶來源方面的模式。 | 檢視我過去 12 個月內已成交的交易，並彙整最常見的產業、公司規模及潛在客戶來源組合。標示任何有助於優化理想客戶輪廓的模式。 |
| 監控活躍的自動化序列，並標記電子郵件開啟率出現顯著下滑的情況。 | 檢查所有活躍的自動化序列，並比較最近兩週與前兩週的開啟率。標記開啟率下降超過 20% 的序列，並包含序列名稱、當前開啟率及先前開啟率。 |
銷售與營收營運團隊
| 任務 | AI 代理的範例提示 |
| 監控銷售管道狀況，並識別需要關注的交易。 | 每天早上 7 點，檢查我的銷售管道中本週即將成交、但過去 5 天內無任何活動的交易，並將摘要發送給我。 |
| 找出需要跟進與審查的停滯高價值交易。 | 找出所有金額超過 $[amount] 且過去 14 天內無任何活動的未結案交易。依交易金額排序，並包含交易名稱、負責人、成交日期及最近一次活動紀錄。 |
| 為客戶會議做準備，請彙整交易、支援、電子郵件及備註的歷史紀錄。 | 我明天將與 [公司名稱] 舉行會議。請彙整該公司的未結案及近期已成交案件、最近 5 筆支援單、近期電子郵件往來，以及過去 60 天內記錄的任何備註。 |
| 分析延遲成交的交易，以找出商機滯留時間最長的銷售管道階段。 | 檢視上季度未如期成交的交易。針對每筆交易，顯示其在哪個銷售管道階段停留時間最長，並找出交易最常停滯的兩至三個階段。 |
| 針對即將到期但近期無活動的交易，生成每日摘要。 | 每天上午 8 點，找出將於未來 7 天內成交、且過去 3 天內無任何活動的交易。請將包含交易名稱、負責人、金額、成交日期及最近活動類型的摘要發送給我。 |
銷售主管
| 任務 | AI 代理的範例提示語 |
| 分析通話記錄，找出教練指導與產品回饋的主題。 | 分析近期通話記錄中的通話時間、競爭對手提及、客戶回饋及潛在客戶猶豫等主題，並建立包含通話記錄範例及原始通話連結的輔導與產品回饋儀表板。 |
| 識別通話時間模式異常偏高或偏低的業務代表或團隊。 | 分析過去 30 天的通話記錄，並計算每位業務代表的平均通話時間比例。標記比例高於 70% 或低於 30% 的對象，並針對每位標記對象附上通話記錄摘錄範例。 |
| 找出近期銷售通話中反覆出現的競爭對手提及內容。 | 檢視過去 60 天的通話記錄，並找出被提及次數最多的競爭對手。針對每個競爭對手，顯示有多少通電話提及該對手、出現在哪些交易階段，以及一段引述範例。 |
| 依客群、交易階段或產品領域，彙整潛在客戶猶豫的主題。 | 檢視近期通話紀錄，找出顯示潛在客戶猶豫或異議的措辭。將主題依交易階段與潛在客戶區段分組，並彙整前 5 大猶豫模式，附上範例引述。 |
| 萃取能佐證輔導或產品回饋主題的通話紀錄範例。 | 從過去 30 天的通話紀錄中，找出 3 至 5 個有效探詢問題的範例，以及 3 至 5 個錯失處理異議時機的範例。請包含業務代表姓名、通話日期，以及每個範例的直接引述。 |
| 建立一個儀表板，將通話洞察與原始記錄及通話紀錄相互連結。 | 建立一個輔導儀表板，彙整過去 30 天通話中的通話時間比例、競爭對手提及次數及異議主題。針對每項洞察，請包含連結至原始通話及相關交易紀錄的連結。 |
營收營運（RevOps）與 CRM 管理員
| 任務 | AI 代理人的範例提示 |
| 清理 CRM 屬性，同時確保不影響下游資產。 | 找出重複或已廢棄的 CRM 屬性，並顯示它們在工作流程、報表和檢視中的使用位置。接著預覽清理方案，以替換、移除或重新排序欄位，再套用變更。 |
| 識別在不同物件中收集相同資訊的重複屬性。 | 掃描所有聯絡人、公司及商機屬性，並標記任何看似以不同名稱收集相同資訊的屬性。列出屬性名稱、其對應的物件，以及每組重複屬性對的建議處理方式。 |
| 找出仍出現在工作流程、報表、檢視或記錄佈局中的已廢棄欄位。 | 找出過去 12 個月內未曾更新，但仍出現在活躍工作流程、已儲存報表、清單檢視或記錄卡版面配置中的所有 CRM 屬性。在進行任何變更前，先顯示每個屬性的使用位置。 |
| 在進行變更前，預覽移除或替換 CRM 屬性所造成的影響。 | 我想移除屬性 [屬性名稱]。在進行任何變更之前，請顯示所有使用該屬性的工作流程、報表、清單及記錄佈局，並預覽哪些功能會因此失效或需要更新。 |
| 重新排列記錄欄位，讓管理員和業務代表能優先看到最重要的資訊。 | 針對聯絡人記錄佈局，請將以下欄位移至屬性側邊欄頂端：[欄位 1]、[欄位 2]、[欄位 3]。套用變更前請先預覽。 |
| 產生清理摘要，顯示已變更的內容以及仍需審查的項目。 | 完成 CRM 屬性清理後，請生成一份摘要，列出所有已移除、替換或重新命名的屬性、已更新的資產，以及仍需手動審查的欄位清單。 |
營運團隊
| 任務 | AI 代理人的範例提示 |
| 整合相關的支援單，並保留清理歷史紀錄。 | 彙整重複的支援票證，保留原始票證的詳細資訊，將每張父票證導向正確的流程階段，並向團隊發送一份清理摘要，其中包含仍需審核的任何記錄。 |
| 找出同一客戶或同一問題類型的重複或相關支援單。 | 找出來自同一公司、且建立時間相隔不超過 30 天的所有未結支援單。將它們依公司及問題類型分組，並標記任何看似重複的支援單。 |
| 將工單內容合併至父記錄中，同時保留來源詳細資訊。 | 針對上述識別出的重複工單，在關閉重複工單之前，將各來源工單的描述、聯絡紀錄及備註合併至父記錄的備註欄中。 |
| 根據當前狀態，將整合後的工單導向正確的流程階段。 | 針對每個整合後的父工單，檢查其當前狀態並將其移至正確的流程階段：未解決的工單移至「進行中」、等待回覆的工單移至「等待客戶回覆」，已解決的工單則移至「已關閉」。 |
| 在整合前，標記需要人工審查的工單。 | 在合併任何工單之前，請標記那些存在未解決付款爭議、SLA 計時器正在運行，或備註中標記為「升級」的記錄。請勿合併這些工單，而是將其列出以供人工審查。 |
| 發送一份清理摘要，內容包含已合併的記錄、未解決的問題以及後續跟進負責人。 | 工單整合完成後，請向支援團隊負責人發送一份摘要，列出所有已建立的父工單、合併至其中的來源工單、任何需要跟進的未解決問題，以及各後續步驟的負責人。 |
支援團隊
| 任務 | AI 代理的範例提示語 |
| 檢視客戶歷史紀錄，無需手動開啟多筆紀錄。 | 從該聯絡人處擷取最近 5 張工單，彙整每項解決方案，並標記任何反覆出現的問題模式。 |
| 在開啟新案件前，檢視近期工單紀錄並識別客戶反覆出現的問題。 | 在為 [聯絡人] 建立新服務單之前，請擷取該聯絡人的最近 10 筆服務單，彙整每筆的解決方式，並標記任何出現超過一次的問題。請包含服務單的主題、狀態及解決日期。 |
| 將超過預期回應時間的服務單列為優先處理項目。 | 找出所有在預期 SLA 時限內尚未收到回覆的未結工單。依逾期天數排序，並包含工單負責人、聯絡人姓名及最後活動日期。 |
| 分析與帳單相關的工單，以找出客戶聯繫支援服務的最常見原因。 | 檢視過去 90 天內所有標記為「帳單相關」類別的工單。根據數量排序，彙整客戶聯繫支援的前 5 大原因，並包含每項原因的平均解決時間。 |
| 根據相關交易、訂閱及升級處理紀錄，準備服務單回覆內容。 | 針對工單 [工單編號]，調取該聯絡人相關的交易歷史紀錄、當前訂閱詳情，以及任何過往的升級處理備註。彙整相關背景資訊，並草擬能解決客戶問題的回覆內容。 |
客戶成功團隊
| 任務 | AI 客服的範例提示語 |
| 利用來自多個 HubSpot 工具的資訊，準備帳戶審查報告。 | 針對本週的客戶帳戶審查，請彙整我負責業務範圍內每個帳戶的未結交易、近期支援活動，以及最近的 NPS 分數。 |
| 識別出具有高流失風險指標的客戶帳戶。 | 檢視我負責的客戶名單，並標記任何符合以下兩項或以上徵兆的客戶：產品登入頻率下降、未解決的支援單超過 14 天、NPS 分數低於 7，或過去 30 天內無客戶成功經理（CSM）活動。請依風險等級進行排序。 |
| 找出產品參與度較低的續約聯絡人，以便主動聯繫。 | 找出所有將於未來 60 天內續約的帳戶中，且過去 21 天內未登入產品的聯絡人。建立一份包含聯絡人姓名、帳戶、續約日期及最後登入日期的優先聯繫清單。 |
| 彙整近期銷售、支援及客戶回饋活動，以準備客戶帳戶審查報告。 | 針對 [客戶名稱]，彙整過去 6 個月的所有交易活動、未結及近期已結案的支援單，以及任何 NPS 或 CSAT 回饋。請將此內容整理成 QBR 會議前的簡報，以便我與客戶團隊分享。 |
| 透過比較客戶成長趨勢與歷史交易規模，找出業務擴展機會。 | 檢視我負責的客戶名單中，過去一年內員工人數或營收有所增長的客戶。將其當前交易規模與類似客戶的擴張規模進行比較，並標記前 10 名作為潛在的擴展機會。 |
保持技能庫的更新
HubSpot 客服代理 CLI 技能提供預先定義的指引，協助 AI 客服代理處理 HubSpot 資料及常見的 HubSpot 流程。技能庫包含 CRM 搜尋、批次操作、資料品質任務、工作流程、報表編製及其他營運活動的指引。
您可以在公開的 GitHub 儲存庫中檢視即將安裝的技能。
若要更新您 AI 代理程式工作區中的技能庫，請執行以下指令：
npx skills update
管理 HubSpot Agent CLI 的存取權限
超級管理員可以管理哪些使用者被允許連接 HubSpot Agent CLI。若使用者沒有連接 HubSpot Agent CLI 的權限，則必須在連接前向超級管理員提出批准請求。
相關內容
