어떤 HubSpot 요금제가 필요할까요?

HubSpot의 모든 요금제(무료, 스타터, 프로페셔널, 엔터프라이즈)가 사용 가능합니다.

HubSpot 데이터는 안전한가요?

예. AES-256 암호화, 아웃바운드 전용 연결, 데이터는 쿼리 스트림 서버를 거치지 않습니다.

HubSpot의 사용자 지정 속성에 액세스할 수 있나요?

예, json_extract_string(raw_data, '$.properties.your_custom_field')를 사용하면 모든 속성에 접근할 수 있습니다.

Query Streams가 HubSpot 데이터를 수정할 수 있나요?

아니요. Query Streams는 엄격하게 읽기 전용이며 .read 권한만 요청합니다.

HubSpot을 Excel에 연결하기 - SQL을 사용하여 CRM 데이터 쿼리

HubSpot과 Excel을 연결하세요

다음에서 데이터를 가져오세요 HubSpot ~ 안으로 Excel

HubSpot 계정에서 실시간으로 데이터를 가져와 Excel로 불러오고 원할 때마다 새로 고칠 수 있습니다. ODBC 드라이버, 내보내기, 매크로가 필요 없습니다. 처음 설정하는 데 약 10분 정도 소요되며, 무료 플랜에서 모두 이용 가능합니다.

약 10분 코딩이 필요 없습니다 자격증명은 영구적으로 보관됩니다. 웹에서도 엑셀을 사용할 수 있습니다.

진행 과정에서 막히는 부분이 있나요? 언제든지 저희에게 문의하세요. 열려 있는 지원 쿼리 스트림(오른쪽 상단 메뉴 → 지원)에서 메시지를 보내주세요. 담당자가 직접 확인하며, "이 화면에서 무엇을 묻는지 모르겠습니다"라는 질문은 전혀 문제없습니다.

당신이 최종적으로 얻게 될 것

HubSpot 계정에 대한 SQL 쿼리 결과를 실시간으로 보여주는 워크시트입니다. 데이터가 변경될 때마다 최신 행을 가져오는 버튼도 있습니다. 예를 들어 다음과 같습니다.

판매.xlsx — 엑셀

홈끼워 넣다데이터쿼리 스트림

	A	B	C	D	E
1	customer_id	첫 번째 이름	성	국가	총
2	1042	마리아	알바레스	미국	1,284.50
3	1043	다니엘	오카포르	미국	612.00
4	1047	프리야	나이르	미국	2,090.75
5	1051	도마	산	미국	338.20
6	1056	루시아	페레이라	미국	1,455.00
7	1060	켄지	사토	미국	874.10
8

시트1

HubSpot에서 생중계

HubSpot은 API를 통해 데이터를 관리합니다. 일반적으로 최신 데이터가 필요할 때마다 HubSpot 대시보드에서 CSV 파일로 내보내야 Excel로 가져올 수 있습니다. 하지만 Query Streams를 사용하면 이 과정을 생략할 수 있습니다. Agent라는 작은 도우미 프로그램이 데이터가 저장된 위치에서 쿼리를 실행하고, Excel 추가 기능이 필요한 행을 요청합니다. 암호화된 링크를 통해 결과만 전송되므로 Excel 파일은 어디에 있든 상관없습니다. 집의 노트북, 멀리 떨어진 동료의 컴퓨터, 또는 웹 기반 Excel 등 어디에서든 사용할 수 있습니다.

에이전트는 사용자의 데이터와 함께 작동합니다. Excel은 그럴 필요가 없습니다. 시트의 어느 부분을 열든 행이 자동으로 표시됩니다.

필요한 것

Query Streams 계정

이 가이드를 이용하시려면 무료 플랜으로도 충분합니다. 지금 가입하세요. my.querystreams.com.

항상 켜져 있는 컴퓨터의 에이전트

백그라운드에서 실행되는 작은 프로그램으로, Excel에서 HubSpot 호출을 요청할 때 작동합니다. 인터넷 연결만 있으면 됩니다.

HubSpot 로그인 정보

HubSpot에 한 번 로그인하고 읽기 권한을 허용하면 됩니다. 쿼리 스트림에는 비밀번호를 입력할 필요가 없습니다.

어떤 컴퓨터가 에이전트를 갖게 되나요? HubSpot 계정에 이미 접속할 수 있는 항상 켜져 있는 모든 기기. 엑셀은 어디에든 있을 수 있습니다.웹 기반 엑셀을 포함하여.

5단계로 연결하세요

계정을 만드세요

