HubSpot 로고

CRM 및 마케팅

연결하다 HubSpot 엑셀, 구글 시트, AI 및 REST로

CRM 데이터를 가상 테이블로 관리합니다. 연락처, 회사, 거래, 파이프라인 등을 저장하며, 데이터 웨어하우스와 동일한 읽기 전용 SQL 쿼리를 사용합니다.

무료로 시작하세요 13개 목적지

하나의 연결, 모든 표면

HubSpot 데이터가 저장될 수 있는 위치

HubSpot 실시간 API 데이터 SQL 테이블로
연합 쿼리 + 기타 커넥터 · SQL 하나 다양한 출처에서 · 모든 계획
네트워크 에이전트
  • 1 발신 연결
  • 0 입국항
  • 읽기 전용 · 자격 증명은 그대로 유지됩니다

실행 중

Query Streams는 HubSpot 포털을 연락처, 회사, 거래, 티켓, 참여, 견적, 송장, 목록 및 해당 파이프라인 정의를 포함하는 31개의 SQL 테이블로 변환합니다. 이 테이블은 Microsoft Excel, Google Sheets, Power BI, MCP를 통한 AI 비서 및 REST 엔드포인트에서 읽을 수 있습니다. 연관 관계는 별도의 테이블로 제공되므로 연락처-회사 및 거래-품목 연결은 수동으로 재구성해야 하는 내보내기 작업이 아닌 일반적인 JOIN으로 처리됩니다.

  1. 귀사 팀, 협력업체 및 파트너 여러분께

  2. HubSpot을 Excel로 마이크로소프트 엑셀 · 엑셀 추가 기능

    HubSpot의 실시간 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. 데스크톱 Excel, Excel Online, Microsoft 365에서 사용 가능합니다.

    HubSpot 가이드

  3. HubSpot에서 Google Sheets로 스프레드시트 추가 기능

    사이드바에서 저장된 HubSpot 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공유 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.

    HubSpot 가이드

  4. HubSpot에 대해 Nova에게 문의하세요. Nova AI · 텍스트를 SQL로 변환

    쉬운 영어로 질문하세요. Nova는 이미 HubSpot 테이블을 알고 있으므로 SQL을 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 작성하거나 계정 정보를 제공할 필요가 없습니다.

    Nova는 어떻게 작동하나요?

  5. HubSpot에서 데이터 뷰어로 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱

    HubSpot 분석 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유할 수 있습니다. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 최신 정보가 표시됩니다. 공유받은 사람은 결과만 볼 수 있고, SQL 쿼리나 계정 정보는 절대 볼 수 없습니다.

    데이터 뷰어 작동 방식
  6. 앱 및 시스템용

  7. HubSpot REST API HTTP 엔드포인트

    HubSpot 쿼리를 인증된 JSON 엔드포인트로 게시하여 모든 애플리케이션에서 호출할 수 있도록 합니다. OpenAPI 3.1 사양을 지원하며 Postman, Insomnia, Hoppscotch 컬렉션이 이미 준비되어 있습니다. 데이터베이스 포트는 열지 않습니다.

    REST API 작동 방식

  8. HubSpot에서 Power BI로 파워 쿼리 M

    생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 HubSpot의 실시간 결과를 읽어옵니다. ODBC 드라이버도 필요 없고 데이터베이스 포트도 열 필요가 없습니다.

    Power BI 작동 방식

  9. HubSpot에서 Airtable로 자동화 플랫폼

    HubSpot 행을 예약된 시간에 Airtable 베이스에 동기화하거나 Airtable 자동화 스크립트 내에서 가져올 수 있습니다.

    HubSpot 가이드

  10. HubSpot에서 Baserow로 자동화 플랫폼

    HubSpot에서 REST 엔드포인트를 통해 Baserow 테이블로 데이터를 전송합니다(자체 호스팅 또는 Baserow 클라우드).

    HubSpot 가이드

  11. HubSpot에서 SeaTable로 자동화 플랫폼

    파일을 내보내거나 데이터베이스를 노출하지 않고도 SeaTable 데이터베이스를 HubSpot 데이터로 최신 상태로 유지하세요.

    HubSpot 가이드

  12. HubSpot에서 Smartsheet로 자동화 플랫폼

    HubSpot 결과를 Smartsheet 그리드에 추가하여 계획 및 보고서가 지난주 내보내기가 아닌 원본 시스템에서 읽어오도록 합니다.

    HubSpot 가이드

  13. HubSpot에서 Anvil까지 앤빌 웍스 · 앱 플랫폼

    Anvil Python 앱을 HubSpot에 연결할 때 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 통해 연결하는 방법입니다.

    HubSpot 가이드
  14. AI 도구의 경우

  15. HubSpot MCP 서버 Claude, Cursor 및 MCP 고객

    인공지능 어시스턴트에게 HubSpot에 대한 읽기 전용 액세스 권한을 부여하고, 올바른 SQL 쿼리를 작성하는 데 필요한 스키마만 제공하세요. 채팅창에 자격 증명을 입력할 필요는 없습니다.

    HubSpot 가이드
  16. 사람들에게 전달됨

  17. HubSpot 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅

    HubSpot 쿼리를 예약하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송하거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 초과할 때까지 메시지 전송을 보류할 수 있습니다.

    알림 및 보고서 작동 방식

