HubSpot 앱 가이드

OOMOL에서는 HubSpot을 한 번 연결하면 이미 사용 중인 AI 에이전트와 재사용 가능한 Skills에 권한이 부여된 HubSpot CRM 도구를 제공할 수 있습니다. 이 가이드에서는 HubSpot 앱을 추가하는 방법, OOMOL이 사용하는 권한, 앱으로 할 수 있는 작업, 일반적인 문제 해결 방법, 앱 제거 방법을 설명합니다.

사전 요구 사항

OOMOL 계정.
서드파티 앱에 대해 권한을 부여할 수 있는 HubSpot 계정.
https://console.oomol.com/의 OOMOL Console에 대한 액세스.
HubSpot에서 CRM 객체 및 CRM 스키마 범위로 앱을 승인할 수 있는 권한.
검색, 읽기 또는 업데이트 도구를 사용하려면 테스트 연락처, 회사 및 거래 레코드.
HubSpot 조직에서 서드파티 앱을 제한하는 경우, 권한을 부여하기 전에 HubSpot 관리자가 OOMOL 앱을 허용해야 할 수 있습니다.

앱 추가

OOMOL Console에 로그인합니다.
Connectables를 열거나 Connections로 직접 이동합니다.
HubSpot을 검색합니다.
HubSpot을 선택한 다음 Connect를 선택합니다.
OOMOL이 HubSpot으로 리디렉션합니다. 메시지가 표시되면 HubSpot에 로그인합니다.
요청된 CRM 권한을 포함하여 HubSpot 권한 부여 화면을 검토합니다.
연결할 HubSpot 계정을 선택합니다.
Connect app 또는 HubSpot에 표시된 해당 권한 부여 작업을 선택합니다.
HubSpot이 OOMOL로 다시 리디렉션한 후 OOMOL 연결에서 HubSpot이 연결됨으로 표시되는지 확인합니다.

단계가 실패하면 문제 해결을 참조하세요.

권한 부여 후 OOMOL은 사용자를 대신하여 HubSpot 도구를 호출하는 데 필요한 연결을 저장합니다. 그런 다음 OOMOL이 지원하는 에이전트, 재사용 가능한 Skills 및 워크플로에서 HubSpot 도구를 사용할 수 있습니다.

사용

HubSpot 도구는 HubSpot 계정을 연결한 후에만 사용할 수 있습니다. OOMOL에 표시되는 정확한 도구 목록은 커넥터가 업데이트됨에 따라 변경될 수 있지만, 현재 HubSpot 커넥터는 CRM 속성 정의 읽기와 연락처, 회사 및 거래 검색, 읽기, 생성 및 업데이트를 지원합니다.

oo CLI와 함께 HubSpot 도구 사용

지원되는 AI 에이전트 환경에서 연결된 HubSpot 도구를 사용하려면 OOMOL에 로그인한 후 oo CLI를 설치하고 구성하세요.

OOMOL Console에 로그인합니다.
oo CLI 설치 페이지를 엽니다.
해당 페이지의 지침을 따릅니다. 이 페이지에서는 지원되는 AI 에이전트 환경에서 oo CLI를 설치하고 구성하기 위한 원클릭 복사 프롬프트를 제공합니다.
oo CLI가 구성되고 OOMOL에서 HubSpot이 연결되면 에이전트에게 데모 CRM 데이터와 함께 연결된 HubSpot CRM 도구를 사용하도록 요청합니다.

정확한 에이전트 프롬프트는 환경에 따라 다를 수 있습니다. 예를 들어 에이전트에게 데모 연락처를 생성하거나, 이메일로 해당 연락처를 검색하거나, 직함과 같은 편집 가능한 필드를 업데이트하거나, HubSpot CRM 속성을 나열하도록 요청할 수 있습니다.

사용되는 권한

OOMOL은 다음 HubSpot 범위를 사용하여 권한이 부여된 HubSpot 사용자가 OOMOL에서 HubSpot을 앱으로 연결한 다음 승인된 CRM 도구를 에이전트와 재사용 가능한 Skills에 제공할 수 있도록 합니다.

