HubSpot

HubSpot을 연결하면 모든 견적 요청이 후속 연락을 할 수 있는 연락처로도 저장되므로, 정보를 직접 복사할 필요가 없습니다.

주의

HubSpot에는 값이 하나가 아니라 두 개 필요합니다. Portal ID와 HubSpot access token입니다. 또한 토큰을 발급하는 비공개 앱에서 세 가지 스코프를 선택해야 합니다. 둘 중 하나라도 빠지면 연결은 설정된 것처럼 보이지만 아무것도 전송되지 않습니다. 1단계에서 두 가지를 모두 다룹니다.

참고

HubSpot은 PRO 요금제에 포함된 기능입니다. FREE에 포함된 연동은 Klaviyo, Mailchimp, Shopify입니다. 요금제 비교를 참고하세요.

요금제에 포함되어 있지 않으면 Third-party integration 목록에 설정 아이콘 대신 비활성화된 Upgrade 버튼과 자물쇠가 표시됩니다. 자물쇠를 선택하면 해당 기능에 필요한 요금제를 설명하고 앱의 Pricing plans로 연결됩니다. 이는 오류가 아니라 요금제 때문입니다.

1단계 — HubSpot에서 Portal ID와 access token 가져오기

HubSpot은 더 이상 기존 방식의 API key를 발급하지 않습니다. 대신 HubSpot 계정 안에서 비공개 앱을 만들면 access token이 발급됩니다. Portal ID는 별개이며 HubSpot 계정 자체를 식별합니다.

1. Portal ID 찾기

   Portal ID(계정 ID 또는 허브 ID라고도 함)는 앱이 기록할 HubSpot 계정을 식별합니다. HubSpot 공식 가이드: Check your current account.

   같은 링크가 앱의 필드 아래에 Find your Portal ID 도움말 텍스트로도 표시됩니다.

2. 올바른 스코프로 비공개 앱 만들기

   HubSpot 계정 안에서 비공개 앱을 만드세요. HubSpot 공식 가이드에서 방법을 확인할 수 있습니다. Private apps.

   생성을 마치기 전에 최소한 다음 세 가지 스코프를 선택하세요.

   • forms
   • crm.objects.contacts.write
   • crm.schemas.contacts.write

   앱의 토큰 필드 아래에도 같은 세 가지가 표시되므로, 나중에 비공개 앱과 대조해 확인할 수 있습니다.

   

   스크린샷이 필요합니다. forms, crm.objects.contacts.write, crm.schemas.contacts.write가 선택된 HubSpot 비공개 앱 스코프 화면입니다.

3. access token 복사하기

   비공개 앱이 만들어지면 HubSpot에 토큰이 표시됩니다. 복사해서 설정을 마칠 때까지 안전한 곳에 보관하세요.

위험

스코프 누락은 조용히 실패하는 원인입니다. forms, crm.objects.contacts.write, crm.schemas.contacts.write 없이 만든 토큰도 완전히 유효한 토큰입니다. Enable은 켜진 채로 유지되고, 앱은 아무 문제 없이 저장되지만, HubSpot은 전송되는 모든 연락처를 거부합니다. 연락처가 도착하지 않는다면 다른 것보다 먼저 스코프를 확인하세요.

주의

앱은 견적 요청을 연락처 목록이 아니라 HubSpot 양식에 연결합니다. 시작하기 전에 HubSpot에서 해당 양식을 만들어 두세요. 드롭다운은 이미 존재하는 양식만 보여 줄 수 있습니다.

2단계 — 앱에서 연결하기

1. Integrations 탭 열기

   Shopify 관리자에서 SA Request a Quote를 열고 Advanced settings를 선택한 다음 Integrations 탭을 엽니다.

2. HubSpot 선택하기

   Third-party integration에서 HubSpot을 선택합니다. 앱에는 “Seamlessly connect your submissions to your data”라고 설명되어 있습니다.

   HubSpot 페이지가 열리고, 목록으로 돌아갈 수 있는 Third-party 이동 경로가 표시됩니다.

   

   서비스를 고른 다음 설정을 엽니다.

3. Enable 켜기

   페이지의 첫 번째 컨트롤인 Enable을 켭니다. 켜기 전에는 HubSpot으로 아무것도 전송되지 않습니다.

4. 두 자격 증명 모두 붙여넣기

   두 필드는 Enable 바로 아래에 다음 순서로 있습니다.

   1. Portal ID — 1단계에서 가져온 계정 ID를 붙여넣습니다. 도움말 텍스트는 Find your Portal ID입니다.
   2. HubSpot access token — 1단계에서 가져온 비공개 앱 토큰을 붙여넣습니다. 도움말 텍스트는 Find or generate your access token이며, 그 아래에 앱이 토큰에 필요한 스코프인 forms, crm.objects.contacts.write, crm.schemas.contacts.write를 표시합니다.

   이 필드의 이름은 “API key”가 아니라 HubSpot access token입니다. 비공개 앱이 발급하는 것이 토큰이기 때문입니다.

   두 필드를 모두 입력하세요. 앱은 두 값이 모두 있어야 HubSpot 양식을 불러오므로, 토큰만 있는 페이지는 선택할 항목이 없는 상태로 멈춥니다. 입력한 뒤에도 드롭다운이 나타나지 않으면 토큰 필드 옆의 Merge fields를 선택해 앱이 다시 불러오도록 하세요.

   

   HubSpot에는 두 값이 필요하며, 서로 대체할 수 없습니다.

5. HubSpot 양식 선택하기

   Select a HubSpot form to integrate를 열고 견적 요청을 보낼 양식을 선택합니다. 선택하기 전에는 “Please select a HubSpot form”이라고 표시됩니다.

   앱에 “It looks like you don’t have any HubSpot forms”라고 표시된다면, 양식이 아직 없거나, 두 자격 증명 중 하나가 잘못되었거나, 토큰에 forms 스코프가 없는 것입니다. 다음 단계로 가기 전에 해결하세요. 양식을 선택하기 전에는 필드 매핑이 표시되지 않습니다.

6. 양식 필드 매칭하기

   매핑 행은 Portal ID, HubSpot access token, 양식이 모두 설정된 뒤에만 나타납니다. 행은 방금 선택한 HubSpot 양식에서 가져오므로 고정된 목록이 아니라 해당 양식의 필드입니다. 양식을 먼저 선택하면 행이 따라옵니다.

   각 행을 왼쪽에서 오른쪽으로 읽으세요.

   • 왼쪽 — HubSpot 필드입니다. 이름을 바꿀 수 없어 회색으로 표시됩니다.
   • 가운데 — 값을 제공하는 방식입니다. has no value, is dynamic value by(견적 양식에서 가져옴), is fixed value by(모든 견적에 같은 텍스트를 전송)가 있습니다.
   • 오른쪽 — 전송할 견적 양식 필드 또는 직접 입력한 고정 텍스트입니다.

   즉, 왼쪽에 표시된 HubSpot 필드를 채울 견적 양식 값을 오른쪽에서 선택하는 것이며, 그 반대가 아닙니다.

   이메일 행은 건너뛸 수 없습니다. 이 값이 없으면 만들 연락처가 없습니다. 양식에서 Company information을 수집한다면 회사 이름도 매칭해서 영업팀이 누가 문의했는지 알 수 있게 하세요. HubSpot 양식에서 필수로 지정된 필드를 매칭하지 않고 두면 앱이 해당 행을 표시하고 저장을 거부합니다.

   

7. 저장하기

   Save를 선택합니다. 저장하기 전에는 아무것도 저장되지 않으며, 저장하지 않은 페이지는 아무것도 전송하지 않습니다.

   저장하지 않은 변경 사항이 있으면 앱에 Save와 Discard changes가 있는 저장 바가 표시됩니다. Discard changes는 페이지에 입력한 모든 내용을 버립니다. 저장되면 Changes saved 메시지가 표시됩니다.

참고

Mailchimp에서는 같은 필드 매핑 표를 자세히 보여 줍니다. 매핑에 대해서만 참고하세요. Mailchimp는 API key 하나만 필요하고 목록을 선택하지만, HubSpot은 Portal ID도 필요하고 양식을 선택합니다.

3단계 — 테스트하기

스토어프런트에서 실제 견적 요청을 제출한 다음 HubSpot에서 새 연락처를 확인하세요. 이메일 주소만이 아니라 매칭한 필드가 실제로 도착했는지 확인하세요.

주의

테스트를 건너뛰지 마세요. 필드가 잘못 매칭되면 연결이 활성 상태로 보여도 쓸 만한 데이터가 전달되지 않을 수 있으며, 데이터를 사용하려고 할 때까지 알아차리지 못합니다.

나에게 맞는 도구일까요?

견적을 마케팅팀이 아닌 영업팀이 처리한다면 적합한 선택입니다.

아직 HubSpot을 사용하지 않는다면 이 용도만을 위해 도입하지 마세요. Zapier는 견적 데이터를 거의 모든 곳에 연결해 주고, 제출 후 Shopify 고객 만들기는 FREE 요금제에서 모든 것을 Shopify 안에서 처리할 수 있게 해 줍니다.

연락처가 도착하지 않는다면

• 비공개 앱의 스코프를 확인하세요. forms, crm.objects.contacts.write, crm.schemas.contacts.write가 모두 부여되어야 합니다. 스코프가 없는 토큰은 문제없이 저장되지만 아무것도 전달하지 않습니다. 가장 흔한 원인입니다.
• Enable이 아직 켜져 있는지 확인하세요. 꺼져 있는 동안에는 아무것도 전송되지 않습니다.
• 토큰뿐 아니라 Portal ID도 확인하세요. 토큰은 맞지만 Portal ID가 없거나 잘못 입력되면 연결이 반쯤만 만들어집니다. 앱이 양식을 불러올 수 없어 아무것도 전송되지 않습니다.
• 토큰이 아직 유효한지 확인하세요. HubSpot에서 토큰을 교체하면 새 토큰을 붙여넣을 때까지 연결이 끊어집니다. 저장된 토큰은 가려진 상태로 표시되므로, 의심스러우면 새 토큰을 붙여넣으세요.
• 올바른 양식을 선택했는지 확인하세요. 연락처가 보고 있지 않은 곳에 도착하고 있을 수 있습니다.
• 이메일 행이 매칭되어 있는지 확인하세요. 이 값이 없으면 만들 연락처가 없습니다.

여전히 해결되지 않나요? [email protected]로 이메일을 보내 주세요.

다음 단계

• 연동 개요 — 연결할 수 있는 다른 도구입니다
• B2B 양식 만들기 — CRM으로 보낼 만한 회사 정보를 수집하세요
• 요금제 비교 — PRO 요금제에 포함된 기능입니다