Skip to main content

​
Обзор

Это руководство проведет вас через процесс импорта ваших контактов (People) в Twenty.

​
Перед началом

​
Контрольный список предварительных требований

Ваш файл в формате CSV, XLSX или XLS
В файле менее 10 000 записей
В вашем файле нет повторяющихся адресов электронной почты
Компании импортированы первыми (если вы связываете Людей с Компаниями)
Все пользовательские поля созданы в Настройки → Модель данных
Импортируйте Компании перед импортом ЛюдейЕсли вы хотите связать Людей с Компаниями, сначала импортируйте Компании. Компания должна существовать до того, как вы сможете на неё сослаться.

​
Шаг 1: Подготовьте данные контактов

​
Обязательные и рекомендуемые поля

​
Формат электронной почты

  • Должен быть корректный формат электронной почты: name@domain.com
  • Должен быть уникальным — без дубликатов в вашем файле или в Twenty
  • Для дополнительных адресов используйте столбец Emails / Additional Emails:

​
Формат телефона

Телефон — это вложенное поле, требующее нескольких столбцов:

​
Связывание с компаниями

Добавьте столбец с уникальным идентификатором компании:
Используйте формат URL домена (https://acme.com), а не метку. Это соответствует тому, как Компании хранятся в Twenty.

​
Пример структуры CSV

Совет профессионала: Нажмите Download sample file во время импорта или экспортируйте несколько существующих Людей, чтобы увидеть точные названия столбцов, которые ожидает Twenty.

​
Шаг 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 для столбцов, которые вы не хотите импортировать

​
Важные правила сопоставления

​
Сопоставление связи с Компанией

При сопоставлении столбца компании:
  1. Найдите столбец ссылки на компанию (например, companyDomain)
  2. Сопоставьте его с полем связи Компания
  3. Twenty свяжет каждого человека с соответствующей Компанией
Сопоставляйте только ОДИН уникальный идентификатор для связей.Не сопоставляйте одновременно companyId И companyDomain. Выберите один — предпочтительно домен, так как он понятен человеку.

​
Шаг 5: Сопоставление значений полей Select

Если у вас есть поля Select или Multi-Select (например, Lead Source):
  1. Twenty показывает ваши значения рядом с существующими вариантами
  2. Сопоставьте каждое значение в вашем файле с вариантом Twenty
  3. Или при необходимости создайте новые варианты
Для вариантов Select используются имена API, а не отображаемые метки. Перейдите в Настройки → Модель данных → включите Расширенный режим, чтобы увидеть имена API.

​
Шаг 6: Проверьте и исправьте ошибки

Перед завершением импорта Twenty проверяет ваши данные:
  1. Нажмите Следующие шаги
  2. Строки с ошибками выделены желтым
  3. Исправляйте ошибки напрямую — нажмите на ячейку и отредактируйте значение
  4. Удалите проблемные строки — нажмите X, чтобы пропустить эту строку

​
Распространенные ошибки импорта контактов

​
Шаг 7: Завершите импорт

  1. Просмотрите сводку импорта
  2. Нажмите Подтвердить, чтобы импортировать
  3. Дождитесь завершения импорта
  4. Проверьте, открыв несколько записей и их ссылки на Компанию

​
После импорта контактов

Ваши контакты теперь в Twenty! Следующие шаги:
  1. Проверьте связи с Компанией — откройте несколько записей Людей, чтобы убедиться, что они связаны с нужной Компанией
  2. Импортируйте Сделки — при необходимости свяжите их с Людьми и Компаниями
  3. Настройте синхронизацию электронной почты — подключите свой почтовый ящик, чтобы видеть историю писем в записях контактов

​
Обновление существующих контактов

Чтобы обновлять контакты вместо создания новых:
  1. Добавьте в файл столбец email или id
  2. Twenty сопоставляет записи по этому уникальному идентификатору
  3. Существующие контакты обновляются; новые создаются
См. Как обновить существующие записи для подробностей.

​
Часто задаваемые вопросы

Адрес электронной почты — уникальный идентификатор в Twenty. Это предотвращает дубли контактов и обеспечивает корректную привязку писем к нужному контакту при синхронизации электронной почты.
Вы можете оставить поле email пустым. Однако мы рекомендуем по возможности добавлять адреса электронной почты для лучшего качества данных и корректной работы синхронизации электронной почты.
Добавьте столбец с доменом Компании (например, https://acme.com) или ID. При сопоставлении свяжите этот столбец с полем связи с Компанией.
Сначала импортируйте Компании, затем импортируйте Людей. Компания должна существовать до того, как вы сможете на нее сослаться.
Да! Создайте настраиваемое поле с пометкой “уникальное” в вашей модели данных для хранения внешнего ID. Примечание: имя поля id зарезервировано для внутреннего ID Twenty.
Компания, на которую вы ссылаетесь, не существует. Либо сначала импортируйте Компанию, либо проверьте, что домен/ID в точности совпадает с существующей Компанией.

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

Возникли проблемы? Проверьте: