Обзор
Это руководство проведет вас через процесс импорта ваших контактов (People) в Twenty. Сначала импортируйте Компании, если хотите связать Людей с Компаниями.Перед началом
Контрольный список предварительных требований
Ваш файл в формате CSV, XLSX или XLS
В файле менее 10 000 записей
В вашем файле нет повторяющихся адресов электронной почты
Компании импортированы первыми (если вы связываете Людей с Компаниями)
Все пользовательские поля созданы в Настройки → Модель данных
Шаг 1: Подготовьте данные контактов
Обязательные и рекомендуемые поля
| Поле | Обязательно? | Формат | Заметки |
|---|---|---|---|
| Электронная почта | Рекомендуется | [email protected] | Должен быть уникальным |
| Имя | Рекомендуется | Текст | |
| Фамилия | Рекомендуется | Текст | |
| Компания | Необязательно | Домен или ID | Связывает с существующей Компанией |
| Телефон | Необязательно | Несколько столбцов | См. ниже |
| Должность | Необязательно | Текст | |
| Пользовательские поля | Необязательно | Различается | Должны существовать в модели данных |
Формат электронной почты
- Должен быть корректный формат электронной почты:
[email protected] - Должен быть уникальным — без дубликатов в вашем файле или в Twenty
- Для дополнительных адресов используйте столбец Emails / Additional Emails:
Формат телефона
Телефон — это вложенное поле, требующее нескольких столбцов:| Столбец | Пример |
|---|---|
| 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 |
Используйте формат URL домена (
https://acme.com), а не метку. Это соответствует тому, как Компании хранятся в Twenty.Пример структуры CSV
Совет профессионала: Нажмите Download sample file во время импорта или экспортируйте несколько существующих Людей, чтобы увидеть точные названия столбцов, которые ожидает Twenty.
Шаг 2: Откройте функцию импорта
Вариант 1: Из представления Люди- Перейдите к разделу Люди в левой боковой панели
- Нажмите значок ⋮ в правом верхнем углу
- Выберите Импорт записей
- Нажмите
Cmd + K(Mac) илиCtrl + K(Windows) - Введите “import”
- Выберите Импорт записей
- Выберите Люди
Шаг 3: Загрузите свой файл
- Нажмите Выбрать файл
- Выберите свой файл CSV, XLSX или XLS
- Подождите, пока Twenty проанализирует ваш файл
Шаг 4: Сопоставьте ваши столбцы
Twenty автоматически пытается сопоставить ваши столбцы с полями. Проверьте и при необходимости скорректируйте:- Проверьте автоматические сопоставления — убедитесь, что они верны
- Исправьте неверные сопоставления — нажмите на раскрывающийся список, чтобы выбрать нужное поле
- Пропустите столбцы — выберите Do not map для столбцов, которые вы не хотите импортировать
Важные правила сопоставления
| Тип столбца | Сопоставить с | Заметки |
|---|---|---|
| Ссылка на Компанию | Поле связи Компания | Используйте домен ИЛИ id, не оба |
| Электронная почта | Электронная почта | Основной адрес электронной почты |
| Дополнительные адреса электронной почты | Emails / Additional Emails | Формат массива |
| Телефон | Отдельные столбцы | Номер, код страны, телефонный код |
Сопоставление связи с Компанией
При сопоставлении столбца компании:- Найдите столбец ссылки на компанию (например,
companyDomain) - Сопоставьте его с полем связи Компания
- Twenty свяжет каждого человека с соответствующей Компанией
Шаг 5: Сопоставление значений полей Select
Если у вас есть поля Select или Multi-Select (например, Lead Source):- Twenty показывает ваши значения рядом с существующими вариантами
- Сопоставьте каждое значение в вашем файле с вариантом Twenty
- Или при необходимости создайте новые варианты
Для вариантов Select используются имена API, а не отображаемые метки. Перейдите в Настройки → Модель данных → включите Расширенный режим, чтобы увидеть имена API.
Шаг 6: Проверьте и исправьте ошибки
Перед завершением импорта Twenty проверяет ваши данные:- Нажмите Следующие шаги
- Строки с ошибками выделены желтым
- Исправляйте ошибки напрямую — нажмите на ячейку и отредактируйте значение
- Удалите проблемные строки — нажмите X, чтобы пропустить эту строку
Распространенные ошибки импорта контактов
| Ошибка | Причина | Решение |
|---|---|---|
| Дублирующийся адрес электронной почты | Адрес электронной почты уже существует в Twenty или в файле | Удалите дубликат или обновите существующую запись |
| Недопустимый формат адреса электронной почты | Неверный формат адреса электронной почты | Исправьте на [email protected] |
| Связь не найдена | Компания не существует | Сначала импортируйте Компании или исправьте ссылку |
| Отсутствует обязательное поле | Обязательное поле пусто | Заполните значение или удалите строку |
Шаг 7: Завершите импорт
- Просмотрите сводку импорта
- Нажмите Подтвердить, чтобы импортировать
- Дождитесь завершения импорта
- Проверьте, открыв несколько записей и их ссылки на Компанию
После импорта контактов
Ваши контакты теперь в Twenty! Следующие шаги:- Проверьте связи с Компанией — откройте несколько записей Людей, чтобы убедиться, что они связаны с нужной Компанией
- Импортируйте Сделки — при необходимости свяжите их с Людьми и Компаниями
- Настройте синхронизацию электронной почты — подключите свой почтовый ящик, чтобы видеть историю писем в записях контактов
Обновление существующих контактов
Чтобы обновлять контакты вместо создания новых:- Добавьте в файл столбец
emailилиid - Twenty сопоставляет записи по этому уникальному идентификатору
- Существующие контакты обновляются; новые создаются
Часто задаваемые вопросы
Почему у двух Людей не может быть один и тот же адрес электронной почты?
Почему у двух Людей не может быть один и тот же адрес электронной почты?
Адрес электронной почты — уникальный идентификатор в Twenty. Это предотвращает дубли контактов и обеспечивает корректную привязку писем к нужному контакту при синхронизации электронной почты.
Что делать, если у некоторых Людей нет адреса электронной почты?
Что делать, если у некоторых Людей нет адреса электронной почты?
Вы можете оставить поле email пустым. Однако мы рекомендуем по возможности добавлять адреса электронной почты для лучшего качества данных и корректной работы синхронизации электронной почты.
Как связать Людей с Компаниями при импорте?
Как связать Людей с Компаниями при импорте?
Добавьте столбец с доменом Компании (например,
https://acme.com) или ID. При сопоставлении свяжите этот столбец с полем связи с Компанией.Что, если Компания еще не существует?
Что, если Компания еще не существует?
Сначала импортируйте Компании, затем импортируйте Людей. Компания должна существовать до того, как вы сможете на нее сослаться.
Можно ли импортировать ID из предыдущей CRM?
Можно ли импортировать ID из предыдущей CRM?
Да! Создайте настраиваемое поле с пометкой “уникальное” в вашей модели данных для хранения внешнего ID. Примечание: имя поля
id зарезервировано для внутреннего ID Twenty.Как исправить ошибки 'relation not found'?
Как исправить ошибки 'relation not found'?
Компания, на которую вы ссылаетесь, не существует. Либо сначала импортируйте Компанию, либо проверьте, что домен/ID в точности совпадает с существующей Компанией.