필수 범위:

HubSpot 범위	사용 주체	OOMOL이 사용하는 이유
`oauth`	HubSpot OAuth 연결	HubSpot OAuth 권한 부여 흐름을 완료하고 OOMOL에서 권한이 부여된 HubSpot 연결을 유지합니다.
`crm.objects.contacts.read`	Search Contacts, Get Contact	사용자 또는 승인된 에이전트 작업이 연락처 정보를 요청할 때 HubSpot 연락처 레코드를 검색하고 읽습니다.
`crm.objects.contacts.write`	Create Contact, Update Contact	사용자 또는 승인된 에이전트 작업이 필요한 연락처 세부 정보를 제공할 때 HubSpot 연락처 레코드를 생성하거나 업데이트합니다.
`crm.objects.companies.read`	Search Companies, Get Company	사용자 또는 승인된 에이전트 작업이 회사 정보를 요청할 때 HubSpot 회사 레코드를 검색하고 읽습니다.
`crm.objects.companies.write`	Create Company, Update Company	사용자 또는 승인된 에이전트 작업이 필요한 회사 세부 정보를 제공할 때 HubSpot 회사 레코드를 생성하거나 업데이트합니다.
`crm.objects.deals.read`	Search Deals, Get Deal	사용자 또는 승인된 에이전트 작업이 거래 정보를 요청할 때 HubSpot 거래 레코드를 검색하고 읽습니다.
`crm.objects.deals.write`	Create Deal, Update Deal	사용자 또는 승인된 에이전트 작업이 필요한 거래 세부 정보를 제공할 때 HubSpot 거래 레코드를 생성하거나 업데이트합니다.
`crm.schemas.contacts.read`	List Properties, Get Property	도구가 유효한 HubSpot 연락처 필드를 사용할 수 있도록 연락처 속성 정의를 읽습니다.
`crm.schemas.companies.read`	List Properties, Get Property	도구가 유효한 HubSpot 회사 필드를 사용할 수 있도록 회사 속성 정의를 읽습니다.
`crm.schemas.deals.read`	List Properties, Get Property	도구가 유효한 HubSpot 거래 필드를 사용할 수 있도록 거래 속성 정의를 읽습니다.

지원되는 HubSpot 도구

