snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx

@@ -0,0 +1,242 @@
+---
+title: Импорт контактов через CSV
+description: Полное пошаговое руководство по импорту людей/контактов в Twenty.
+---
+
+## Обзор
+
+Это руководство проведет вас через процесс импорта ваших контактов (People) в Twenty.
+
+## Перед началом
+
+### Контрольный список предварительных требований
+
+<Check>
+Ваш файл в формате CSV, XLSX или XLS
+</Check>
+
+<Check>
+В файле менее 10 000 записей
+</Check>
+
+<Check>
+В вашем файле нет повторяющихся адресов электронной почты
+</Check>
+
+<Check>
+**Компании импортированы первыми** (если вы связываете Людей с Компаниями)
+</Check>
+
+<Check>
+Все пользовательские поля созданы в **Настройки → Модель данных**
+</Check>
+
+<Warning>
+**Импортируйте Компании перед импортом Людей**
+
+Если вы хотите связать Людей с Компаниями, сначала импортируйте Компании. Компания должна существовать до того, как вы сможете на неё сослаться.
+</Warning>
+
+## Шаг 1: Подготовьте данные контактов
+
+### Обязательные и рекомендуемые поля
+
+| Поле                      | Обязательно?  | Формат             | Заметки                             |
+| ------------------------- | ------------- | ------------------ | ----------------------------------- |
+| **Электронная почта**     | Рекомендуется | `name@domain.com`  | Должен быть уникальным              |
+| **Имя**                   | Рекомендуется | Текст              |                                     |
+| **Фамилия**               | Рекомендуется | Текст              |                                     |
+| **Компания**              | Необязательно | Домен или ID       | Связывает с существующей Компанией  |
+| **Телефон**               | Необязательно | Несколько столбцов | См. ниже                            |
+| **Должность**             | Необязательно | Текст              |                                     |
+| **Пользовательские поля** | Необязательно | Различается        | Должны существовать в модели данных |
+
+### Формат электронной почты
+
+* Должен быть корректный формат электронной почты: `name@domain.com`
+* **Должен быть уникальным** — без дубликатов в вашем файле или в Twenty
+* Для дополнительных адресов используйте столбец **Emails / Additional Emails**:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Формат телефона
+
+Телефон — это **вложенное поле**, требующее нескольких столбцов:
+
+| Столбец                                 | Пример       |
+| --------------------------------------- | ------------ |
+| **Phones / Primary Phone Number**       | `4159095555` |
+| **Phones / Primary Phone Country Code** | `US`         |
+| **Phones / Primary Phone Calling Code** | `+1`         |
+
+### Связывание с компаниями
+
+Добавьте столбец с уникальным идентификатором компании:
+
+| Название столбца | Формат     | Пример                                 |
+| ---------------- | ---------- | -------------------------------------- |
+| `companyDomain`  | Формат URL | `https://acme.com`                     |
+| `companyId`      | UUID       | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
+
+<Note>
+**Используйте формат URL домена** (`https://acme.com`), а не метку. Это соответствует тому, как Компании хранятся в Twenty.
+</Note>
+
+### Пример структуры CSV
+
+```csv
+firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
+John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
+Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
+```
+
+<Note>
+**Совет профессионала:** Нажмите **Download sample file** во время импорта или экспортируйте несколько существующих Людей, чтобы увидеть точные названия столбцов, которые ожидает Twenty.
+</Note>
+
+## Шаг 2: Откройте функцию импорта
+
+**Вариант 1: Из представления Люди**
+
+1. Перейдите к разделу **Люди** в левой боковой панели
+2. Нажмите значок **⋮** в правом верхнем углу
+3. Выберите **Импорт записей**
+
+**Вариант 2: Через командное меню**
+
+1. Нажмите `Cmd + K` (Mac) или `Ctrl + K` (Windows)
+2. Введите "import"
+3. Выберите **Импорт записей**
+4. Выберите **Люди**
+
+## Шаг 3: Загрузите свой файл
+
+1. Нажмите **Выбрать файл**
+2. Выберите свой файл CSV, XLSX или XLS
+3. Подождите, пока Twenty проанализирует ваш файл
+
+## Шаг 4: Сопоставьте ваши столбцы
+
+Twenty автоматически пытается сопоставить ваши столбцы с полями. Проверьте и при необходимости скорректируйте:
+
+1. **Проверьте автоматические сопоставления** — убедитесь, что они верны
+2. **Исправьте неверные сопоставления** — нажмите на раскрывающийся список, чтобы выбрать нужное поле
+3. **Пропустите столбцы** — выберите **Do not map** для столбцов, которые вы не хотите импортировать
+
+### Важные правила сопоставления
+
+| Тип столбца                             | Сопоставить с                  | Заметки                           |
+| --------------------------------------- | ------------------------------ | --------------------------------- |
+| Ссылка на Компанию                      | Поле связи **Компания**        | Используйте домен ИЛИ id, не оба  |
+| Электронная почта                       | **Электронная почта**          | Основной адрес электронной почты  |
+| Дополнительные адреса электронной почты | **Emails / Additional Emails** | Формат массива                    |
+| Телефон                                 | Отдельные столбцы              | Номер, код страны, телефонный код |
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
+
+### Сопоставление связи с Компанией
+
+При сопоставлении столбца компании:
+
+1. Найдите столбец ссылки на компанию (например, `companyDomain`)
+2. Сопоставьте его с полем связи **Компания**
+3. Twenty свяжет каждого человека с соответствующей Компанией
+
+<Warning>
+**Сопоставляйте только ОДИН уникальный идентификатор для связей.**
+
+Не сопоставляйте одновременно `companyId` И `companyDomain`. Выберите один — предпочтительно домен, так как он понятен человеку.
+</Warning>
+
+## Шаг 5: Сопоставление значений полей Select
+
+Если у вас есть поля Select или Multi-Select (например, Lead Source):
+
+1. Twenty показывает ваши значения рядом с существующими вариантами
+2. Сопоставьте каждое значение в вашем файле с вариантом Twenty
+3. Или при необходимости создайте новые варианты
+
+<Note>
+Для вариантов Select используются **имена API**, а не отображаемые метки. Перейдите в **Настройки → Модель данных** → включите **Расширенный режим**, чтобы увидеть имена API.
+</Note>
+
+## Шаг 6: Проверьте и исправьте ошибки
+
+Перед завершением импорта Twenty проверяет ваши данные:
+
+1. Нажмите **Следующие шаги**
+2. Строки с ошибками выделены **желтым**
+3. **Исправляйте ошибки напрямую** — нажмите на ячейку и отредактируйте значение
+4. **Удалите проблемные строки** — нажмите X, чтобы пропустить эту строку
+
+### Распространенные ошибки импорта контактов
+
+| Ошибка                                           | Причина                                                     | Решение                                            |
+| ------------------------------------------------ | ----------------------------------------------------------- | -------------------------------------------------- |
+| **Дублирующийся адрес электронной почты**        | Адрес электронной почты уже существует в Twenty или в файле | Удалите дубликат или обновите существующую запись  |
+| **Недопустимый формат адреса электронной почты** | Неверный формат адреса электронной почты                    | Исправьте на `name@domain.com`                     |
+| **Связь не найдена**                             | Компания не существует                                      | Сначала импортируйте Компании или исправьте ссылку |
+| **Отсутствует обязательное поле**                | Обязательное поле пусто                                     | Заполните значение или удалите строку              |
+
+## Шаг 7: Завершите импорт
+
+1. Просмотрите сводку импорта
+2. Нажмите **Подтвердить**, чтобы импортировать
+3. Дождитесь завершения импорта
+4. Проверьте, открыв несколько записей и их ссылки на Компанию
+
+## После импорта контактов
+
+Ваши контакты теперь в Twenty! Следующие шаги:
+
+1. **Проверьте связи с Компанией** — откройте несколько записей Людей, чтобы убедиться, что они связаны с нужной Компанией
+2. **Импортируйте Сделки** — при необходимости свяжите их с Людьми и Компаниями
+3. **Настройте синхронизацию электронной почты** — подключите свой почтовый ящик, чтобы видеть историю писем в записях контактов
+
+## Обновление существующих контактов
+
+Чтобы обновлять контакты вместо создания новых:
+
+1. Добавьте в файл столбец `email` или `id`
+2. Twenty сопоставляет записи по этому уникальному идентификатору
+3. Существующие контакты обновляются; новые создаются
+
+См. [Как обновить существующие записи](/l/ru/user-guide/data-migration/how-tos/update-existing-records-via-import) для подробностей.
+
+## Часто задаваемые вопросы
+
+<AccordionGroup>
+  <Accordion title="Почему у двух Людей не может быть один и тот же адрес электронной почты?">
+    Адрес электронной почты — уникальный идентификатор в Twenty. Это предотвращает дубли контактов и обеспечивает корректную привязку писем к нужному контакту при синхронизации электронной почты.
+  </Accordion>
+
+  <Accordion title="Что делать, если у некоторых Людей нет адреса электронной почты?">
+    Вы можете оставить поле email пустым. Однако мы рекомендуем по возможности добавлять адреса электронной почты для лучшего качества данных и корректной работы синхронизации электронной почты.
+  </Accordion>
+
+  <Accordion title="Как связать Людей с Компаниями при импорте?">
+    Добавьте столбец с доменом Компании (например, `https://acme.com`) или ID. При сопоставлении свяжите этот столбец с полем связи с Компанией.
+  </Accordion>
+
+  <Accordion title="Что, если Компания еще не существует?">
+    Сначала импортируйте Компании, затем импортируйте Людей. Компания должна существовать до того, как вы сможете на нее сослаться.
+  </Accordion>
+
+  <Accordion title="Можно ли импортировать ID из предыдущей CRM?">
+    Да! Создайте настраиваемое поле с пометкой "уникальное" в вашей модели данных для хранения внешнего ID. Примечание: имя поля `id` зарезервировано для внутреннего ID Twenty.
+  </Accordion>
+
+  <Accordion title="Как исправить ошибки 'relation not found'?">
+    Компания, на которую вы ссылаетесь, не существует. Либо сначала импортируйте Компанию, либо проверьте, что домен/ID в точности совпадает с существующей Компанией.
+  </Accordion>
+</AccordionGroup>
+
+## Устранение неполадок
+
+Возникли проблемы? Проверьте:
+
+* [Как исправить ошибки импорта](/l/ru/user-guide/data-migration/how-tos/fix-import-errors)
+* [Как импортировать связи](/l/ru/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+* [Справочник по сопоставлению полей](/l/ru/user-guide/data-migration/capabilities/field-mapping)