기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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 계정입니다.
+ HubSpot 계정의 연락처, 회사, 거래 및 티켓을 포함한 CRM 데이터에 액세스할 수 있는 권한.
+ 에 설명된 요구 사항을 충족하는 구독입니다[콘솔에서 통합 설정](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 Auth 앱이 필요합니다.

### MCP 인증 앱을 구성하려면
<a name="hubspot-configure-oauth"></a>

1. HubSpot 계정에 로그인합니다.

1. **개발**로 이동한 다음 **MCP 인증 앱으로** 이동합니다.

1. **MCP 인증 앱 생성을** 선택합니다.

1. **MCP 인증 앱 생성** 창에서 다음 필드를 작성합니다.
   + **이름** - 앱의 이름을 입력합니다.
   + **설명** - 간단한 설명을 입력합니다.
   + **리디렉션 URL** -를 입력합니다`https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback`. {{region}}을 AWS 리전으로 바꿉니다. 예: `us-east-1`.

1. **생성(Create)**을 선택합니다. HubSpot은 앱을 생성하고 클라이언트 ID와 클라이언트 보안 암호를 생성합니다.
**중요**  
클라이언트 보안 암호와 클라이언트 ID를 기록합니다.

Amazon Quick에서 사용자 지정 OAuth 앱 인증 방법을 사용하여 작업 커넥터를 구성할 때 클라이언트 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 사용 가능한 작업**  

| 작업 | 설명 | 
| --- | --- | 
| 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) 로그인할 수 있는지 확인합니다. 조직에서 SSO(Single Sign-On)를 사용하는 경우 자격 증명 공급자가 올바르게 구성되었는지 확인합니다.
+ **액세스 거부** - HubSpot 사용자에게 CRM 데이터에 액세스할 권한이 있는 관리자 역할이 있는지 확인합니다. 앱의 클라이언트 ID와 클라이언트 보안 암호가 올바르고 필요한 읽기 범위가 구성되어 있는지 확인합니다.