---
title: "HubSpot"
description: "Quire HubSpot 앱으로 Quire와 HubSpot을 함께 유지하기."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/ko/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

<span id="hubspot"></span>

Quire HubSpot 앱은 학습 데이터와 CRM 데이터를 함께 유지합니다. HubSpot 연락처는
Quire 사용자가 되고, 회사는 부서가 되며, 사람들이 Quire에서 한 일은 그들의
HubSpot 기록에 표시됩니다.

## 연결 <!--quire:connecting-->

앱은 Quire 조직마다 한 번, HubSpot 자체 동의 화면을 통해 설치합니다. 설치자는
양쪽 모두의 관리자여야 합니다. 하나의 HubSpot 계정은 하나의 Quire 조직에만
연결됩니다. 같은 HubSpot 계정에 연결하려는 두 번째 조직은 거부됩니다. 계정을
공유하면 한 조직의 학습자가 다른 조직의 CRM으로 흘러들어가기 때문입니다.

설치 시 앱은 HubSpot 플랜에 커스텀 행동 이벤트가 포함되어 있는지 확인하고,
학습을 어떻게 보고할지 정합니다.

| HubSpot 플랜 | HubSpot에 표시되는 것 |
| --- | --- |
| 커스텀 행동 이벤트 포함(Marketing Hub Enterprise) | 연락처 타임라인의 이벤트: 등록, 시작, 완료, 수료증 발급, 퀴즈 응시 |
| 없음 | 각 연락처의 **Quire learning** 속성 그룹: 최근 코스, 최근 완료일, 완료한 코스, 최신 수료증 |

연동 설정 페이지에는 어떤 모드가 켜져 있는지 표시됩니다. 나중에 HubSpot을
업그레이드하면 다시 연결하면 모드가 전환됩니다.

## 무엇이 함께 유지되는가 <!--quire:what-is-kept-in-step-->

- **연락처와 사용자**, **회사와 부서**, 그리고 **Quire 코스와 HubSpot의
  Courses 오브젝트**가 각각 일대일로 연결됩니다.
- 직접 매핑하는 **필드**: 출처, 목적지, 그리고 방향(HubSpot으로, Quire로,
  또는 양쪽으로).
- **충돌**은 필드별로 해결됩니다. Quire 우선, HubSpot 우선, 최신 우선,
  또는 사람이 결정하도록 보류. 기본적으로 학습 데이터는 Quire가, 마케팅
  데이터는 HubSpot이 이깁니다.

첫 연결은 기존 기록을 백그라운드에서 채우며, 실시간 변경을 막지 않고 진행
상황을 보고합니다.

## 연락처로 사람 만들기 <!--quire:creating-people-from-contacts-->

Quire 사람이 없는 HubSpot 연락처는 사람이 될 수 있습니다. 연동 설정 페이지에서
**HubSpot 연락처로 사람 만들기**를 켠 뒤 다음을 고르세요.

- 어떤 **라이프사이클 단계**가 대상인지. 그래야 잠재 고객이 사용자가 되지
  않습니다.
- 새 사람이 넣어질 **코호트**와 **코스**.
- 새 사람이 **HubSpot 회사 이름의 그룹**에 들어갈지 여부.
- 변경된 연락처를 **자동으로** 5분마다 계속 가져올지 여부.

각 연락처는 CSV 업로드와 같은 사용자 가져오기 절차를 거칩니다. 플랜의 사용자
상한, 라이선스 좌석, 프로필 필드 규칙이 적용되며, 가져오기가 거부한 연락처
(잘못된 주소, 라이선스 초과)는 나머지를 멈추지 않고 자기 줄에 보고됩니다.
연결이나 이메일 주소로 이미 사람이 있는 연락처는 필드 맵에 의해 연결·갱신될
뿐, 절대 두 번 만들어지지 않으며 가져오기가 CRM의 사람을 덮어쓰지 않습니다.

Quire 쪽(또는 양쪽)으로 가는 필드 맩 행은 HubSpot 속성에서 새 사람의 이름,
시간대, 언어, 프로필 필드를 채웁니다.

**미리 보기**는 연락처 한 페이지를 읽어 만들거나, 연결하거나, 그대로 두거나,
거부될 것을 아무것도 쓰지 않고 나열합니다. **변경된 연락처 지금 가져오기**는
마지막 가져오기 이후 바뀐 것을 읽습니다. 첫 가져오기는 모든 연락처를 읽고,
설정 양식의 **모든 연락처 다시 읽기**로 처음부터 다시 시작합니다. 백로그가
크면 여러 번 실행해야 하며, 각 실행은 멈춘 지점에서 이어집니다. 다음 실행은
마지막 실행의 최신 연락처를 다시 읽는데, 이는 무해합니다.

연락처는 HubSpot의 연락처 생성·변경 알림, 등록 단계에 이른 거래, 그리고 아직
사람이 없는 연락처를 지칭하는 워크플로 액션으로도 들어옵니다. 만들어졌든
아니든 모든 줄은 동기화 로그에 있으며, 설정 변경과 수동 가져오기는 감사
로그에 기록됩니다.

## 워크플로 <!--quire:workflows-->

HubSpot 워크플로 액션 네 가지가 Quire에서 행동합니다. **등록**, **등록 취소**,
**수료증 발급**, **이메일 보내기**. HubSpot 워크플로가 두 번 실행되어도 두 번
등록되지는 않습니다.

거래가 특정 단계에 이르거나 코스에 매핑되는 상품이 거래에 추가될 때 자동으로
등록할 수도 있습니다. 코스의 등록 방식 아래 **HubSpot** 등록 방식으로 코스
별로 설정합니다.

## 연락처 기록 위에서 <!--quire:on-the-contact-record-->

각 HubSpot 연락처의 Quire 카드에 등록, 진도, 수료증이 표시됩니다.

## 동기화 로그 <!--quire:the-sync-log-->

모든 작업은 30일 동안 기록됩니다. 방향, 기록, 결과, 오류가 포함됩니다. 실패한
작업은 로그에서 다시 시도할 수 있습니다. HubSpot의 속도 제한은 자동으로
존중됩니다. HubSpot이 속도를 줄이면 앱은 실패 대신 그 계정을 일시 중지합니다.

Source: https://docs.quirelms.com/ko/integrations/hubspot/index.mdx
