> ## 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.
* CSV-файл, содержащий как минимум колонку `email`.
* Количество контактов не должно превышать лимит вашего тарифа (см. [Биллинг](/ru/billing/overview)).

## Шаг 1: Подготовка CSV-файла

Ваш CSV должен содержать следующие колонки:

| Колонка | Обязательно | Описание                                                     |
| ------- | ----------- | ------------------------------------------------------------ |
| `email` | Да          | Действующий адрес электронной почты. Должен быть уникальным. |
| `name`  | Нет         | Отображаемое имя для персонализации.                         |

Вы можете добавить и другие колонки (например: `company`, `segment`). Они будут храниться в зашифрованном виде и могут использоваться в тегах или логике сегментации.

## Шаг 2: Проверка формата

* **Кодировка:** Рекомендуется UTF-8.
* **Разделитель:** Запятая (`,`).
* **Строка заголовка:** Первая строка должна содержать названия колонок. Названия `email` и `name` распознаются без учета регистра.
* **Дубликаты email:** Дубликаты в одном файле объединяются. Существующие контакты с тем же адресом электронной почты будут обновлены.

<Warning>
  Некорректные адреса (с ошибками, без символа `@` и т.д.) будут пропущены. Проверьте сводку после загрузки, чтобы увидеть, сколько строк было импортировано, а сколько пропущено.
</Warning>

## Шаг 3: Загрузка в Nudgen

1. Перейдите в раздел **Контакты (Contacts)** в боковой панели.
2. Нажмите **Upload CSV (Загрузить CSV)**.
3. Выберите файл.
4. Выберите теги, которые нужно применить ко всем загружаемым контактам (например: `inactive`, `re-engage`).
5. Просмотрите превью и подтвердите загрузку.

## Ограничения

* **Размер файла:** Следуйте указаниям на экране (обычно несколько МБ). Обработка больших списков может занять больше времени.
* **Контакты в рабочем пространстве:** Зависит от вашего тарифного плана. Приложение проверяет лимит в момент загрузки; если он будет превышен, загрузка будет отклонена. Актуальные лимиты можно найти на странице [Биллинга](/ru/billing/overview) и в [таблице цен](https://nudgen.net/pricing).

## Что дальше

* Контакты появятся в списке со скрытыми email-адресами (`j***@g***.com`).
* Используйте теги для сегментации аудитории в [кампаниях](/ru/campaigns/create).
* Как владелец аккаунта, вы можете [отобразить (reveal)](/ru/contacts/overview) данные отдельных контактов.

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Некоторые строки были пропущены">
    Убедитесь, что в каждой строке в колонке `email` указан корректный адрес. Пустые строки или некорректные адреса пропускаются.
  </Accordion>

  <Accordion title="Ошибка загрузки: превышен лимит тарифа">
    Количество контактов превысит доступный лимит. Перейдите на более высокий тариф или удалите существующие контакты.
  </Accordion>

  <Accordion title="Колонка не распознана">
    Убедитесь, что в строке заголовка есть колонка `email` (или `Email`). Остальные колонки необязательны.
  </Accordion>
</AccordionGroup>

## Связанные документы

<CardGroup cols={2}>
  <Card title="Обзор контактов" icon="users" href="/ru/contacts/overview">
    Шифрование, маскирование и сегментация.
  </Card>

  <Card title="Создание кампаний" icon="paper-plane" href="/ru/campaigns/create">
    Выберите аудиторию и запустите кампанию.
  </Card>
</CardGroup>