도구	지원되는 기능	일반적인 사용 사례	사전 요구 사항
List Properties	연락처, 회사 또는 거래의 속성 정의를 나열합니다.	필터 생성, 레코드 생성 또는 필드 업데이트 전에 에이전트가 사용 가능한 CRM 필드를 이해하도록 합니다.	OOMOL에서 HubSpot이 연결되어 있고 연결된 계정이 CRM 속성 스키마에 액세스할 수 있습니다.
Get Property	연락처의 `email` 속성과 같은 하나의 속성 정의를 읽습니다.	검색, 생성 또는 업데이트 작업에서 사용하기 전에 특정 CRM 필드를 확인합니다.	OOMOL에서 HubSpot이 연결되어 있고 요청된 속성이 존재합니다.
Search Contacts	키워드, 필터, 정렬 및 선택한 반환 필드로 연락처를 검색합니다.	통화, 핸드오프, 지원 작업 또는 후속 조치 전에 적합한 사람을 찾습니다.	OOMOL에서 HubSpot이 연결되어 있고 연결된 계정이 연락처를 읽을 수 있습니다.
Get Contact	HubSpot 레코드 ID 또는 사용자 정의 고유 속성으로 하나의 연락처를 읽습니다.	다음 단계를 수행하기 전에 연락처 세부 정보를 에이전트 워크플로로 가져옵니다.	OOMOL에서 HubSpot이 연결되어 있고 요청된 연락처를 연결된 계정에서 사용할 수 있습니다.
Create Contact	제공된 속성과 선택적 연결로 연락처를 생성합니다.	사용자가 에이전트에게 제공한 정보에서 새 리드, 고객 또는 이해관계자를 저장합니다.	OOMOL에서 HubSpot이 연결되어 있고 사용자에게 필요한 연락처 세부 정보가 있습니다.
Update Contact	레코드 ID 또는 사용자 정의 고유 속성으로 연락처 속성을 업데이트합니다.	통화, 이메일, 연구 작업 또는 워크플로 단계 후에 연락처 레코드를 최신 상태로 유지합니다.	OOMOL에서 HubSpot이 연결되어 있고 연락처를 찾을 수 있으며 사용자가 업데이트된 세부 정보를 승인했습니다.
Search Companies	키워드, 필터, 정렬 및 선택한 반환 필드로 회사를 검색합니다.	연구, 아웃리치 또는 후속 조치를 준비하기 전에 계정 정보를 찾습니다.	OOMOL에서 HubSpot이 연결되어 있고 연결된 계정이 회사를 읽을 수 있습니다.
Get Company	HubSpot 레코드 ID 또는 사용자 정의 고유 속성으로 하나의 회사를 읽습니다.	노트, 계획 또는 업데이트를 생성하기 전에 계정 세부 정보를 에이전트 워크플로로 가져옵니다.	OOMOL에서 HubSpot이 연결되어 있고 요청된 회사를 연결된 계정에서 사용할 수 있습니다.
Create Company	제공된 속성과 선택적 연결로 회사를 생성합니다.	사용자가 제공한 회사 정보에서 새 계정을 추가합니다.	OOMOL에서 HubSpot이 연결되어 있고 사용자에게 필요한 회사 세부 정보가 있습니다.
Update Company	레코드 ID 또는 사용자 정의 고유 속성으로 회사 속성을 업데이트합니다.	연구, 영업 업무 또는 운영 검토 후에 계정 세부 정보를 최신 상태로 유지합니다.	OOMOL에서 HubSpot이 연결되어 있고 회사를 찾을 수 있으며 사용자가 업데이트된 세부 정보를 승인했습니다.
Search Deals	키워드, 필터, 정렬 및 선택한 반환 필드로 거래를 검색합니다.	파이프라인 검토, 예측 또는 후속 조치 전에 적합한 기회를 찾습니다.	OOMOL에서 HubSpot이 연결되어 있고 연결된 계정이 거래를 읽을 수 있습니다.
Get Deal	HubSpot 레코드 ID 또는 사용자 정의 고유 속성으로 하나의 거래를 읽습니다.	요약하거나 업데이트하기 전에 기회 세부 정보를 에이전트 워크플로로 가져옵니다.	OOMOL에서 HubSpot이 연결되어 있고 요청된 거래를 연결된 계정에서 사용할 수 있습니다.
Create Deal	제공된 속성과 선택적 연결로 거래를 생성합니다.	사용자가 제공한 영업 정보에서 새 기회를 추가합니다.	OOMOL에서 HubSpot이 연결되어 있고 사용자에게 필요한 거래 세부 정보가 있습니다.
Update Deal	레코드 ID 또는 사용자 정의 고유 속성으로 거래 속성을 업데이트합니다.	고객 상호 작용 또는 내부 검토 후에 파이프라인 세부 정보를 최신 상태로 유지합니다.	OOMOL에서 HubSpot이 연결되어 있고 거래를 찾을 수 있으며 사용자가 업데이트된 세부 정보를 승인했습니다.

CRM 레코드 검색 및 읽기

사용 사례: 통화, 핸드오프, 연구 작업 또는 후속 조치 전에 에이전트가 적합한 HubSpot 연락처, 회사 또는 거래를 찾도록 합니다.

사전 요구 사항:

OOMOL에서 HubSpot이 연결되어 있습니다.
연결된 HubSpot 계정에 요청된 CRM 객체를 읽을 수 있는 권한이 있습니다.
에이전트 또는 워크플로에 검색 키워드, 필터, 레코드 ID 또는 고유 속성 값이 있습니다.

