本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# HubSpot 整合
<a name="hubspot-integration"></a>

使用自然語言直接從 Amazon Quick 存取 HubSpot CRM 資料。使用 HubSpot 動作連接器，您可以擷取和列出聯絡人、公司、交易和票證，而無需離開 Amazon Quick。

HubSpot 可在 Amazon Quick 中做為內建連接器使用。若要設定此整合，請完成下列兩個步驟。首先，準備具有所需存取權的 HubSpot 帳戶。然後，在 Amazon Quick 中建立連接器，並使用 HubSpot 登入資料進行驗證。

此連接器支援自訂 OAuth 應用程式身分驗證。如需有關 Amazon Quick 支援的身分驗證方法的資訊，請參閱 [身分驗證方法](quick-action-auth.md)。

## 先決條件
<a name="hubspot-integration-prerequisites"></a>

設定整合之前，請確認您擁有下列資源和存取權。
+ 具有管理員角色的作用中 HubSpot 帳戶。
+ 存取 CRM 資料的許可，包括 HubSpot 帳戶中的聯絡人、公司、交易和票證。
+ 符合 中所述需求的訂閱[在主控台中設定整合](integration-console-setup-process.md)。

## 驗證您的 HubSpot 帳戶
<a name="hubspot-account-setup"></a>

設定 Amazon Quick 之前，請確認您的 HubSpot 帳戶符合下列要求。
+ 您的 HubSpot 帳戶處於作用中狀態，您可以登入 [HubSpot 網站上的 HubSpot 登入頁面](https://app.hubspot.com/login)。 HubSpot 
+ 您的帳戶可存取您要存取的 CRM 資料，包括聯絡人、公司、優惠和票證。

## 設定您的 HubSpot 帳戶
<a name="hubspot-configure-account"></a>

Amazon Quick 中的自訂 OAuth 應用程式身分驗證方法需要在 HubSpot 開發人員設定中設定的 MCP 身分驗證應用程式。

### 設定 MCP 驗證應用程式
<a name="hubspot-configure-oauth"></a>

1. 登入您的 HubSpot 帳戶。

1. 導覽至**開發**，然後導覽至 **MCP 驗證應用程式**。

1. 選擇**建立 MCP 驗證應用程式**。

1. 在**建立 MCP 驗證應用程式**視窗中，完成下列欄位：
   + **名稱** – 輸入應用程式的名稱。
   + **描述** – 輸入簡短描述。
   + **重新導向 URL** – 輸入 `https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback`。將{{區域}}取代為您的 AWS 區域，例如 `us-east-1`。

1. 選擇**建立**。HubSpot 會建立應用程式，並產生用戶端 ID 和用戶端秘密。
**重要**  
記錄用戶端秘密和用戶端 ID。

當您使用自訂 OAuth 應用程式身分驗證方法在 Amazon Quick 中設定動作連接器時，用戶端 ID 和用戶端秘密會做為用戶端 ID 和用戶端秘密。

如需詳細資訊，請參閱 [HubSpot 網站上的 HubSpot MCP 伺服器](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)。 HubSpot 

## 在 Amazon Quick 中設定整合
<a name="hubspot-integration-setup"></a>

驗證 HubSpot 帳戶存取權後，請在 Amazon Quick 中建立連接器。

1. 在 Amazon Quick 主控台中，選擇**連接器**。

1. 選擇**為您的團隊建立**索引標籤。

1. 從可用的選項中選擇 **HubSpot**。

1. 在 **HubSpot** 對話方塊中，輸入下列欄位：
   + **名稱** – HubSpot 連接器的描述性名稱。
   + **描述 （選用）** – 選擇 **\+ 新增描述**，以新增如何使用此連接器的備註。
   + **連線類型** – 選擇**公有網路**。

1. 針對**自訂 OAuth 應用程式**身分驗證方法，輸入下列欄位：
   + **基本 URL** – 此欄位會自動填入為 `https://mcp.hubspot.com`。
   + **用戶端 ID** – 輸入 HubSpot MCP 驗證應用程式的用戶端 ID。
   + **用戶端秘密** – 從您的 HubSpot MCP 身分驗證應用程式輸入用戶端秘密。
   + **權杖 URL** – 此欄位會自動填入為 `https://api.hubapi.com/oauth/v1/token`。
   + **授權 URL** – 此欄位會自動填入為 `https://app.hubspot.com/oauth/authorize`。
   + **重新導向 URL** – 此欄位會自動填入為 `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`。

1. 選擇**下一步**，檢閱 HubSpot 的動作，然後再次選擇**下一步**。

1. 指定誰可以存取連接器：
   + 若要與團隊共用，請輸入團隊名稱或群組電子郵件。
   + 若要保持私有，請將 欄位保留空白。
   + 若要與所有使用者共用，請切換**組織中的每個人**。

1. 選擇**發布**。

連接器會出現在**可用**面板中，狀態為**已連線**。

## 使用可用的動作
<a name="hubspot-integration-actions"></a>

設定連接器之後，您可以使用下列唯讀動作來存取 HubSpot CRM 資料。


**HubSpot 可用的動作**  

| Action | 說明 | 
| --- | --- | 
| 取得 CRM 物件 | 在單一請求中擷取相同物件類型的多個 CRM 物件。 | 
| 取得屬性 | 擷取 CRM 物件的屬性。 | 
| 取得使用者詳細資訊 | 擷取使用者詳細資訊。 | 
| 搜尋 CRM 物件 | 搜尋 CRM 物件。 | 
| 搜尋擁有者 | 跨擁有者搜尋。 | 
| 搜尋屬性 | 跨屬性搜尋。 | 

**注意**  
此連接器支援唯讀動作。您可以使用的動作取決於 HubSpot 應用程式中設定的範圍。

## 疑難排解
<a name="hubspot-integration-troubleshooting"></a>

若要編輯、共用或刪除連接器，請參閱 [管理現有的整合](integration-workflows.md#managing-existing-integrations)。

### 解決身分驗證問題
<a name="hubspot-troubleshooting-auth"></a>
+ **登入失敗** – 確認您的 HubSpot 帳戶處於作用中狀態，而且您可以登入 [HubSpot 網站上的 HubSpot 登入頁面](https://app.hubspot.com/login)。 HubSpot 如果您的組織使用單一登入 (SSO)，請確認您的身分提供者已正確設定。
+ **存取遭拒** – 確認您的 HubSpot 使用者具有管理員角色，具有存取 CRM 資料的許可。確認應用程式的用戶端 ID 和用戶端秘密正確無誤，並已設定所需的讀取範圍。