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

# 연락처 업로드

> CSV 형식, 유효성 검사 규칙 및 업로드 시 태그 지정 안내

## 이 페이지의 도움말

캠페인을 실행하기 위해 연락처가 포함된 CSV 파일을 업로드하는 방법을 설명합니다. 필수 컬럼, 유효성 검사 규칙, 용량 제한 및 업로드 시 태그를 추가하는 방법을 알아봅니다.

## 시작하기 전에

* Nudgen 계정
* 최소한 `email` 컬럼이 포함된 CSV 파일
* 연락처 수가 요금제 한도 내에 있어야 합니다 ([결제 안내](/ko/billing/overview) 참조)

## 1단계: CSV 파일 준비하기

CSV 파일에는 다음 정보가 포함되어야 합니다:

| 컬럼      | 필수 여부  | 설명                         |
| :------ | :----- | :------------------------- |
| `email` | **필수** | 유효한 이메일 주소입니다. 중복될 수 없습니다. |
| `name`  | 선택     | 개인화된 메시지를 위한 표시 이름입니다.     |

`company`나 `segment`와 같은 다른 컬럼을 추가할 수도 있습니다. 이 정보는 암호화되어 저장되며, 나중에 태그 지정이나 세그먼트화 로직에 사용할 수 있습니다.

## 2단계: 형식 확인하기

* **인코딩:** UTF-8 권장.
* **구분자:** 쉼표(`,`).
* **헤더 행:** 첫 번째 행에는 반드시 컬럼명이 포함되어야 합니다. `email`과 `name`은 대소문자를 구분하지 않고 인식됩니다.
* **중복 이메일:** 파일 내의 중복 이메일은 통합됩니다. 기존에 등록된 이메일이 있는 경우 해당 정보가 업데이트됩니다.

<Warning>
  잘못된 이메일 형식(예: `@` 누락 등)은 생략됩니다. 업로드 요약 정보를 통해 몇 개의 행을 가져오고 몇 개를 건너뛰었는지 확인하세요.
</Warning>

## 3단계: Nudgen에 업로드하기

1. 사이드바에서 \*\*연락처(Contacts)\*\*를 선택합니다.
2. \*\*CSV 업로드(Upload CSV)\*\*를 클릭합니다.
3. 파일을 선택합니다.
4. 업로드하는 모든 연락처에 적용할 태그(예: `inactive`, `re-engage`)를 선택합니다.
5. 미리보기를 확인하고 승인합니다.

## 용량 및 수량 제한

* **파일 용량:** 화면에 표시된 제한(일반적으로 수 MB)을 따르세요. 대규모 목록은 처리하는 데 시간이 더 걸릴 수 있습니다.
* **워크스페이스당 연락처 수:** 요금제에 따라 다릅니다. 업로드 시 한도를 초과하면 업로드가 거부됩니다. 현재 한도는 [결제 안내](/ko/billing/overview) 및 실시간 [가격 페이지](https://nudgen.net/pricing)를 확인하세요.

## 다음 단계

* 연락처 목록에 마스킹된 이메일(`j***@g***.com`)이 표시됩니다.
* 태그를 사용하여 [캠페인 생성](/ko/campaigns/create) 시 오디언스를 세그먼트화하세요.
* 계정 소유자는 개별 연락처의 실제 정보를 [확인(Reveal)](/ko/contacts/overview)할 수 있습니다.

## 문제 해결

<AccordionGroup>
  <Accordion title="일부 행이 생략되었습니다">
    `email` 컬럼에 유효한 이메일 주소가 있는지 확인하세요. 빈 행이나 형식이 잘못된 주소는 건너뜁니다.
  </Accordion>

  <Accordion title="업로드 실패: 요금제 한도 초과">
    해당 업로드로 인해 요금제 한도를 초과하게 됩니다. 요금제를 업그레이드하거나 기존 연락처를 먼저 삭제하세요.
  </Accordion>

  <Accordion title="컬럼을 인식하지 못합니다">
    헤더 행에 `email`(또는 `Email`)이 명시되어 있는지 확인하세요. 다른 컬럼은 선택 사항입니다.
  </Accordion>
</AccordionGroup>

## 관련 문서

<CardGroup cols={2}>
  <Card title="연락처 개요" icon="users" href="/ko/contacts/overview">
    암호화, 마스킹 및 세그먼트화 안내.
  </Card>

  <Card title="캠페인 생성" icon="paper-plane" href="/ko/campaigns/create">
    오디언스를 선택하고 캠페인을 시작해 보세요.
  </Card>
</CardGroup>