도구가 수행하는 작업:

연결된 HubSpot 계정에서 사용할 수 있는 연락처, 회사 및 거래를 검색하거나 읽습니다.
사용 가능한 경우 도구 입력에서 요청한 HubSpot 필드를 반환합니다.
읽기 전용 작업 중에는 레코드를 생성, 업데이트 또는 삭제하지 않습니다.

CRM 레코드 생성

사용 사례: 에이전트가 새 고객, 계정 또는 기회와 같이 사용자가 제공한 정보에서 HubSpot 연락처, 회사 또는 거래를 생성하도록 합니다.

사전 요구 사항:

OOMOL에서 HubSpot이 연결되어 있습니다.
연결된 HubSpot 계정에 요청된 CRM 객체를 생성할 수 있는 권한이 있습니다.
에이전트 또는 워크플로에 새 레코드에 필요한 속성이 있습니다.
연결이 포함된 경우 관련 레코드가 유효하고 연결된 계정에서 사용할 수 있어야 합니다.

도구가 수행하는 작업:

제공된 입력을 기반으로 HubSpot 연락처, 회사 또는 거래를 생성합니다.
레코드 ID 및 선택한 속성과 같이 HubSpot에서 제공하는 레코드 정보를 반환합니다.
누락된 CRM 값을 임의로 만들어내지 않습니다. 필수 값은 사용자, 워크플로 또는 연결된 데이터 소스에서 제공해야 합니다.

CRM 레코드 업데이트

사용 사례: 사용자가 연락처, 회사 또는 거래 필드를 변경하도록 요청할 때 에이전트가 HubSpot 레코드를 최신 상태로 유지하도록 합니다.

사전 요구 사항:

OOMOL에서 HubSpot이 연결되어 있습니다.
연결된 HubSpot 계정에 요청된 CRM 객체를 업데이트할 수 있는 권한이 있습니다.
에이전트 또는 워크플로가 HubSpot 레코드 ID 또는 사용자 정의 고유 속성으로 대상 레코드를 찾을 수 있습니다.
업데이트된 값이 HubSpot 속성 정의에 유효합니다.

도구가 수행하는 작업:

제공된 입력을 기반으로 지원되는 HubSpot 연락처, 회사 또는 거래 속성을 업데이트합니다.
HubSpot에서 제공하는 업데이트 결과를 반환합니다.
레코드를 삭제하지 않습니다.

앱 테스트

권한을 부여할 수 있는 모든 HubSpot 계정으로 HubSpot 앱을 테스트할 수 있습니다. 검색, 생성 및 업데이트 작업을 안전하게 테스트할 수 있도록 데모 연락처, 회사 및 거래를 사용하세요.

샘플 테스트 프롬프트

이메일이 demo-contact@example.com인 Demo Contact이라는 HubSpot 연락처를 생성합니다.
demo-contact@example.com에 대한 HubSpot 연락처를 검색합니다.
이메일이 demo-contact@example.com인 HubSpot 연락처를 가져옵니다.
이메일이 demo-contact@example.com인 HubSpot 연락처를 업데이트하고 직함을 Demo Buyer(으)로 설정합니다.
Demo Company에 대한 HubSpot 회사를 검색합니다.
Demo Company라는 HubSpot 회사를 생성합니다.
Demo Deal에 대한 HubSpot 거래를 검색합니다.
샘플 테스트 값으로 Demo Deal이라는 HubSpot 거래를 생성합니다.
Demo Deal 금액 또는 마감일을 업데이트합니다.
HubSpot 연락처 속성을 나열합니다.
email에 대한 HubSpot 연락처 속성 정의를 가져옵니다.

테스트 중에는 데모 데이터만 사용하세요. 테스트 프롬프트에 실제 고객 데이터를 사용하지 마세요.

문제 해결

HubSpot 앱을 추가할 수 없습니다