작동 방식

5단계, 인바운드 방화벽 변경 없음

01

HubSpot 포털에서 비공개 앱을 만들고 관심 있는 개체에 대해 읽기 권한을 부여하세요.

02

네트워크 에이전트를 설치하고 액세스 토큰을 붙여넣으세요. 토큰은 거기에 저장됩니다. HubSpot은 항상 사용자 네트워크에서 오는 신호만 수신합니다.

03

31개 테이블 중 동기화할 테이블과 동기화 빈도를 선택하세요. 연락처, 회사, 거래, 담당자, 파이프라인, 파이프라인 단계 및 속성은 기본적으로 활성화되어 있습니다.

04

hubspot.deals, hubspot.companies 및 기타 데이터베이스에 대해 일반 SQL 쿼리를 직접 작성하거나 Nova가 자동으로 작성하도록 할 수 있습니다.

05

Excel, Sheets, Power BI, MCP 또는 REST에서 데이터를 읽어와 동일한 명령문으로 자체 데이터베이스에 조인할 수 있습니다.

기능 심층 분석

HubSpot이 제공하는 것

협회는 퍼즐이 아니라 표와 같습니다.

HubSpot에서 데이터를 내보낼 때 가장 불편한 점은 중요한 정보가 개체 간의 링크에 있다는 것입니다. CSV 형식의 연락처 파일에는 이러한 링크가 포함되어 있지 않습니다. 대신 각 행에 양쪽 개체가 모두 포함된 별도의 표로 표시됩니다.

  • hubspot.associations 테이블에는 출발 객체, 도착 객체, 연관 유형 및 레이블이 저장되므로 거래의 연락처 또는 티켓의 회사는 일반 JOIN으로 연결됩니다.
  • 기업 연락처, 연락처를 통한 거래, 기업을 통한 거래, 거래를 통한 항목별 비용, 연락처를 위한 티켓, 기업 방문 티켓 등 모든 것이 포함됩니다.
  • 파이프라인과 파이프라인 단계도 별도의 테이블로 관리되므로, 거래 단계는 불투명한 ID가 아닌 이름과 순서로 확인됩니다.

31개의 테이블

  • CRM 객체 — 연락처, 회사, 거래, 티켓, 소유자, 파이프라인, 파이프라인 단계, 제품, 품목.
  • 참여 — 통화, 이메일, 회의, 메모, 업무, 소통.
  • 상업 — 견적, 송장, 구독, 결제, 세금, 할인, 수수료.
  • 마케팅 — 마케팅 이벤트, 양식, 양식 제출, 피드백 제출.
  • 목록 및 자동화 — 목록, 워크플로.
  • 정의 — 속성, 스키마, 연관 관계.

사용자 지정 속성이 실제로 있는 위치

사람들이 작동 방식이 다르다고 오해하는 부분이기 때문에 정확하게 설명하는 것이 중요합니다. 각 객체 테이블에는 고정된 명명된 열 집합(표준 필드)이 있으며, HubSpot이 반환하는 나머지 모든 데이터(사용자 지정 속성 포함)는 동일한 행의 raw_data JSON 열에 저장됩니다.

  • 어떤 것도 버려지지 않습니다. 사용자 지정 속성은 쿼리할 수 있지만, 별도의 열이 아니라 JSON 열을 통해 쿼리할 수 있습니다.
  • hubspot.properties 파일에는 15가지 객체 유형에 걸쳐 모든 속성 정의가 나열되어 있습니다. — 이름, 레이블, 유형, 필드 유형 — 이렇게 하면 존재하는 항목과 그 명칭을 조회할 수 있습니다.
  • hubspot.schemas 파일에는 사용자 정의 객체 정의가 저장됩니다. 사용자 정의 객체 레코드는 별도의 테이블로 동기화되지 않습니다.
  • 사용자 지정 속성을 스프레드시트에서 일급 열처럼 표시하려면 저장된 쿼리에서 해당 속성을 꺼내세요. 이렇게 하면 한 번만 표현식을 작성하면 해당 쿼리를 사용하는 모든 사용자가 적절한 열을 볼 수 있습니다.

모든 API 커넥터에서 공유됨