가다 my.querystreams.com 가입하세요. 선택하세요. 무료 정식 플랜입니다. 체험판이 아니며, HubSpot 계정 연결 및 Excel에서 쿼리 실행 기능을 포함합니다.
항상 켜져 있는 컴퓨터에 에이전트를 설치하십시오.
로그인, 열기 다운로드인터넷에 접속할 수 있는 상시 가동 컴퓨터 또는 서버에 에이전트를 설치하십시오. 설치에는 약 1분 정도 소요되며, 이후에는 자동으로 시작됩니다.
드라이버 대신 작은 프로그램을 사용하는 이유는 무엇인가요? 에이전트는 Windows, Mac 또는 Linux용으로 한 번만 설치하면 되며(Windows에서는 약 85MB, Mac 및 Linux에서는 100MB 조금 넘는 용량), 백그라운드에서 조용히 실행됩니다. 웹 브라우저와 마찬가지로 쿼리 스트림에 암호화된 연결을 한 번만 생성하므로 방화벽 포트를 열거나 VPN을 설정할 필요가 없습니다. 키는 해당 컴퓨터에 보관되며, 데이터는 필요한 경우 인터넷을 통해 사용자의 위치로 전송됩니다. 사용자가 해야 할 일은 추가 기능 설치뿐입니다.
다운로드 페이지가 표시됩니다 액세스 키에이전트가 요청할 때 해당 코드를 붙여넣고 배지가 인식될 때까지 기다리세요. 쿼리 스트림에 연결됨에이전트 자체에서 할 수 있는 일은 그게 전부입니다.
자세한 공략이 필요하시면 보여드리겠습니다. 윈도우, 스코틀랜드 사람, 리눅스.

HubSpot 계정을 지정하세요

