# Регистрация контактов Viber

Чтобы клиент мог получать сообщения Viber, у него должен быть действительный номер телефона, и он должен быть зарегистрирован в качестве подписчика платформы Viber в Pushwoosh. В этом руководстве объясняется, как регистрировать контакты путем импорта CSV-файла.

<Aside type="note" title="Автоматическая регистрация">
Когда контакт впервые отправляет сообщение в ваш бизнес-аккаунт Viber, Pushwoosh автоматически регистрирует его номер телефона в качестве подписчика Viber.
</Aside>

## Как импортировать контакты Viber из CSV-файла

Чтобы импортировать контакты Viber, загрузите CSV-файл, содержащий список контактов. Импортированные номера будут зарегистрированы как подписчики Viber, что позволит использовать персонализированные сообщения и сегментацию аудитории.

### Подготовьте ваш CSV-файл

#### Правила форматирования CSV

##### Общая структура
- Первая строка должна содержать заголовки столбцов, описывающие данные в каждом столбце.
- Каждая последующая строка представляет один контакт со значениями, соответствующими заголовкам.
- Значения должны быть разделены запятыми.
- Сохраните файл в кодировке UTF-8, чтобы обеспечить правильное отображение символов.
- Максимально допустимый размер файла — 100 МБ.

##### Обязательные столбцы
- **Номер телефона:** Должен быть в формате [**E.164**](https://en.wikipedia.org/wiki/e.164), включая знак `+` и код страны.
- **User ID:** Уникальный идентификатор пользователя (например, имя или адрес электронной почты).

<Aside type="note">
Названия столбцов в вашем CSV-файле не обязательно должны точно совпадать с этими. В процессе импорта вы можете сопоставить существующие названия столбцов с нужными полями в системе. Например, если в вашем CSV-файле есть столбец с названием *Mobile* вместо *Phone Number*, вы можете вручную назначить его полю **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="Меню импорта CSV в разделе Audience, показывающее опцию Import Viber Contacts для загрузки номеров телефонов подписчиков Viber"/>

2. Выберите CSV-файл на своем компьютере.

3. Сопоставьте столбцы:

   * **Столбец с контактами Viber в CSV:** Выберите столбец, содержащий номера телефонов в формате E.164 (например, `+1XXXXXXXXXX`). Pushwoosh регистрирует их внутри системы как подписчиков `viber:+`.
   * **Столбец с User ID в CSV:** Выберите столбец с уникальными идентификаторами пользователей (например, адрес электронной почты или имя).

<img src="/viber-register-viber-contacts-2.webp" alt="Шаг сопоставления при импорте контактов Viber с выпадающими списками для столбца контактов Viber и столбца User ID для сопоставления CSV"/>

4. Добавьте дополнительные данные (необязательно)

   Если вы хотите включить дополнительные данные для сегментации:

   * Выберите **Название столбца** из вашего CSV.
   * Присвойте ему **Тег**, чтобы связать его с данными пользователя в системе.
   * Нажмите **+ Добавить столбец**, чтобы включить больше атрибутов.

<img src="/viber-register-viber-contacts-3.webp" alt="Необязательное сопоставление тегов при импорте CSV для Viber с выпадающими списками Название столбца и Тег и ссылкой Добавить столбец"/>

5. Нажмите **Начать импорт**, чтобы начать обработку файла.

После завершения импорта CSV контакты появятся как новый сегмент в [списке сегментов](/ru/product/audience-data-and-segmentation/segmentation/), а также будут доступны в [User explorer](/ru/product/audience-data-and-segmentation/user-explorer/).

Затем вы можете использовать эти данные для создания сегментированных и персонализированных кампаний Viber через Customer Journey.

<LinkCard title="Узнайте больше об отправке сообщений Viber" href="/product/messaging-channels/viber/send-viber-messages/" />