HubSpot 모루
쿼리 스트림
Query Streams는 Anvil과 HubSpot의 원활한 통합을 지원하며, HubSpot CRM 데이터를 Anvil 스프레드시트에 자동으로 동기화합니다. QueryStreams.com에서 무료로 가입하세요. HubSpot에서 Anvil로의 데이터 파이프라인 자동화를 단 몇 분 만에 시작하세요.
이 가이드에서는 Query Streams를 사용하여 HubSpot에서 Anvil로 자동 데이터 동기화를 설정하는 방법을 안내합니다. 재무팀에 CRM 데이터를 최신 상태로 유지하거나, 구독 지표를 협업 작업 공간에 동기화하거나, 매출 보고 워크플로를 자동화해야 하는 경우, Query Streams는 HubSpot과 Anvil.works 통합을 위한 안전하고 코딩이 필요 없는 솔루션을 제공합니다.
예약된 자동화
시간별, 일별 또는 사용자 지정 일정에 따라 동기화
보안 설계
API 키는 네트워크에 저장됩니다.
번개처럼 빠른
최적화된 데이터 스트리밍
스마트 싱크
자동으로 삽입, 업데이트, 삭제
Anvil HubSpot 통합이란 무엇입니까?
Anvil HubSpot 통합은 HubSpot 결제 플랫폼을 Anvil에 연결하여 수동으로 내보내거나 가져올 필요 없이 자동으로 데이터를 동기화합니다. 쿼리 스트림은 HubSpot 계정과 Anvil 간의 안전한 연결 고리 역할을 하며, 저장된 SQL 쿼리를 HubSpot 데이터에 대해 예약된 시간에 실행하고 결과를 스프레드시트에 직접 푸시합니다.
주요 기능:
- 자동 동기화: 쿼리를 시간별, 일별 또는 사용자 지정 간격으로 실행하도록 예약합니다.
- HubSpot에 대한 SQL 액세스: 익숙한 SQL을 사용하여 고객, 연락처, 구독, 요금 등을 조회하세요.
- 완전 동기화 모드: 새 행을 삽입하고, 기존 행을 업데이트하고, 삭제된 레코드를 자동으로 제거합니다.
- 안전한 연결: HubSpot API 키는 네트워크 내에서 안전하게 보호됩니다.
- 코딩이 필요 없습니다. Query Streams 웹 포털을 통해 모든 설정을 구성하세요.
전제 조건
앤빌 계정
API 접근 권한이 있는 Anvil 계정(비즈니스 및 엔터프라이즈 플랜에서 이용 가능하며, 무료 체험판을 통해서도 이용할 수 있습니다).
저장된 쿼리
동기화하려는 HubSpot 데이터를 반환하는 쿼리가 쿼리 스트림에 하나 이상 저장되어 있어야 합니다.
1단계: HubSpot 쿼리 생성
통합을 설정하기 전에 Anvil과 동기화할 HubSpot 데이터를 반환하는 저장된 쿼리가 필요합니다. 쿼리 스트림을 사용하면 HubSpot 데이터를 마치 데이터베이스처럼 SQL 쿼리로 검색할 수 있습니다.
- Query Streams 포털에 로그인하세요. 방문하다 my.querystreams.com 로그인하세요
- 쿼리 빌더를 엽니다. 대시보드에서 쿼리 빌더로 이동합니다.
- HubSpot 데이터 소스를 선택하세요. 왼쪽의 데이터 탐색기 사이드바에서 데이터 영역을 확장한 다음 HubSpot 커넥터를 선택하고 쿼리할 API 데이터를 선택합니다.
- SQL 쿼리를 작성하세요: SQL 구문을 사용하여 HubSpot 테이블을 쿼리합니다.
SELECT customer_email, customer_name, amount_dollars, status, created FROM contacts WHERE created >= NOW() - INTERVAL '30 days' AND status = 'paid' ORDER BY created DESC LIMIT 500;
사용 가능한 HubSpot 테이블: 고객, 콘택트 렌즈, 구독, 요금, 결제 의도, 환불, 잔액 거래, 제품, 물가, 이벤트, 분쟁, 지급금그 외에도 더 많은 것들이 있습니다.
- 테스트 후 저장: 쿼리를 실행하여 결과를 확인한 다음 "Anvil의 최근 유료 연락처"와 같이 설명적인 이름으로 저장하세요.
id 또는 송장 IDAnvil이 행을 일치시키는 데 사용할 수 있는 )입니다.
2단계: Anvil.works 통합 생성
이제 자동화 기능을 통해 저장된 쿼리를 Anvil에 연결합니다.
- 자동화 메뉴로 이동하세요: Query Streams 포털에서 클릭하세요. 자동화 왼쪽 사이드바에
- 새로운 통합을 생성하세요: 클릭 새로운 통합 설정 마법사를 시작하려면
- 저장된 쿼리를 선택하세요: 1단계에서 생성한 HubSpot 쿼리를 선택하세요.
- 목적지로 Anvil을 선택하세요: 선택하다 모루 사용 가능한 플랫폼 목록에서
3단계: Anvil 계정을 연결하세요
Anvil.works 통합을 위해서는 Anvil.works 앱에 Query Streams 구성 요소를 설치하고 보안 연결 키로 구성해야 합니다.
타사 종속성 추가
Anvil.works 앱에서 다음으로 이동하세요. 설정 → 종속성
를 클릭합니다. “제3자” 탭을 누르고 다음 코드를 입력하세요:
47C7VQG6QJTVY16B
서버 모듈 생성
Anvil.works 앱에서 다음을 생성하세요. 서버 모듈 그리고 다음 코드를 추가하세요:
쿼리 스트림에서 커넥터를 가져옵니다. 커넥터를 초기화합니다("YOUR_AUTH_KEY").
보안 인증 키 생성
쿼리 스트림 자동화 설정에서:
- 클릭 보안 키 생성 (또는 직접 입력하세요)
- 인증 키를 복사하세요
- 바꾸다
YOUR_AUTH_KEYAnvil.works 코드에 이 키를 사용하세요.
Anvil 앱 URL을 입력하세요
쿼리 스트림에서 게시된 Anvil.works 앱 URL(anvil.app 도메인 또는 사용자 지정 도메인)을 입력하세요.
예시: https://your-app.anvil.app 또는 https://yourdomain.com
연결 테스트
클릭 연결 테스트 Query Streams가 Anvil.works 앱과 통신할 수 있는지 확인하려면
4단계: 목적지 선택 시트
HubSpot 데이터가 Anvil.works에 동기화될 위치를 선택하세요.
- 시트를 찾아보세요: 쿼리 스트림을 사용하면 사용 가능한 Anvil 시트와 작업 공간이 표시됩니다.
- 용지를 선택하세요: 데이터를 동기화할 기존 시트를 선택하거나, 새 시트를 만드세요
- 컬럼 매핑: Query Streams는 쿼리 열을 Anvil 열에 자동으로 매핑합니다. 필요에 따라 검토하고 조정하십시오.
5단계: 동기화 모드 구성
쿼리 스트림에서 데이터 동기화를 처리하는 방법을 선택하세요.
Append 모드
- 아래쪽에 새 행 추가
- 기존 행을 수정하지 않음
- 데이터를 절대 삭제하지 않습니다.
- 역사 기록을 보존합니다
Full Sync 모드
인기 있는- 삽입물 새로운 기록
- 업데이트 변경된 기록
- 삭제 삭제된 기록
- 키 열이 필요합니다
주요 열 선택: 전체 동기화 모드를 사용하는 경우 각 행을 고유하게 식별하는 열을 선택하십시오. 이 열은 쿼리 결과와 Anvil 시트 모두에 있어야 합니다.
컬럼 동기화 동작(동기화 vs. 유지)
필드 매핑의 각 열에 대해 쿼리 스트림이 동기화 중에 해당 열을 처리하는 방법을 선택하세요.
동기화(기본값)
원천 값 항상 덮어씁니다 목표
보존하다
목표값은 덮어쓰기되지 않음
송장 ID– 주요 필드고객 이메일– 동기화금액_달러– 동기화상태– 동기화
담당자에게 배정됨- 보존하다후속 조치 사항- 보존하다우선 사항- 보존하다
6단계: 동기화 일정 설정
HubSpot에서 Anvil로 데이터를 동기화하는 쿼리 스트림의 동기화 시점을 구성합니다.
7단계: 검토 및 활성화
- 구성을 검토합니다: 쿼리, 대상, 동기화 모드 및 일정 등 모든 설정을 확인하십시오.
- 통합 기능에 이름을 지정하세요: "HubSpot 연락처를 Anvil 일일 동기화에 저장"과 같이 설명적인 이름을 지정하세요.
- 활성화: 클릭 통합 생성 저장하고 활성화하려면
- 초기 동기화를 실행합니다. 클릭 지금 실행하세요 첫 번째 동기화를 수행하고 모든 것이 제대로 작동하는지 확인합니다.
축하해요!
HubSpot과 Anvil.works 연동이 완료되었습니다. CRM 데이터는 설정하신 일정에 따라 자동으로 동기화됩니다.
통합 모니터링
활성화 후에는 자동화 대시보드에서 Anvil HubSpot 통합을 모니터링할 수 있습니다.
마지막 동기화 시간
데이터가 마지막으로 동기화된 시점을 확인하세요.
행 동기화됨
삽입, 업데이트 및 삭제된 행 수를 확인하세요.
오류 알림
동기화 실패 시 알림을 받으세요
동기화 기록
이전 동기화 작업 및 그 결과를 검토합니다.
Anvil HubSpot 통합의 일반적인 사용 사례
영업 파이프라인 추적
HubSpot의 월별 매출, 월간 반복 매출(MRR) 및 결제 추세를 Anvil에 동기화하여 경영진 대시보드 및 재무 계획에 활용하세요.
거래 관리
Anvil 협업 공간에서 활성 구독, 해지된 계정 및 구독 지표를 팀원들과 공유하여 최신 정보를 유지하세요.
컨택트 애널리틱스
고객 성공 및 영업 팀을 위해 고객 데이터, 고객 생애 가치 및 결제 내역을 Anvil에 자동으로 동기화합니다.
거래 단계 모니터링
Anvil.works에서 결제 실패, 결제 재시도 및 위험 구독을 추적하여 고객에게 사전에 연락하세요.
판매 예측
환불, 분쟁, 잔액 거래 및 지급 내역을 Anvil과 동기화하여 회계 및 재무팀에서 확인할 수 있도록 합니다.
자주 묻는 질문
❓ HubSpot에서 Anvil로 데이터를 얼마나 자주 동기화할 수 있나요? +
Query Streams는 매시간부터 사용자 지정 간격까지 다양한 동기화 일정을 지원합니다. 대부분의 경우, 일별 또는 시간별 동기화는 데이터의 최신성과 시스템 리소스 측면에서 적절한 균형을 제공합니다.
🔒 HubSpot API 키는 동기화 중에 안전하게 보호되나요? +
예. HubSpot API 키는 Query Streams 에이전트를 통해 네트워크 내에서 안전하게 보호됩니다. 데이터는 전송 중에 암호화되며, Anvil API 토큰은 안전하게 저장됩니다. Query Streams는 CRM 원본 데이터를 절대 저장하지 않습니다.
⚠ 동기화가 실패하면 어떻게 되나요? +
Query Streams는 동기화 실패 시 재시도를 수행하고 지속적인 오류가 발생하면 알려줍니다. 동기화 기록에서 오류 세부 정보를 확인할 수 있으며, 문제가 해결되면 수동으로 재시도를 실행할 수 있습니다.
📂 HubSpot 쿼리를 여러 Anvil 시트에 동기화할 수 있나요? +
예. 각 쿼리와 대상 시트에 대해 별도의 통합을 생성하세요. 각 통합은 서로 다른 HubSpot 테이블, 동기화 모드 및 일정을 사용할 수 있습니다.
💳 HubSpot의 어떤 데이터를 Anvil과 동기화할 수 있나요? +
고객, 연락처, 구독, 청구, 결제 의도, 환불, 잔액 거래, 제품, 가격, 이벤트, 분쟁, 지급, 쿠폰, 송장 항목 및 구독 항목을 포함한 15개의 HubSpot 테이블을 조회하고 동기화할 수 있습니다.

