---
title: "HeyLoyalty 연결하기"
description: "HeyLoyalty에서 API 키와 시크릿을 찾아 연결하고, 새 가입자를 HeyLoyalty 목록에 추가하세요."
url: https://scratcher.io/ko/help/integrations/heyloyalty
language: ko
---

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

# HeyLoyalty 연결하기

HeyLoyalty에서 API 키와 시크릿을 찾아 연결하고, 새 가입자를 HeyLoyalty 목록에 추가하세요.

HeyLoyalty 통합을 사용하면 가입한 모든 사람이 선택한 HeyLoyalty 목록의 회원으로 추가됩니다. 이메일 주소가 이미 목록에 있으면 회원 정보가 업데이트됩니다.

## 준비 사항

- 목록이 하나 이상 있는 HeyLoyalty 계정과 계정의 API 정보를 볼 수 있는 사용자.

## 1단계: HeyLoyalty에서 API 키와 시크릿 찾기

1. HeyLoyalty에 로그인합니다.
2. 계정 설정을 열고 통합 또는 API 섹션을 찾습니다.
3. **API key**와 **API secret**을 복사합니다.

이 키는 계정 전체에 대한 액세스 권한을 주므로 따로 선택할 권한이 없습니다. Scratcher는 목록과 목록의 필드를 읽고, 회원을 생성하고 업데이트합니다.

## 2단계: HeyLoyalty를 Scratcher에 연결하기

1. Scratcher에서 **설정** > **통합**으로 이동해 **HeyLoyalty**를 클릭합니다.
2. **API 키**와 **API 시크릿**을 붙여 넣습니다.
3. **통합 설치**를 클릭합니다. Scratcher가 목록을 읽을 수 있는지 확인합니다.

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

1. 편집기에서 **연결** > **통합** > **HeyLoyalty**로 이동해 **활성화**를 클릭합니다.
2. 계정을 둘 이상 연결했다면 **계정 선택**에서 계정을 고릅니다.
3. **외부 목록**에서 HeyLoyalty 목록을 선택합니다.
4. **필드 매핑**에서 각 **Scratcher 필드**를 목록의 필드와 연결합니다. 직접 만든 필드를 포함해 목록의 필드가 이름으로 표시됩니다.
5. \*\*권한으로 필터링(선택 사항)\*\*에서 마케팅 동의 체크박스를 선택합니다.
6. **저장**을 클릭한 다음 **테스트**를 클릭합니다.

## 필드 매핑

- 이메일 주소는 항상 전송됩니다. 이름, 성, 휴대폰 번호를 포함한 나머지는 모두 매핑하세요.
- HeyLoyalty 목록에서 필수인 필드는 반드시 매핑하세요. 그렇지 않으면 HeyLoyalty가 회원을 거부합니다.
- 휴대폰 필드는 **형식** 설정으로 목록이 요구하는 형태로 번호를 보내세요.

## 전송 대상과 시점

새 가입자는 1~2분 안에 전송되며, 기존 리드는 통합을 활성화할 때 전송됩니다. **전송 상태**에서 각 회원이 새로 추가되었는지 이미 목록에 있었는지 확인할 수 있습니다.

## 문제 해결

- 필드 오류로 전송이 실패하는 경우: 필수 목록 필드가 매핑되지 않았거나 날짜, 전화번호 등의 값이 필드에 맞지 않습니다. 매핑을 확인하세요.
- 잘 되다가 모두 실패하는 경우: HeyLoyalty에서 API 키나 시크릿이 변경되었습니다. **새 계정 추가**로 다시 연결하세요.

통합

- [통합의 작동 방식](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로 연락 주시면 답변드리겠습니다.