모든 API 커넥터의 작동 방식

  • 귀하의 계정은 테이블이 됩니다. 엔드포인트는 기본 키와 인덱스가 있는 형식화된 SQL 테이블에 매핑되므로 JSON을 페이지별로 탐색하는 대신 SELECT, JOIN 및 GROUP BY를 작성할 수 있습니다.
  • 동기화할 항목과 동기화 빈도를 직접 선택할 수 있습니다. 각 테이블마다 고유한 업데이트 간격이 있거나 아예 없을 수도 있습니다. 공급업체의 API에서 지원하는 경우, 마지막 실행 이후 변경된 레코드만 가져옵니다.
  • 이 사본은 당신 것입니다. — 해당 정보는 에이전트와 함께 사용자의 컴퓨터에 있는 AES-256-GCM으로 암호화된 DuckDB 파일에 저장됩니다. 저희 클라우드에 저장되는 것이 아닙니다.
  • 판매자는 오직 당신에게서만 연락을 받습니다. — 에이전트가 사용자 네트워크에서 직접 API를 호출하므로 Query Streams가 쿼리에 응답하는 데 토큰이 필요하지 않습니다.

알아두면 좋겠네요.

  • 이것은 동기화된 복사본이며, 실시간 프록시가 아닙니다. — 쿼리는 이미 가져온 데이터를 다시 읽기 때문에 SQL 속도로 반환되며 API 사용량 제한을 초과하지 않습니다. 또한 선택한 테이블은 읽는 즉시 오래된 행을 새로 고칠 수 있습니다.
  • 요금 제한이 준수됩니다. 각 커넥터는 공급업체가 게시한 제한 범위 내에서 안정적으로 작동하므로, 보고서로 인해 해당 커넥터를 사용하는 다른 모든 서비스에 대한 계정 속도가 제한되는 일은 없습니다.
  • 아무것도 버려지지 않습니다 — 테이블에 이름이 지정되지 않은 필드는 raw_data JSON 열에 저장되므로 해당 열을 쿼리할 수 있습니다.
  • 데이터베이스에 연결하세요 — 동일한 명령문에서 API 테이블과 SQL Server 테이블을 함께 사용하는 것은 일반적인 쿼리일 뿐, 통합 프로젝트가 아닙니다.

크로스 소스 SQL

HubSpot을 나머지 데이터와 연결하세요

CRM 시스템은 계정 소유자가 누구인지 알고, 결제 처리 시스템은 결제 내역을 알고 있습니다. 하지만 두 시스템 모두 서로의 정보를 동시에 알지는 못하며, 분기 말에 요구되는 최종 결과 수치를 얻으려면 두 정보가 같은 행에 있어야 합니다. 각 시스템은 자신이 처리할 수 있는 부분만 실행하고 결과를 스트리밍 방식으로 전송하며, 최종 결과 집계는 중앙에서 이루어집니다. 시스템 간의 직접적인 데이터 교환은 없으며, 데이터도 복사되지 않습니다.

3개의 연결 · 3명의 에이전트

HubSpot CRM 및 마케팅
PostgreSQL 관계형 엔진
스트라이프 결제 및 청구

한 가지 진술

HubSpot 계정, 고객 정보, Stripe 송장
선택   h.industry, COUNT(DISTINCT h.id) AS accounts, SUM(i.amount_due) / 100 AS invoiced
FROM     크름.허브스팟.컴퍼니1   h
JOIN     pg_crm.공개.고객2 c ON c.domain = h.domain
JOIN     청구.stripe.invoices3 i ON i.customer = c.stripe_id
그룹 기준 h.산업
주문 기준 청구서 발행 DESC;

세 가지 요소는 연결, 스키마, 테이블이며, 연결 이름은 사용자가 지정한 대로 지정할 수 있습니다. 예시 열은 예시일 뿐이며, 테이블은 실제 테이블 형태로 제공됩니다. HubSpot 거래에는 고객 정보가 포함되지 않으므로 조인은 회사 도메인에서 실행됩니다. 객체 간의 연결은 연관 테이블의 행으로 이루어지며, 계정이 아닌 거래를 원하는 경우 이 연관 테이블도 쿼리할 수 있습니다. Stripe는 가장 작은 통화 단위로 금액을 보고하므로 이러한 구분이 필요합니다. 모든 부분에는 읽기 전용 권한이 적용됩니다. SELECT, WITH, EXPLAIN만 사용 가능하며, 단일 쿼리에 대해 각 소스에서 제공할 수 있는 데이터의 양에 제한이 있습니다. 연합 쿼리의 작동 방식

연결 정보

HubSpot에 필요한 것

