---
title: "Agillic 연결하기"
description: "Agillic에서 API 키를 만들고, 개발자 키와 Secret으로 연결하고, 선택한 필드로 수신자를 생성하거나 업데이트하세요."
url: https://scratcher.io/ko/help/integrations/agillic
language: ko
---

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

# Agillic 연결하기

Agillic에서 API 키를 만들고, 개발자 키와 Secret으로 연결하고, 선택한 필드로 수신자를 생성하거나 업데이트하세요.

Agillic 통합을 사용하면 가입한 모든 사람이 Agillic에 수신자로 생성되거나 업데이트됩니다. 여기서는 Agillic 목록을 사용하지 않습니다. 수신자는 Agillic 데이터에 추가되며, 타깃 그룹은 Agillic에서 구성합니다.

## 준비 사항

- Agillic 유럽 플랫폼의 Agillic 계정과 API 키를 만들 수 있는 사용자(보통 관리자).

## 1단계: Agillic에서 API 키 만들기

1. Agillic에서 **Settings**를 열고 API 키(API credentials)를 찾습니다.
2. 새 키를 만들고 알아보기 쉬운 이름(예: “Scratcher”)을 지정합니다.
3. **Developer key**(API key라고도 함)와 **Secret**을 복사합니다. Secret은 한 번만 표시됩니다.

## 키에 필요한 권한

Scratcher는 이 키로 개인 데이터 필드를 읽고, 이메일로 수신자를 찾고, 수신자를 생성 및 업데이트합니다. Agillic에서 키의 권한을 제한할 수 있다면 수신자에 대한 읽기·쓰기 권한과 개인 데이터에 대한 읽기 권한이 필요합니다. 그 외의 권한은 필요하지 않습니다.

## 2단계: Agillic을 Scratcher에 연결하기

1. Scratcher에서 **설정** > **통합**으로 이동해 **Agillic**을 클릭합니다.
2. **개발자 키**와 **Secret**을 붙여 넣습니다.
3. **통합 설치**를 클릭합니다. Scratcher가 Agillic에 로그인해 정보를 확인합니다.

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

1. 편집기에서 **연결** > **통합** > **Agillic**으로 이동해 **활성화**를 클릭합니다.
2. 계정을 두 개 이상 연결했다면 **계정 선택**에서 계정을 고릅니다.
3. **필드 매핑**에서 각 **Scratcher 필드**를 Agillic 개인 데이터 필드와 연결합니다.
4. **고유 이메일 필드**에서 이메일에 사용하는 Agillic 필드를 선택합니다. “Agillic에서 이메일에 사용하는 필드를 선택하세요(Agillic에서도 고유한 필드여야 합니다)”. 고유한 텍스트 필드만 목록에 표시됩니다. 비워 두면 Scratcher는 **EMAIL** 필드를 사용합니다.
5. \*\*권한으로 필터링(선택 사항)\*\*에서 마케팅 동의 체크박스를 선택하면 동의한 사람만 전송됩니다.
6. **저장**을 클릭한 다음 **테스트**를 클릭합니다.

> 참고: Agillic에는 선택할 목록이 없으므로 Scratcher는 **활성화**를 클릭하는 즉시 전송을 시작합니다. 캠페인이 라이브되기 전에 활성화하거나, 바로 설정을 마치세요.

## 필드 매핑

- 이메일 주소는 항상 고유 이메일 필드로 전송됩니다. 따로 매핑할 필요가 없습니다.
- 필드 목록에는 Agillic 개인 데이터가 유형과 함께 표시됩니다. 날짜는 Agillic 형식(예: 31.12.2025)으로 전송됩니다.
- 수신 동의용 개인 데이터 필드가 있다면 동의의 **동의함** 필드를 거기에 매핑하세요.

## 전송 내용 및 시점

Scratcher는 이메일로 수신자를 조회합니다. 수신자가 없으면 새로 생성하고, 있으면 업데이트합니다. 신규 가입자는 1~2분 안에 전송되며, 기존 리드는 통합을 활성화할 때 전송됩니다. **설정** > **통합** > **전송 상태**에서 각 리드가 Agillic에 새로 생성되었는지 기존에 있었는지 확인할 수 있습니다.

## 문제 해결

- “Agillic API request failed with status code ...”: Agillic이 요청을 수락하지 않았습니다. 401 또는 403은 키가 삭제되었거나 권한이 없다는 뜻입니다. 새 키를 연결하세요.
- 필드에 관한 Agillic 메시지: 값이 필드 유형에 맞지 않거나 필수 필드가 빠져 있습니다. 매핑을 확인하세요.

통합

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