View a markdown version of this page

HubSpot 통합 - Amazon Quick
사전 조건HubSpot 계정 확인HubSpot 계정 구성Amazon Quick에서 통합 설정사용 가능한 작업 사용문제 해결

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

HubSpot 통합

자연어를 사용하여 Amazon Quick에서 직접 HubSpot CRM 데이터에 액세스합니다. HubSpot 작업 커넥터를 사용하면 Amazon Quick을 떠나지 않고도 연락처, 회사, 거래 및 티켓을 검색하고 나열할 수 있습니다.

HubSpot은 Amazon Quick에서 내장 커넥터로 사용할 수 있습니다. 이 통합을 설정하려면 다음 두 단계를 완료합니다. 먼저 필요한 액세스 권한으로 HubSpot 계정을 준비합니다. 그런 다음 Amazon Quick에서 커넥터를 생성하고 HubSpot 자격 증명으로 인증합니다.

이 커넥터는 사용자 지정 OAuth 앱 인증을 지원합니다. Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.

사전 조건

통합을 설정하기 전에 다음 리소스와 액세스 권한이 있는지 확인합니다.

  • 관리자 역할이 있는 활성 HubSpot 계정입니다.

  • HubSpot 계정의 연락처, 회사, 거래 및 티켓을 포함한 CRM 데이터에 액세스할 수 있는 권한.

  • 에 설명된 요구 사항을 충족하는 구독입니다콘솔에서 통합 설정.

HubSpot 계정 확인

Amazon Quick을 구성하기 전에 HubSpot 계정이 다음 요구 사항을 충족하는지 확인합니다.

HubSpot 계정 구성

Amazon Quick의 사용자 지정 OAuth 앱 인증 방법에는 HubSpot 개발자 설정에 구성된 MCP Auth 앱이 필요합니다.

MCP 인증 앱을 구성하려면

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

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

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

  4. MCP 인증 앱 생성 창에서 다음 필드를 작성합니다.

    • 이름 - 앱의 이름을 입력합니다.

    • 설명 - 간단한 설명을 입력합니다.

    • 리디렉션 URL -를 입력합니다https://region.quicksight.aws.amazon.com/sn/oauthcallback. region을 AWS 리전으로 바꿉니다. 예: us-east-1.

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

    중요

    클라이언트 보안 암호와 클라이언트 ID를 기록합니다.

Amazon Quick에서 사용자 지정 OAuth 앱 인증 방법을 사용하여 작업 커넥터를 구성할 때 클라이언트 ID 및 클라이언트 보안 암호가 클라이언트 ID 및 클라이언트 보안 암호 역할을 합니다.

자세한 내용은 HubSpot 웹 사이트의 HubSpot MCP 서버를 참조하세요. HubSpot

Amazon Quick에서 통합 설정

HubSpot 계정 액세스를 확인한 후 Amazon Quick에서 커넥터를 생성합니다.

  1. Amazon Quick 콘솔에서 커넥터를 선택합니다.

  2. 팀에 대해 생성 탭을 선택합니다.

  3. 사용 가능한 옵션에서 HubSpot을 선택합니다.

  4. HubSpot 대화 상자에서 다음 필드를 입력합니다.

    • 이름 - HubSpot 커넥터의 설명 이름입니다.

    • 설명(선택 사항) - + 설명 추가를 선택하여이 커넥터의 사용 방법에 대한 메모를 추가합니다.

    • 연결 유형 - 퍼블릭 네트워크를 선택합니다.

  5. 사용자 지정 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.

  6. 다음을 선택하고 HubSpot에 대한 작업을 검토한 후 다음을 다시 선택합니다.

  7. 커넥터에 액세스할 수 있는 사용자를 지정합니다.

    • 팀과 공유하려면 팀 이름 또는 그룹 이메일을 입력합니다.

    • 비공개로 유지하려면 필드를 비워 둡니다.

    • 모든 사용자와 공유하려면 조직의 모든 사용자를 전환합니다.

  8. 게시를 선택합니다.

커넥터가 사용 가능 패널에 연결됨 상태로 나타납니다.

사용 가능한 작업 사용

커넥터를 설정한 후 다음 읽기 전용 작업을 사용하여 HubSpot CRM 데이터에 액세스할 수 있습니다.

HubSpot 사용 가능한 작업
작업 설명
CRM 객체 가져오기 단일 요청으로 동일한 객체 유형의 여러 CRM 객체를 가져옵니다.
속성 가져오기 CRM 객체의 속성을 가져옵니다.
사용자 세부 정보 가져오기 사용자 세부 정보를 가져옵니다.
CRM 객체 검색 CRM 객체를 검색합니다.
소유자 검색 소유자를 검색합니다.
검색 속성 여러 속성을 검색합니다.
참고

이 커넥터는 읽기 전용 작업을 지원합니다. 사용할 수 있는 작업은 HubSpot 앱에 구성된 범위에 따라 다릅니다.

문제 해결

커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

인증 문제 해결

  • 로그인 실패 - HubSpot 계정이 활성 상태이고 HubSpot 웹 사이트의 HubSpot 로그인 페이지에 로그인할 수 있는지 확인합니다. 조직에서 SSO(Single Sign-On)를 사용하는 경우 자격 증명 공급자가 올바르게 구성되었는지 확인합니다.

  • 액세스 거부 - HubSpot 사용자에게 CRM 데이터에 액세스할 권한이 있는 관리자 역할이 있는지 확인합니다. 앱의 클라이언트 ID와 클라이언트 보안 암호가 올바르고 필요한 읽기 범위가 구성되어 있는지 확인합니다.