브라우저로 돌아가서 열기 데이터 에이전트 (아래에 데이터 상단 메뉴에서 담당 에이전트를 확인하세요. (상단 메뉴에 있습니다.) 커넥터 추가 그리고 선택하세요 HubSpotHubSpot 계정 정보가 먼저 필요하신가요? 안내를 열고 다음 정보를 입력하세요.

HubSpot 계정 정보를 생성하세요 (약 5분)

HubSpot을 다른 탭에서 열어둔 상태로 다음 단계를 진행하세요. Query Streams는 여기서 생성한 데이터를 에이전트가 사용할 수 있도록 저장하며, HubSpot에서만 데이터를 읽어옵니다.

누가 이것을 할 수 있을까요?: 최고 관리자 또는 개발자 도구 접근 권한(서비스 키)이 있는 사용자여야 합니다. 기존의 비공개 앱은 최고 관리자 권한이 필요합니다.
추천: 읽기 전용 범위의 서비스 키(개발 → 키 → 서비스 키). HubSpot은 BI 도구 및 데이터 웨어하우스와의 예약된 데이터 동기화에 서비스 키 사용을 권장하며, 기존 비공개 앱을 새로 생성하는 옵션을 제거하고 있습니다.

시작하기 전에

HubSpot 로그인 계정은 슈퍼 관리자이거나 개발자 도구 접근 권한이 있어야 합니다. 서비스 키에는 본인의 HubSpot 사용자가 이미 가지고 있는 권한만 부여할 수 있습니다.
쿼리할 HubSpot 계정을 정확히 알아야 합니다. 키는 생성된 계정에서만 읽을 수 있으므로 테스트 또는 샌드박스 계정이 아닌 해당 계정에서 키를 생성해야 합니다.
HubSpot 테이블 중 사용할 테이블을 선택하세요. 연락처, 회사, 거래, 담당자, 파이프라인, 파이프라인 단계 및 속성 테이블은 기본적으로 활성화되어 있으며, 추가 테이블마다 읽기 권한을 설정해야 합니다(권한 참조).
Query Streams 에이전트가 항상 켜져 있는 컴퓨터에 설치되어 온라인 상태이고, Query Streams 포털이 다른 탭에서 열려 있습니다. [데이터 에이전트 → 커넥터 추가 → HubSpot]을 선택합니다.

단계

HubSpot에 로그인하세요
HubSpot을 새 탭에서 열고 슈퍼 관리자 또는 개발자 도구 접근 권한이 있는 사용자로 로그인하세요.
HubSpot 계정이 여러 개인 경우, 계속 진행하기 전에 원하는 데이터가 있는 계정으로 전환하세요. 제품 키는 생성된 계정에서만 작동합니다.
오픈 개발
왼쪽 기본 탐색 메뉴 하단에서 개발(</> 아이콘)을 클릭합니다. 개발 페이지가 열리고 개요, 프로젝트, 레거시 앱, 모니터링, 키 등 다양한 항목을 볼 수 있는 사이드바가 표시됩니다.
개발 항목이 없나요? HubSpot 사용자가 슈퍼 관리자가 아니어서 개발자 도구에 대한 액세스 권한이 없습니다. 슈퍼 관리자에게 키를 생성하거나 해당 권한을 부여해 달라고 요청하세요.
오픈 서비스 키
개발 사이드바에서 키를 클릭하여 확장한 다음 서비스 키(베타 배지가 있음)를 클릭합니다. 서비스 키 페이지가 열립니다. 서비스 키가 아직 없으면 "서비스 키가 생성되지 않았습니다"라고 표시됩니다.
동일 메뉴에서 서비스 키 바로 위에 있는 개인 액세스 키 또는 개발자 API 키는 사용하지 마십시오. 이러한 키는 개발자 도구 키이므로 연결되지 않습니다. 일부 계정은 설정(톱니바퀴 아이콘) → 통합 → 서비스 키에서 이 페이지로 이동할 수도 있습니다.
서비스 키 생성 버튼을 클릭하세요.
서비스 키 페이지의 오른쪽 상단에서 [서비스 키 생성]을 클릭합니다. [서비스 키 생성] 페이지가 열리고 [이름] 상자와 [범위] 섹션이 표시됩니다.
열쇠의 이름을 지정하세요
이름 필드에는 나중에 알아볼 수 있는 이름을 입력하세요. 예를 들어 '쿼리 스트림 읽기 전용'과 같이 입력할 수 있습니다. HubSpot은 로그에 이 이름을 표시합니다.
HubSpot 계정 내에서 해당 이름은 고유해야 합니다.
범위 선택기를 엽니다
선택한 범위 옆에 있는 + 새 범위 추가를 클릭합니다. 오른쪽에 범위 찾기 검색 상자와 각 범위에 대한 확인란이 있는 패널이 열립니다.
필수 범위 4개를 모두 선택하세요.
'범위 찾기'에 각 이름을 입력하고 해당 확인란을 선택하세요. crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read. 이 네 가지는 Query Streams가 기본적으로 동기화하는 모든 테이블을 포함합니다.
.read로 끝나는 범위만 선택하세요. Query Streams는 HubSpot에서 읽기만 하므로 .write 범위는 필요하지 않습니다.
추가 테이블에 대한 체크 범위를 선택하세요.
추가하려는 각 테이블에 대해 아래 권한 목록에서 해당 테이블의 범위를 선택하십시오. 예를 들어, 티켓 테이블의 경우 crm.objects.tickets.read, 품목, 세금, 할인 및 수수료 테이블의 경우 crm.objects.line_items.read, 목록 테이블의 경우 crm.lists.read를 선택하십시오. 기본 테이블만으로 충분한 경우 이 단계를 건너뛰십시오.
나중에 새 키를 만들지 않고도 범위를 추가할 수 있습니다(키를 열고 편집을 클릭하세요).
업데이트를 클릭하세요
오른쪽 패널에서 [업데이트]를 클릭하세요. 패널이 닫히고 선택한 범위 목록이 [선택된 범위] 아래에 표시됩니다.
범위 목록을 확인하세요
선택된 스코프 목록을 읽어보세요. .write로 끝나는 항목이 있으면 옆에 있는 삭제 버튼을 클릭하세요. 키가 볼 수 있는 범위를 일반 언어로 된 목록으로 보려면 선택된 스코프 요약을 펼치세요.
키를 생성하세요
오른쪽 상단의 '만들기'를 클릭한 다음 열리는 대화 상자에서 확인하세요.
새 키를 열어보세요
개발 → 키 → 서비스 키로 이동하여 방금 생성한 키 이름을 클릭합니다. 서비스 키 상자가 있는 세부 정보 페이지가 열립니다.
키를 표시하고 복사하세요
서비스 키 상자에서 값이 부분적으로 가려져 있고 pat-으로 시작합니다(예: pat-na1-…). 그 아래에 있는 '표시'를 클릭한 다음 '복사'를 클릭합니다.
텍스트를 수동으로 선택하는 대신 복사 기능을 사용하세요. 문자가 누락되거나, 뒤에 공백이 있거나, 숨겨진 점이 있으면 테스트에 실패합니다. HubSpot은 키를 한 번만 표시하지 않습니다. 나중에 다시 '표시'를 클릭하여 다시 볼 수 있습니다. 비밀번호를 사용하는 것처럼 관리하세요.
쿼리 스트림에 붙여넣고 테스트하세요.
쿼리 스트림 포털에서 데이터 에이전트를 열고 커넥터 추가를 클릭한 다음 HubSpot을 선택합니다. 앱 액세스 토큰에 키를 붙여넣고 연결 이름을 입력한 다음 연결 테스트를 클릭합니다. 결과에 연결됨이 표시됩니다.
Query Streams는 에이전트의 키를 저장하고 HubSpot 데이터만 읽습니다.
사용하려는 범위에 맞는 표를 선택하세요.
이어지는 동기화 단계에서는 7단계와 8단계에서 범위를 선택한 HubSpot 테이블만 남겨두고 마법사를 완료하세요.
범위 없이 테이블을 켜면 Forbidden 오류와 함께 동기화가 실패합니다. 키에 범위를 추가하거나(8단계) 테이블을 끄십시오.

대안

기존 비공개 앱 토큰을 사용하세요

기존 계정에 재사용하려는 기존 비공개 앱이 있습니다. HubSpot은 새 비공개 앱 생성 옵션을 제거할 예정입니다. 2026년 9월 28일 이후에 생성된 계정은 이미 새 비공개 앱을 생성할 수 없으며, 이전 계정은 2026년 10월 26일에 해당 기능이 완전히 사라집니다. 기존 비공개 앱과 해당 토큰은 계속 사용할 수 있습니다.

누가 이것을 할 수 있을까요? 최고 관리자

기존 앱 열기
HubSpot에서 왼쪽 기본 탐색 메뉴에서 개발을 클릭한 다음 개발 사이드바에서 레거시 앱을 클릭합니다.
이전 HubSpot 탐색 메뉴에서는 이 항목을 설정 → 통합 → 비공개 앱이라고 불렀습니다.
개인 앱을 열거나 새 앱을 시작하세요.
앱이 목록에 있으면 앱 이름을 클릭하고 6단계(범위를 추가하려면 5단계)로 이동합니다. 앱이 목록에 없고 버튼이 여전히 남아 있으면 오른쪽 상단의 '레거시 앱 만들기'를 클릭하고 대화 상자에서 '비공개'를 선택합니다.
'레거시 앱 생성' 버튼이 없다는 것은 해당 계정에 대한 레거시 앱 생성 기능이 이미 비활성화되었다는 의미입니다. 대신 서비스 키를 사용하세요(주요 단계 참조).
새 앱의 이름을 정하세요
기본 정보 탭에서 '쿼리 스트림 읽기 전용'과 같은 이름을 입력합니다. 로고와 설명은 선택 사항입니다.
읽기 범위를 추가합니다.
범위 탭을 클릭하고 새 범위 추가를 클릭한 다음, 7단계와 8단계에서 선택한 것과 동일한 범위를 선택하고 업데이트를 클릭합니다. 그런 다음 오른쪽 상단의 앱 만들기를 클릭하고 대화 상자에 표시되는 액세스 토큰 메시지를 읽은 후 만들기를 계속 클릭합니다.
기존 앱에 스코프를 추가합니다(필요한 경우에만).
앱 페이지 오른쪽 상단의 '앱 편집'을 클릭하고 '범위' 탭을 열어 누락된 읽기 범위를 추가한 후 저장하세요. 범위를 변경해도 토큰 문자열은 변경되지 않습니다.
토큰을 표시하고 복사하세요
앱 페이지에서 '인증' 탭을 클릭합니다. '액세스 토큰' 아래에서 '토큰 표시'를 클릭한 다음 '복사'를 클릭합니다. 토큰은 'pat-'으로 시작합니다. 메인 단계 14에서 설명한 대로 '앱 액세스 토큰'에 붙여넣습니다.
앱을 생성한 HubSpot 사용자가 HubSpot에서 삭제되면 일부 호출이 USER_DOES_NOT_HAVE_PERMISSIONS 오류와 함께 실패할 수 있습니다. 토큰을 회전(옆의 회전 버튼)하여 새 토큰을 붙여넣거나 서비스 키로 이동하세요.

개발자 플랫폼 앱의 정적 인증 토큰을 사용하세요.

귀하의 팀은 이미 HubSpot CLI를 사용하여 새로운 개발자 플랫폼에 HubSpot 앱을 구축했으며, 정적 인증 및 비공개 배포를 구성했습니다. 앱을 구축하려면 CLI가 필요합니다. CLI가 없는 경우 서비스 키를 사용하십시오.

누가 이것을 할 수 있을까요? 토큰을 보려면 최고 관리자 또는 개발자 권한이 있는 사용자가 필요합니다. 앱을 설치하려면 최고 관리자 또는 HubSpot Marketplace 액세스 권한이 필요합니다.

프로젝트를 엽니다
HubSpot에서 개발을 클릭한 다음 사이드바에서 프로젝트를 클릭하고 앱이 포함된 프로젝트 이름을 클릭합니다.
앱을 엽니다
프로젝트 개요 탭의 프로젝트 구성 요소에서 앱 이름을 클릭합니다.
배포 탭을 엽니다.
배포 탭을 클릭하세요.
아직 설치하지 않았다면 앱을 설치하세요.
배포 관리에서 현재 HubSpot 계정이 표시됩니다. 지금 설치를 클릭하고 요청된 액세스 권한이 구성한 읽기 범위와 일치하는지 확인한 다음 앱 연결을 클릭합니다.
정적 토큰 앱은 한 번에 하나의 표준 HubSpot 계정에만 설치할 수 있습니다.
토큰을 표시하고 복사하세요
설치가 완료되면 배포 탭에 액세스 토큰이 표시됩니다. '표시'를 클릭하여 토큰을 확인하고 복사한 다음, 메인 단계 14에서 설명한 대로 '앱 액세스 토큰'에 붙여넣으세요.
나중에 앱의 범위를 변경하는 경우 배포 탭의 재설치 URL을 사용하여 앱을 다시 설치해야 합니다. 그렇지 않으면 새 범위가 적용되지 않습니다.

부여할 권한

의지	액세스	사용 용도
crm.objects.contacts.read	읽다	필수 항목입니다. hubspot.contacts 테이블과 hubspot.calls, hubspot.emails, hubspot.meetings, hubspot.notes, hubspot.tasks, hubspot.communications 활동 테이블(HubSpot의 활동 API는 이 범위를 사용합니다) 및 hubspot.properties와 hubspot.associations 테이블의 연락처 필드가 필요합니다.
crm.objects.companies.read	읽다	필수 항목입니다. hubspot.companies와 hubspot.properties 및 hubspot.associations의 회사 필드가 필요합니다.
crm.objects.deals.read	읽다	필수 항목입니다. hubspot.deals, hubspot.pipelines 및 hubspot.pipeline_stages의 거래 파이프라인, 그리고 hubspot.properties 및 hubspot.associations의 거래 필드가 필요합니다.
crm.objects.owners.read	읽다	필수 항목입니다. hubspot.owners는 레코드를 소유한 HubSpot 사용자이므로, 이를 통해 거래 및 연락처를 담당자 이름과 연결할 수 있습니다.
crm.objects.tickets.read	읽다	티켓을 동기화하는 경우에만 가능합니다. hubspot.tickets와 hubspot.pipelines 및 hubspot.pipeline_stages의 티켓 파이프라인을 동기화하세요. 이전 버전 앱에서는 레거시 티켓 범위가 표시될 수 있으며, 이 경우에도 변경이 가능합니다.
crm.objects.products.read	읽다	제품을 동기화하는 경우에만 hubspot.products를 사용하세요. 제품 선택기에서 제품을 검색하세요. HubSpot의 제품 API는 이 범위를 허용하지만, HubSpot의 범위 참조 페이지에는 아직 나와 있지 않습니다.
crm.objects.line_items.read	읽다	품목, 세금, 할인 또는 수수료를 동기화하는 경우에만 해당됩니다: hubspot.line_items, hubspot.taxes, hubspot.discounts, hubspot.fees.
crm.objects.quotes.read	읽다	Quotes: hubspot.quotes를 동기화하는 경우에만 가능합니다.
crm.objects.invoices.read	읽다	HubSpot.Invoices에서 송장을 동기화하는 경우에만 가능합니다.
crm.objects.subscriptions.read	읽다	HubSpot 커머스 구독을 동기화하는 경우에만 가능합니다: hubspot.subscriptions (HubSpot 커머스 구독).
crm.objects.commercepayments.read	읽다	HubSpot Commerce Payments(hubspot.payments)를 동기화하는 경우에만 가능합니다.
crm.objects.marketing_events.read	읽다	마케팅 이벤트(hubspot.marketing_events)를 동기화하는 경우에만 가능합니다.
양식	읽기 및 쓰기 (HubSpot에는 읽기 전용 폼 범위가 없습니다)	HubSpot.forms 및 HubSpot.form_submissions와 같은 폼 또는 폼 제출을 동기화하는 경우에만 해당됩니다. 쿼리 스트림은 이러한 파일들을 읽기만 합니다.
crm.objects.feedback_submissions.read	읽다	피드백 동기화 시에만 사용 가능합니다: hubspot.feedback_submissions. Service Hub Professional 또는 Enterprise 버전에서만 사용 가능합니다. HubSpot의 범위 참조에서는 이를 crm.objects.feedback_submission.read로 표기하므로 선택기에서 feedback을 검색하세요.
crm.lists.read	읽다	HubSpot.lists 목록을 동기화하는 경우에만 가능합니다.
오토메이션	읽기 및 쓰기 (HubSpot에는 읽기 전용 워크플로 범위가 없습니다)	HubSpot Workflows를 동기화하는 경우에만 가능합니다. Professional 또는 Enterprise 계정에서만 사용할 수 있습니다. 쿼리 스트림은 워크플로 정의만 읽습니다.
crm.스키마.커스텀.읽기	읽다	사용자 지정 스키마(hubspot.schemas, 사용자 지정 개체 정의)를 동기화하는 경우에만 가능합니다. 엔터프라이즈 계정에만 해당됩니다.

쿼리 스트림에 붙여넣기

앱 액세스 토큰: 13단계에서 복사한 서비스 키(pat-으로 시작함), 기존 개인 앱 토큰 또는 개발자 플랫폼 앱의 정적 인증 토큰을 사용하세요.

흔히 발생하는 문제

새 키를 붙여넣은 직후 '액세스 토큰이 유효하지 않거나 만료되었습니다'라는 오류와 함께 연결 테스트가 실패합니다.

왜: 해당 값은 앱 키나 서비스 키가 아닙니다. 흔히 혼동되는 부분은 HubSpot 개발자 도구에 사용되는 개인 액세스 키 또는 개발자 API 키입니다. 이 키는 개발 → 키 메뉴의 서비스 키 옆에 있습니다.

고치다: 개발 → 키 → 서비스 키로 이동하여 키를 열고, 표시를 클릭한 다음 복사하여 앱 액세스 토큰에 붙여넣으세요. 연결을 다시 테스트하면 연결됨으로 표시됩니다.

마법사는 테스트를 시작하기도 전에 "유효한 HubSpot 앱 토큰이 아닙니다"라고 표시합니다.

왜: 키의 일부만 붙여넣어졌습니다. 텍스트가 'pat-'으로 시작하지 않거나 매우 짧거나 공백이 포함되어 있습니다.

고치다: HubSpot으로 돌아가서 '표시'를 클릭한 다음 '링크 복사'를 사용하고(텍스트를 직접 선택하지 마세요) 다시 붙여넣으세요.

HubSpot의 왼쪽 탐색 메뉴에 개발(Development)이 보이지 않거나, 키(Keys) 항목 아래에 서비스 키(Service Keys)가 없습니다.

왜: HubSpot 사용자는 슈퍼 관리자가 아니며 개발자 도구 접근 권한이 없습니다.

고치다: 회사 내 최고 관리자에게 키를 생성(2~13단계)하여 마법사에 붙여넣거나 개발자 도구 액세스 권한을 부여해 달라고 요청하세요.

연결 테스트 결과는 '연결됨'으로 표시되지만, 한 테이블이 '접근 금지' 오류와 함께 동기화되지 않거나 비어 있는 상태로 유지됩니다.

왜: 핵심은 해당 테이블에 대한 읽기 권한이 없거나 HubSpot 플랜에 해당 기능이 포함되어 있지 않다는 것입니다(워크플로우에는 Professional 또는 Enterprise 플랜이 필요하고, 사용자 지정 스키마에는 Enterprise 플랜이 필요하며, 피드백에는 Service Hub Professional 또는 Enterprise 플랜이 필요합니다).

고치다: 키를 열고(개발 → 키 → 서비스 키 → 키 이름), 편집을 클릭한 다음 권한 목록에서 범위를 추가하고 저장한 후 다시 동기화하세요. 사용 중인 요금제에 해당 기능이 포함되어 있지 않다면 연결의 동기화 설정에서 해당 테이블을 비활성화하세요.

이전에는 정상적으로 작동하던 동기화 작업이 '유효하지 않거나 만료된 액세스 토큰' 오류와 함께 실패하기 시작했습니다.

왜: 누군가 키를 교체했거나 삭제했습니다. '지금 교체 및 만료'를 선택하면 이전 키가 즉시 비활성화되고, '나중에 교체 및 만료'를 선택하면 7일 후에 비활성화됩니다.

고치다: 개발 → 키 → 서비스 키 → 키 이름 → 표시 → 복사에서 현재 키를 복사합니다. 데이터 에이전트에서 HubSpot 연결을 편집하고 앱 액세스 토큰에 붙여넣은 다음 연결 테스트를 실행합니다.

기존 비공개 앱 토큰을 사용하는 경우 일부 테이블에서 USER_DOES_NOT_HAVE_PERMISSIONS 오류가 발생합니다.

왜: 비공개 앱을 만든 HubSpot 사용자가 계정에서 삭제되었습니다.

고치다: 앱 토큰을 갱신(개발 → 레거시 앱 → 앱 → 갱신)하고 새 토큰을 연결에 붙여넣거나, 서비스 키를 생성하세요.

'레거시 앱 만들기' 옵션을 찾을 수 없거나, HubSpot 문서에서는 비공개 앱을 레거시 앱이라고 부릅니다.

왜: HubSpot은 새로운 레거시 비공개 앱 생성 기능을 종료합니다(2026년 9월 28일 이후 생성된 계정은 이미 비활성화되었으며, 이전 계정은 2026년 10월 26일부터 비활성화됩니다). 기존 비공개 앱은 계속 작동합니다.

고치다: 서비스 키를 생성합니다(주요 단계). 기존의 비공개 앱 토큰은 그대로 사용할 수 있습니다.

쿼리 스트림의 데이터가 HubSpot에서 보이는 데이터와 일치하지 않습니다.

왜: 해당 키는 다른 HubSpot 계정(예: 테스트 또는 샌드박스 계정)에서 생성되었습니다.

고치다: 올바른 HubSpot 계정으로 전환하여 거기서 키를 생성한 다음 연결에 붙여넣으세요.

알아야 할 한계

HubSpot의 서비스 키 및 비공개 앱 요청 제한은 무료 및 Starter 플랜의 경우 키당 10초당 100회, Professional 및 Enterprise 플랜의 경우 190회, API 제한 증가 추가 기능 사용 시 250회입니다. 에이전트는 이러한 제한 중 가장 낮은 수치를 기준으로 속도를 조절하므로 대규모 CRM의 첫 번째 전체 동기화에는 다소 시간이 걸릴 수 있습니다.
HubSpot 계정당 일일 요청 한도는 무료 및 Starter 플랜의 경우 250,000건, Professional 플랜의 경우 625,000건, Enterprise 플랜의 경우 1,000,000건입니다. 이 한도는 계정 내 모든 비공개 앱 및 서비스 키에서 공유되므로 다른 통합 기능도 동일한 예산을 사용합니다.
HubSpot의 CRM 검색 기능은 상담원이 변경된 기록만 가져오는 데 사용되며, 계정당 초당 5건의 요청과 쿼리당 최대 10,000개의 결과를 허용합니다.
일부 테이블은 HubSpot 플랜에 따라 다릅니다. 워크플로(Professional 또는 Enterprise), 사용자 지정 스키마(Enterprise), 피드백(Service Hub Professional 또는 Enterprise)이 이에 해당합니다.
서비스 키는 현재 공개 베타 버전(2026년 2월 10일부터)으로 제공되고 있으므로 HubSpot에서 세부 정보를 변경할 수 있습니다. HubSpot은 6개월마다 서비스 키를 교체할 것을 권장합니다.
2026년 9월 28일 이후에 생성된 계정이나 2026년 10월 26일 이후에 생성된 이전 계정에서는 새로운 레거시 프라이빗 앱을 만들 수 없습니다. 기존 앱과 토큰은 계속 작동합니다.

연결 이름: 나중에 알아볼 수 있는 이름들입니다. 예를 들어, 판매 데이터베이스 같은 것이죠.
앱 액세스 토큰: HubSpot 비공개 앱 토큰(pat-으로 시작)은 설정 > 통합 > 비공개 앱 > 앱 > 인증 탭에서 찾을 수 있습니다.

클릭 테스트 연결읽을 때 연결됨클릭 저장연결은 몇 초 내에 에이전트에 도달합니다.

오픈 데이터 에이전트

테스트에 실패했나요? 일반적으로 권한이 누락되었거나 잘못된 HubSpot 계정의 자격 증명을 사용했기 때문입니다. 위의 안내에는 해당 내용이 나와 있습니다. 일반적인 문제 그리고 그 해결책들.

See your data in Query Builder 선택 과목

You can look at your HubSpot account before Excel is involved at all. Open 쿼리 빌더 in the portal and pick the connection you just made. The 스키마 tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click 실행 and the rows appear under 결과. Query Builder is on every plan, Free included.

On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.
Excel에 쿼리 스트림 추가

엑셀에서 다음으로 이동하세요. 삽입 → 추가 기능 가져오기검색하세요 쿼리 스트림그리고 클릭하세요 추가하다또는 바로 열어보세요. Microsoft AppSource에서 Query Streams를 검색하세요.리본 메뉴에 '스트림 쿼리' 버튼이 나타납니다. 동일한 계정으로 로그인하세요.

Windows 및 Mac용 Microsoft 365 Excel과 웹 버전 Excel에서 작동합니다.
첫 번째 테이블을 가져오세요

"쿼리 스트림" 버튼을 클릭하고 선택하세요. 쿼리를 스트리밍하세요그리고 방금 연결한 연결을 선택하세요.

실행하려는 쿼리를 입력하세요. 이 쿼리는 테이블에서 몇 개의 열을 가져옵니다. 허브스팟딜 테이블:
예시 · SQL
```
hubspot.deals 테이블에서 dealname, dealstage, amount, closedate를 closeate 기준으로 내림차순으로 정렬하고, 개수 제한을 100으로 설정합니다.
```
아래에 목적지 정보 선택하다 새 시트를 만드세요그런 다음 재생 버튼(▶ 화살표)을 누르세요. 1~2초 안에 행이 Excel에 나타납니다. 데이터가 변경될 때마다 재생 버튼을 다시 누르면 시트가 자동으로 업데이트됩니다.

SQL을 모르시나요? Build it in 쿼리 빌더 first and paste it here, or pick it from Saved Queries if you saved it.

그게 다예요. 데이터는 스프레드시트에 저장되어 있으며 한 번의 클릭으로 최신 상태를 유지할 수 있습니다. 요청하신 행 외에는 네트워크를 통해 전송된 데이터가 없습니다.

좋은 다음 행보입니다

쿼리를 저장하세요 포털에 저장되므로 엑셀이나 구글 시트에서 한 번의 클릭으로 다시 실행할 수 있습니다.
필터를 추가하세요 날짜 범위를 지정할 수 있으므로 편집 없이 동일한 쿼리로 "이번 달"이라는 답변을 얻을 수 있습니다.
결과를 공유하세요 동료와 함께 있을 때, 그들은 당신의 자격 증명이 아니라 행 목록만 봅니다.

사람들이 묻는 질문

HubSpot 계정이 설치된 컴퓨터와 Excel이 같은 컴퓨터에 있어야 하나요?

아니요. 에이전트만 HubSpot 계정이 있는 위치에 있으면 됩니다. Excel은 인터넷에 연결된 모든 컴퓨터에서 실행할 수 있으며, 웹 버전 Excel이나 Mac용 Excel도 포함됩니다. 계정으로 추가 기능에 로그인하면 연결이 자동으로 설정됩니다.

내 데이터가 쿼리 스트림으로 복사되나요?

아니요. 에이전트는 데이터가 있는 위치에서 쿼리를 실행하고 반환된 행만 전송합니다. 그 과정에서 어떤 것도 동기화되거나 저장되지 않습니다.

무료 플랜으로 이 모든 기능을 이용할 수 있나요?

네. 무료 플랜은 만료되는 체험판이 아니라, 계속 사용하실 수 있는 플랜입니다. 자세한 내용은 해당 페이지에서 확인하세요. 가격 페이지.

맥용 엑셀과 호환되나요?

예. 맥과 윈도우용 Microsoft 365 Excel, 그리고 웹 버전 Excel 모두 가능합니다.

아직도 막히셨나요? 열려 있는 지원 쿼리 스트림에서 현재 단계와 표시되는 내용을 알려주시면 연결해 드리겠습니다.

무료 플랜 계정을 만드세요 무료 혜택 내용을 확인하세요

Query Streams는 동일한 데이터를 다음과 연결합니다.Google 스프레드시트 클로드, 커서 및 ChatGPT REST API 그리고 더 많은 것들

모든 가이드 HubSpot

원하는 설정이 아닌가요?

엑셀 통합 문서 자체를 쿼리하고 싶으신가요? Excel Folder는 통합 문서가 담긴 폴더를 테이블로 읽어들입니다. → Excel Folder

Setup trouble?

Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

당신이 최종적으로 얻게 될 것

필요한 것

Query Streams 계정

항상 켜져 있는 컴퓨터의 에이전트

HubSpot 로그인 정보

5단계로 연결하세요

계정을 만드세요

항상 켜져 있는 컴퓨터에 에이전트를 설치하십시오.

HubSpot 계정을 지정하세요

시작하기 전에

단계

대안

부여할 권한

쿼리 스트림에 붙여넣기

흔히 발생하는 문제

알아야 할 한계

See your data in Query Builder 선택 과목

Excel에 쿼리 스트림 추가

첫 번째 테이블을 가져오세요

좋은 다음 행보입니다

사람들이 묻는 질문

관련 가이드

Share This Article :