올바른 OOMOL 계정에 로그인했는지 확인합니다.
연결하려는 HubSpot 계정에 로그인하고 있는지 확인합니다.
HubSpot 계정이 요청된 CRM 범위를 허용하는지 확인합니다.
HubSpot 계정이 조직에 속한 경우 HubSpot 관리자에게 서드파티 앱에 승인이 필요한지 문의합니다.
OOMOL에서 실패했거나 부분적인 HubSpot 연결을 끊은 다음 다시 연결해 보세요.
문제가 계속되면 OOMOL 지원에 문의하고 OOMOL 계정 이메일, HubSpot 계정 또는 포털 ID, 시도 시간, 오류 메시지 또는 스크린샷을 포함하세요.

HubSpot 도구가 레코드를 찾을 수 없습니다

연결된 HubSpot 계정에 요청된 연락처, 회사 또는 거래에 대한 액세스 권한이 있는지 확인합니다.
워크플로가 올바른 레코드 ID, 고유 속성, 검색 키워드 또는 필터를 사용하고 있는지 확인합니다.
레코드가 OOMOL에 연결된 HubSpot 계정에 존재하는지 확인합니다.
최근에 HubSpot 권한을 변경한 경우 OOMOL에서 HubSpot을 다시 연결하여 권한 부여 상태를 새로 고치세요.

HubSpot 도구가 레코드를 생성할 수 없습니다

연결된 HubSpot 계정이 HubSpot에서 직접 요청된 연락처, 회사 또는 거래를 생성할 수 있는지 확인합니다.
모든 필수 HubSpot 속성이 포함되어 있는지 확인합니다.
제공된 값이 HubSpot 속성 정의에 유효한지 확인합니다.
연결이 포함된 경우 연결된 레코드 및 연결 유형이 유효한지 확인합니다.

HubSpot 도구가 레코드를 업데이트할 수 없습니다

연결된 HubSpot 계정에 요청된 레코드를 업데이트할 수 있는 권한이 있는지 확인합니다.
워크플로가 올바른 HubSpot 레코드 ID 또는 사용자 정의 고유 속성을 사용하고 있는지 확인합니다.
업데이트된 필드와 값이 HubSpot에 유효한지 확인합니다.
속성이 HubSpot에서 읽기 전용이거나 제한된 경우 업데이트 요청에서 제거하거나 HubSpot에서 직접 업데이트하세요.

앱 제거

OOMOL 또는 HubSpot에서 HubSpot 앱을 제거할 수 있습니다. OOMOL이 더 이상 HubSpot에 액세스하지 않도록 하려면 두 곳 모두에서 제거하는 것이 좋습니다.

OOMOL에서 HubSpot 제거

OOMOL Console에 로그인합니다.
Connections를 엽니다.
연결된 앱에서 HubSpot을 찾습니다.
HubSpot 연결 세부 정보를 엽니다.
Disconnect, Remove 또는 OOMOL에 표시된 해당 제거 작업을 선택합니다.
제거를 확인합니다.

HubSpot에서 OOMOL 제거

HubSpot에 로그인합니다.
Settings를 엽니다.
Integrations를 연 다음 Connected Apps를 엽니다.
OOMOL을 찾습니다.
앱을 제거, 연결 해제 또는 삭제하는 작업을 선택합니다.
제거를 확인합니다.

제거 후 발생하는 일

HubSpot 연결이 제거되거나 권한이 해제된 후에는 OOMOL이 귀하의 계정에 대해 HubSpot 도구를 더 이상 사용할 수 없습니다.
HubSpot에 의존하는 워크플로, 에이전트 또는 Skills는 HubSpot을 다시 연결할 때까지 실패할 수 있습니다.
제거 전에 생성되거나 업데이트된 기존 HubSpot 레코드는 HubSpot에서 변경하거나 삭제하지 않는 한 HubSpot에 남아 있습니다.
앱을 제거해도 OOMOL 계정은 삭제되지 않습니다.

데이터 처리