입증
에이전트에 저장된 비공개 앱 액세스 토큰입니다. 지속적으로 유지해야 하는 OAuth 왕복 인증이 아닙니다.
손을 뻗었다
네트워크에서 HubSpot까지 HTTPS 연결만 가능합니다. 수신 측에서는 아무것도 수신되지 않습니다.
스키마
허브스팟 — 즉, hubspot.deals, hubspot.contacts, hubspot.associations
테이블
31개 항목 중 연락처, 회사, 거래, 소유자, 파이프라인, 파이프라인 단계 및 속성 등 7개가 기본적으로 활성화되어 있습니다.
사용자 지정 속성
객체 행의 raw_data JSON 열에 저장되며, 정의는 hubspot.properties에 나와 있습니다. 열로 추가되지는 않습니다.
점진적
HubSpot의 CRM 검색 기능을 통해 최종 수정 날짜를 기준으로 검색하므로 기존 기록에 대한 수정 사항도 감지됩니다.
실시간 새로 고침
20개의 CRM 객체 테이블에서 사용 가능하며, 하나의 레코드를 키로 하는 쿼리는 HubSpot과 비교하여 확인한 후 응답합니다.
요금 제한
HubSpot에서 공개한 제한 속도에 맞춰 속도를 조절하므로, 보고서로 인해 다른 모든 사용자의 포털 속도가 저하되는 것을 방지할 수 있습니다.
로컬 복사본
에이전트 옆에 있는 AES-256-GCM으로 암호화된 DuckDB 파일이 사용자 컴퓨터에 있습니다.

읽기 전용은 구조적인 특성입니다. 커넥터는 HubSpot 쓰기 호출을 구현하지 않으며, 모든 요청은 읽기, 검색 또는 일괄 읽기입니다. 따라서 토큰의 범위와 관계없이 쿼리를 통해 거래 단계를 변경하거나 연락처 정보를 수정할 수 없습니다. 그럼에도 불구하고 비공개 앱의 범위를 읽기 전용으로 설정하는 것이 여전히 유용합니다.

동기화 연관 관계는 각 유형의 모든 객체를 순회하며 링크를 일괄적으로 읽어오기 때문에 여기서 가장 많은 리소스를 소모하는 테이블입니다. 링크가 실시간으로 필요한 경우가 아니라면 객체 테이블보다 더 긴 간격으로 동기화하는 것이 좋습니다.

공급업체 문서: www.hubspot.com

자주 묻는 질문

HubSpot 관련 질문

쿼리 스트림을 통해 HubSpot 데이터를 읽을 수 있는 도구는 무엇입니까?

Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 도구를 하나의 연결로 이용할 수 있습니다. 계정을 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.

HubSpot 계정에 접근하려면 방화벽 포트를 열어야 하나요?

아니요. Query Streams 네트워크 에이전트는 네트워크 내부에서 실행되며 암호화된 외부 연결을 하나만 설정합니다. 수신 트래픽을 수신하는 기능은 없으며 VPN도 필요하지 않고 계정은 기존 방화벽 규칙을 그대로 유지합니다.

쿼리 스트림을 통해 HubSpot의 데이터를 변경할 수 있나요?

아니요. 에이전트는 실행 시점에 읽기 전용을 적용합니다. 즉, 한 번에 하나의 문장만 처리하며, SELECT 및 관련 문만 사용 가능합니다. 자격 증명은 에이전트에 저장되며 쿼리 스트림으로 전송되지 않습니다.

Query Streams가 HubSpot에 연결하려면 무엇이 필요합니까?

접근 가능한 호스트, 역할 및 해당 암호만 있으면 됩니다. 에이전트가 드라이버를 탑재하므로 계정에 아무것도 설치되지 않습니다. 인증: 에이전트에 저장된 비공개 앱 액세스 토큰을 사용합니다. OAuth 왕복 인증처럼 토큰을 유지해야 하는 방식이 아닙니다. 연결 방식: 네트워크에서 HubSpot까지는 HTTPS를 사용합니다. 인바운드 트래픽은 없습니다. 스키마: hubspot - 따라서 hubspot.deals, hubspot.contacts, hubspot.associations 테이블이 있습니다. 테이블: 총 31개이며, 이 중 contacts, companies, deals, owners, pipelines, pipeline_stages, properties 테이블 7개가 기본적으로 활성화되어 있습니다.

HubSpot을 다른 데이터베이스와 동일한 쿼리로 연결할 수 있나요?

네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 HubSpot과 다른 연결을 동시에 참조할 수 있으며, 연결.스키마.테이블 형식으로 작성됩니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 다시 스트리밍합니다. 조인은 중앙에서 이루어지므로 소스 간에 직접 연결되지 않으며, 데이터 복사나 예약 실행도 없습니다. 읽기 전용은 모든 부분(SELECT, WITH, EXPLAIN만 해당)에 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 플랜 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.

HubSpot을 업무 현장에 배치하세요

에이전트를 설치하고, 계정을 지정한 다음, 목적지를 선택하세요.

무료로 시작하세요 모든 커넥터

읽기 전용 출국 전용 자격 증명은 에이전트에 저장됩니다.