---
title: "HubSpot 연결하기"
description: "Scratcher에서 HubSpot에 로그인하고, 선택한 속성으로 연락처를 생성하거나 업데이트하는 방법을 단계별로 안내합니다."
url: https://scratcher.io/ko/help/integrations/hubspot
language: ko
---

1. [도움말 센터](https://scratcher.io/ko/help)
2. [통합](https://scratcher.io/ko/help/integrations)
3. HubSpot 연결하기

# HubSpot 연결하기

Scratcher에서 HubSpot에 로그인하고, 선택한 속성으로 연락처를 생성하거나 업데이트하는 방법을 단계별로 안내합니다.

HubSpot 통합을 사용하면 가입한 모든 사람이 HubSpot에 연락처로 생성됩니다. 같은 이메일 주소의 연락처가 이미 있다면 그 연락처가 업데이트됩니다.

## 준비 사항

- HubSpot 계정. 무료 CRM을 포함한 모든 HubSpot 에디션에서 작동합니다.
- 앱을 연결할 수 있는 HubSpot 사용자. HubSpot에서는 **Super Admin** 또는 **App Marketplace** 액세스 권한이 있는 사용자입니다.
- 모든 기본 통합이 포함된 Scratcher 요금제. 버튼이 잠겨 있다면 [체험, 요금제 및 체험 종료 후](https://scratcher.io/ko/help/billing/trial-and-plans)를 참고하세요.

API 키는 필요하지 않습니다. HubSpot에 로그인해 액세스를 승인하면 됩니다.

## 1단계: HubSpot 연결하기

1. Scratcher에서 **설정** > **통합**으로 이동해 **HubSpot**을 클릭합니다.
2. **통합 설치**를 클릭합니다. HubSpot으로 이동합니다.
3. HubSpot에 로그인합니다. HubSpot 계정이 여러 개라면 연결할 계정을 선택하세요.
4. HubSpot에 Scratcher가 요청하는 권한이 표시됩니다. 앱 연결을 클릭합니다.
5. Scratcher로 돌아오면 HubSpot이 설치되어 있습니다.

## Scratcher가 요청하는 액세스

HubSpot은 다음 권한을 승인하도록 요청합니다.

- 연락처 읽기 및 쓰기(`crm.objects.contacts.read` 및 `crm.objects.contacts.write`): 이메일로 연락처를 찾고, 새 연락처를 만들고, 기존 연락처를 업데이트하는 데 필요합니다.
- 연락처 속성 읽기 및 쓰기(`crm.schemas.contacts.read` 및 `crm.schemas.contacts.write`): 필드 매핑에 연락처 속성을 표시하는 데 필요합니다.

Scratcher는 연락처만 다룹니다. 거래, 회사, 이메일 등 다른 항목은 읽거나 변경하지 않습니다.

## 2단계: 캠페인에서 켜기

1. 편집기에서 **연결** > **통합** > **HubSpot**으로 이동해 **활성화**를 클릭합니다.
2. HubSpot 계정을 두 개 이상 연결했다면 **계정 선택**에서 계정을 고릅니다.
3. **필드 매핑**에서 **필드 매핑 추가**를 클릭하고 필드를 HubSpot 연락처 속성과 연결합니다. 예를 들어 “리드 - 이름”을 **First Name**에, “리드 - 성”을 **Last Name**에 연결합니다.
4. \*\*권한으로 필터링(선택 사항)\*\*에서 마케팅 동의 체크박스를 선택하면 동의한 사람만 전송됩니다.
5. **저장**을 클릭한 다음 **테스트**를 클릭해 테스트 연락처를 보냅니다.

> 참고: HubSpot에는 여기서 선택할 목록이 없으므로 Scratcher는 **활성화**를 클릭하는 즉시 전송을 시작합니다. 캠페인에 이미 리드가 있다면 매핑과 필터를 빠르게 설정하거나, 캠페인이 라이브되기 전에 HubSpot을 활성화하세요.

## 필드 매핑

- **대상 필드** 목록에는 직접 만든 사용자 정의 속성을 포함한 HubSpot 연락처 속성이 표시됩니다. HubSpot 내부 속성은 표시되지 않습니다.
- 이메일 주소와 전화번호는 항상 HubSpot 속성 **Email**과 **Phone Number**로 전송됩니다. 이름과 성을 포함한 나머지는 모두 직접 매핑하세요.
- 체크박스 속성에는 예 또는 아니요가, 날짜 속성에는 날짜가 전송되므로 동의의 **동의함** 필드는 체크박스 속성에, 날짜는 날짜 속성에 매핑하세요.
- 연락처의 유입 경로를 표시하려면 “Scratcher 여름 게임” 같은 **사용자 정의 값 사용**을 리드 출처용 속성에 매핑하세요. 그러면 HubSpot에서 그 속성으로 목록이나 워크플로를 만들 수 있습니다.

## 동의

HubSpot은 Scratcher로부터 구독 또는 마케팅 상태를 받지 않습니다. **권한으로 필터링**을 사용해 동의한 사람만 보내거나, 동의의 **동의함**, **날짜**, **내용** 필드를 속성에 매핑해 HubSpot에 동의 증빙을 남기세요.

## 전송 내용 및 시점

신규 가입자는 1~2분 안에 전송됩니다. 기존 리드는 통합을 활성화할 때 전송됩니다. 누군가 다시 참여하면 연락처가 업데이트됩니다.

## 문제 해결

실패한 전송은 **설정** > **통합** > **전송 상태**에 HubSpot의 메시지와 함께 표시됩니다.

- **속성 값이 유효하지 않음**: 값이 HubSpot의 속성에 맞지 않습니다(예: 숫자나 드롭다운 속성에 텍스트). 매핑을 확인하거나 HubSpot에서 속성 유형을 변경하세요.
- **연결이 작동하지 않음**: 앱을 연결한 HubSpot 사용자가 삭제되었거나 HubSpot에서 앱이 제거되었습니다. **계정** 탭에서 계정을 삭제하고 HubSpot을 다시 연결한 뒤 캠페인에서 새 계정을 선택하세요.
- **연락처에 이름이 없음**: “리드 - 이름”을 **First Name**에 매핑하세요. 이메일과 전화번호만 자동으로 채워집니다.

통합

- [통합의 작동 방식](https://scratcher.io/ko/help/integrations/how-integrations-work)
- [모든 통합](https://scratcher.io/ko/help/integrations/other-integrations)
- [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status)
- [HubSpot 연결하기](https://scratcher.io/ko/help/integrations/hubspot)
- [Salesforce Marketing Cloud 연결하기](https://scratcher.io/ko/help/integrations/salesforce-marketing-cloud)
- [Zapier로 Microsoft Dynamics 365 연결하기](https://scratcher.io/ko/help/integrations/microsoft-dynamics-365)
- [Emarsys 연결하기](https://scratcher.io/ko/help/integrations/emarsys)
- [Klaviyo 연결하기](https://scratcher.io/ko/help/integrations/klaviyo)
- [Mailchimp 연결하기](https://scratcher.io/ko/help/integrations/mailchimp)
- [ActiveCampaign 연결하기](https://scratcher.io/ko/help/integrations/activecampaign)
- [Apsis One 연결하기](https://scratcher.io/ko/help/integrations/apsis-one)
- [Drip 연결하기](https://scratcher.io/ko/help/integrations/drip)
- [HeyLoyalty 연결하기](https://scratcher.io/ko/help/integrations/heyloyalty)
- [Peytz 연결하기](https://scratcher.io/ko/help/integrations/peytz)
- [Marketingplatform 연결하기](https://scratcher.io/ko/help/integrations/marketingplatform)
- [Zapier로 Campaign Monitor 연결하기](https://scratcher.io/ko/help/integrations/campaign-monitor)
- [Zapier로 ActiveTrail 연결하기](https://scratcher.io/ko/help/integrations/activetrail)
- [Bloomreach 연결하기](https://scratcher.io/ko/help/integrations/bloomreach)
- [Iterable 연결하기](https://scratcher.io/ko/help/integrations/iterable)
- [Mapp 연결하기](https://scratcher.io/ko/help/integrations/mapp)
- [Agillic 연결하기](https://scratcher.io/ko/help/integrations/agillic)
- [Ortto 연결하기](https://scratcher.io/ko/help/integrations/ortto)
- [Emarketeer 연결하기](https://scratcher.io/ko/help/integrations/emarketeer)
- [Shopify 연결하기](https://scratcher.io/ko/help/integrations/shopify)
- [Hello Retail 연결하기](https://scratcher.io/ko/help/integrations/hello-retail)
- [Zapier로 8,000개 이상의 앱 연결하기](https://scratcher.io/ko/help/integrations/zapier)
- [Zapier로 monday.com 연결하기](https://scratcher.io/ko/help/integrations/monday-com)
- [Zapier로 Asana 연결하기](https://scratcher.io/ko/help/integrations/asana)
- [Zapier로 Podio 연결하기](https://scratcher.io/ko/help/integrations/podio)
- [Zapier로 Intercom 연결하기](https://scratcher.io/ko/help/integrations/intercom)

더 알아보기

## 관련 글

- [통합의 작동 방식](https://scratcher.io/ko/help/integrations/how-integrations-work): 이메일 도구나 CRM을 한 번 연결하고, 캠페인마다 켜고, 목록을 선택하고, 필드를 매핑하고, 동의한 사람만 보내세요.
- [전송 상태 확인 및 리드 재전송](https://scratcher.io/ko/help/integrations/delivery-status): 어떤 리드가 도구로 전송되었는지 확인하고, 오류 메시지를 이해하고, 문제를 해결한 뒤 다시 보내세요.
- [동의 요청 및 이용 약관 추가하기](https://scratcher.io/ko/help/forms/consent-and-permissions): 뉴스레터 동의 체크박스를 추가하고, 약관을 연결하고, 구독 처리할 체크박스를 고르고, 동의한 사람만 이메일 도구로 보내세요.

도움이 필요하신가요?

## 아직 도움이 필요하신가요?

실제 담당자가 도와드립니다. 이미 Scratcher를 사용 중이라면 플랫폼 안의 채팅이 가장 빠릅니다.

- **[채팅 문의](https://platform.scratcher.io/ko/login)**

    로그인한 뒤 오른쪽 아래의 채팅 버튼을 클릭하세요. Rex가 바로 답하고, 팀과도 클릭 한 번으로 연결됩니다.
- **[미팅 예약](https://scratcher.io/ko/book-a-meeting)**

    팀과의 무료 30분 화상 통화: 둘러보기, 캠페인 아이디어, 설정 지원.
- **[이메일 문의](mailto:contact@scratcher.io)**

    contact@scratcher.io로 연락 주시면 답변드리겠습니다.