OOMOL은 HubSpot 사용자가 앱에 권한을 부여하고 사용자 또는 승인된 에이전트 작업이 HubSpot을 필요로 하는 경우에만 HubSpot 데이터에 액세스합니다. OOMOL은 OOMOL이 지원하는 에이전트, 재사용 가능한 Skills 및 워크플로를 통해 요청된 HubSpot 도구를 제공하기 위해서만 HubSpot 데이터를 사용합니다.

HubSpot OAuth 토큰은 암호화되어 저장됩니다.
OOMOL은 AI 에이전트, 프롬프트, 브라우저 클라이언트, 애플리케이션 코드 또는 최종 사용자에게 HubSpot OAuth 토큰을 노출하지 않습니다.
OOMOL은 HubSpot 도구가 호출될 때 HubSpot 연락처, 회사, 거래 및 CRM 속성 메타데이터를 처리할 수 있습니다.
HubSpot 데이터는 사용자에게 표시되는 도구 결과, 사용 기록, 실행 기록 또는 운영 기록에 필요한 만큼만 저장될 수 있습니다.
저장된 데이터는 저장 시 암호화되며 TLS/SSL을 통해 전송됩니다.
OOMOL은 귀하의 HubSpot 데이터를 판매하지 않습니다.
OOMOL은 광고를 위해 HubSpot 데이터를 사용하지 않습니다.
OOMOL은 비공개 고객 콘텐츠를 AI 모델 학습에 사용하지 않습니다.
HubSpot 앱을 제거하거나 권한을 해제하면 OOMOL은 취소된 HubSpot 권한 부여 사용을 중단합니다. OOMOL은 일반적인 연결 제거 프로세스에 따라 저장된 HubSpot 권한 부여 토큰을 삭제하거나 무효화합니다.
일부 로그, 지원 기록, 보안 기록 또는 청구 관련 기록은 개인정보 처리방침에 설명된 대로 보존될 수 있습니다.

FAQ

OOMOL이 HubSpot 데이터를 지속적으로 동기화하나요?

OOMOL은 권한이 부여된 사용자 또는 승인된 에이전트 작업이 HubSpot 도구를 호출할 때 요청 시 HubSpot 데이터에 액세스합니다.

연결 후 에이전트가 HubSpot을 자동으로 사용할 수 있나요?

HubSpot을 연결하면 OOMOL에서 HubSpot 도구를 사용할 수 있게 되지만, 도구 사용은 선택한 에이전트, 워크플로, Skill 및 권한에 따라 달라집니다. 계정 기반 서비스에는 여전히 귀하의 권한 부여가 필요합니다.

OOMOL이 HubSpot 레코드를 삭제할 수 있나요?

이 가이드에 설명된 현재 HubSpot 커넥터는 연락처, 회사 및 거래 검색, 읽기, 생성 및 업데이트를 지원합니다. 레코드 삭제 도구는 포함되어 있지 않습니다.

HubSpot 계정을 두 개 이상 연결할 수 있나요?

OOMOL Console을 사용하여 계정 또는 워크스페이스에서 사용할 수 있는 현재 연결 옵션을 확인하세요. 여러 HubSpot 계정에 대한 도움이 필요하면 지원에 문의하세요.

유료 HubSpot 계정이 필요한가요?

대부분의 OOMOL HubSpot 도구는 요청된 CRM 범위를 승인할 수 있는 HubSpot 계정이 필요합니다. 일부 HubSpot 기능, 객체 액세스, 속성 액세스 또는 관리자 제어는 HubSpot 요금제 또는 조직 설정에 따라 달라질 수 있습니다.

지원 문의

HubSpot 앱 추가, 사용, 테스트 또는 제거에 도움이 필요하면 OOMOL 지원에 문의하세요:

이메일: support@oomol.com
지원 페이지: https://oomol.com/ko/support/

OOMOL 계정 이메일, 관련된 경우 연결된 HubSpot 계정 또는 포털 ID, 수행하려던 작업, 오류 메시지 또는 스크린샷을 포함해 주세요.