# Viber 연락처 등록

고객이 Viber 메시지를 받으려면 유효한 전화번호가 있어야 하며 Pushwoosh에 Viber 플랫폼 구독자로 등록되어 있어야 합니다. 이 가이드에서는 CSV 파일을 가져와 연락처를 등록하는 방법을 설명합니다.

<Aside type="note" title="자동 등록">
연락처가 Viber Business 계정에 처음으로 메시지를 보내면 Pushwoosh는 해당 전화번호를 자동으로 Viber 구독자로 등록합니다.
</Aside>

## CSV 파일에서 Viber 연락처를 가져오는 방법

Viber 연락처를 가져오려면 연락처 목록이 포함된 CSV 파일을 업로드하세요. 가져온 번호는 Viber 구독자로 등록되어 개인화된 메시징 및 잠재고객 세분화가 가능해집니다.

### CSV 파일 준비

#### CSV 서식 규칙

##### 일반 구조
- 첫 번째 행에는 각 열의 데이터를 설명하는 열 헤더가 포함되어야 합니다.
- 이후 각 행은 단일 연락처를 나타내며, 값은 헤더에 해당합니다.
- 값은 쉼표로 구분해야 합니다.
- 문자 표시가 제대로 되도록 파일을 UTF-8 인코딩으로 저장하세요.
- 허용되는 최대 파일 크기는 100MB입니다.

##### 필수 열
- **전화번호:** `+` 기호와 국가 코드를 포함한 [**E.164**](https://en.wikipedia.org/wiki/e.164) 형식이어야 합니다.
- **사용자 ID:** 사용자의 고유 식별자(예: 이름 또는 이메일)입니다.

<Aside type="note">
CSV 파일의 열 이름이 이들과 정확히 일치할 필요는 없습니다. 가져오기 과정에서 기존 열 이름을 시스템의 올바른 필드에 매핑할 수 있습니다. 예를 들어, CSV 파일에 *Phone Number* 대신 *Mobile*이라는 열이 있는 경우, 가져올 때 수동으로 **Phone Number** 필드에 할당할 수 있습니다.
</Aside>

##### 선택적 열
선택적 열을 추가하면 Viber 캠페인에서 더 고급 세분화 및 개인화가 가능합니다.

- **이름:** 사용자의 이름 또는 전체 이름입니다.
- **위치:** 사용자의 도시, 주 또는 국가를 지정합니다. 위치 기반 프로모션을 보내는 데 유용합니다(예: *오늘 로스앤젤레스 매장에서 20% 할인 받으세요!*).
- **생일:** 특별 할인이 포함된 생일 메시지를 보낼 수 있습니다(예: *생일 축하해요, 사라! 당신만을 위한 10% 할인 쿠폰입니다!*). 자동화된 생일 캠페인을 트리거할 수 있습니다.
- **언어:** 사용자의 언어 기본 설정(예: 영어, 스페인어, 프랑스어)을 저장합니다. 더 나은 참여를 위해 수신자의 언어로 메시지를 보내는 데 도움이 됩니다.
- **고객 유형:** 사용자가 **신규 고객, VIP 또는 비활성** 고객인지 식별합니다. 타겟 메시징을 가능하게 합니다(예: *당신만을 위한 독점 VIP 혜택!*).
- **사용자 지정 태그:** 캠페인과 관련된 추가 데이터(예: 사용자 기본 설정, 구매 내역). 이는 시스템 태그에 매핑되어 Pushwoosh에서 세분화에 사용될 수 있습니다.

##### CSV 파일 예시

다음 예시는 올바르게 서식이 지정된 CSV 파일을 보여줍니다:

```csv
Phone Number,User ID,Name,Location
+1XXXXXXXXXX,john.doe@email.com,John Doe,New York
+1XXXXXXXXXX,jane.smith@email.com,Jane Smith,Los Angeles
```

### CSV 파일 업로드

1. **Audience > Import CSV > Import Viber Contacts**로 이동합니다.

<img src="/viber-register-viber-contacts-1.webp" alt="Audience 섹션의 CSV 가져오기 메뉴, Viber 구독자 전화번호 업로드를 위한 Viber 연락처 가져오기 옵션 표시"/>

2. 컴퓨터에서 CSV 파일을 선택합니다.

3. 열 매핑:

   * **CSV의 Viber 연락처 열:** E.164 형식의 전화번호가 포함된 열을 선택합니다(예: `+1XXXXXXXXXX`). Pushwoosh는 내부적으로 이를 `viber:+` 구독자로 등록합니다.
   * **CSV의 사용자 ID 열:** 고유한 사용자 식별자가 있는 열을 선택합니다(예: 이메일 또는 이름).

<img src="/viber-register-viber-contacts-2.webp" alt="Viber 연락처 가져오기 매핑 단계, CSV 매핑을 위한 Viber 연락처 열 및 사용자 ID 열 드롭다운 표시"/>

4. 추가 데이터 추가 (선택 사항)

   세분화를 위해 추가 세부 정보를 포함하려면:

   * CSV에서 **열 이름**을 선택합니다.
   * 시스템의 사용자 데이터와 연결하기 위해 **태그**를 할당합니다.
   * **+ 열 추가**를 클릭하여 더 많은 속성을 포함합니다.

<img src="/viber-register-viber-contacts-3.webp" alt="Viber CSV 가져오기 선택적 태그 매핑, 열 이름 및 태그 드롭다운과 열 추가 링크 표시"/>

5. **가져오기 시작**을 클릭하여 파일 처리를 시작합니다.

CSV 가져오기가 완료되면 연락처는 [세그먼트 목록](/ko/product/audience-data-and-segmentation/segmentation/)에 새 세그먼트로 표시되며 [사용자 탐색기](/ko/product/audience-data-and-segmentation/user-explorer/)에서도 사용할 수 있습니다.

그런 다음 이 데이터를 사용하여 Customer Journey를 통해 세분화되고 개인화된 Viber 캠페인을 만들 수 있습니다.

<LinkCard title="Viber 메시지 전송에 대해 자세히 알아보기" href="/product/messaging-channels/viber/send-viber-messages/" />