# Импорт SMS-контактов

Вы можете загрузить CSV-файл для массового импорта телефонных номеров. Импортированные номера будут зарегистрированы как подписчики на SMS, что позволит вам персонализировать и сегментировать ваши SMS-рассылки.

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

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

#### Общая структура

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

#### Обязательные столбцы

*   **Номер телефона**: должен быть в международном формате, начинаться с `+` и кода страны, например, *+120XXXXX234*
*   **User ID**: уникальный идентификатор пользователя (например, имя или email).
<Aside type="note">
Названия столбцов в вашем CSV-файле не обязательно должны точно совпадать с этими. В процессе импорта вы можете сопоставить существующие названия столбцов с нужными полями в системе. Например, если в вашем CSV-файле есть столбец с названием *Mobile* вместо *Phone Number*, вы можете вручную назначить его полю **Phone Number** при импорте.
</Aside>

#### Необязательные столбцы

Включение необязательных столбцов позволяет использовать более продвинутую сегментацию и персонализацию в ваших SMS-кампаниях. Ниже приведены необязательные поля, которые вы можете добавить, и способы их использования:

*   **Местоположение:** указывает город, штат или страну пользователя. Полезно для отправки промоакций на основе местоположения (например, *Получите скидку 20% в нашем магазине в Лос-Анджелесе сегодня!*).
*   **День рождения:** позволяет отправлять поздравительные сообщения со специальными скидками (например, *С днем рождения, Сара! Вот скидка 10% специально для вас!*). Может запускать автоматические кампании ко дню рождения.
*   **Язык:** хранит языковые предпочтения пользователя (например, английский, испанский, французский). Помогает отправлять сообщения на языке получателя для лучшего вовлечения.
*   **Тип клиента:** определяет, является ли пользователь новым клиентом, VIP-клиентом или неактивным. Позволяет отправлять целевые сообщения (например, *Эксклюзивное VIP-предложение только для вас!*).

Вы можете добавлять любые дополнительные данные, относящиеся к вашей кампании (например, предпочтения пользователя, история покупок). Их можно сопоставить с системными тегами и использовать для сегментации в Pushwoosh.

#### Пример CSV-файла

Вот пример правильно отформатированного CSV-файла:

```csv
Phone Number,User ID,Name,Location  
+120XXXXX234,john.smith@email.com,John Smith,New York  
+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles  
```

## Загрузите CSV-файл

1.  Перейдите в **Audience → Import CSV → Import SMS Contacts.**

![Снимок экрана, показывающий меню Audience с опциями Import CSV и Import SMS Contacts](/import-sms-contacts-1.webp)

2.  Нажмите **Upload CSV** и выберите ваш файл.

![Снимок экрана, показывающий кнопку Upload CSV и интерфейс выбора файла](/import-sms-contacts-2.webp)

Если вам нужно загрузить другой файл, нажмите **Upload Another CSV**, чтобы заменить его.

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

Убедитесь, что выбраны правильные столбцы:

*   **Phone Number Column in CSV**. Выберите столбец, содержащий номера телефонов (должны быть в международном формате, начинаться с `+`).
*   **User ID Column in CSV**. Выберите столбец, содержащий уникальные идентификаторы пользователей.

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

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

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

![Снимок экрана, показывающий интерфейс сопоставления столбцов с опциями назначения номера телефона, User ID и тега](/import-sms-contacts-3.webp)

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

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