Перейти к основному содержанию

Обзор

Это руководство проведет вас через процесс импорта ваших компаний в Twenty. Компании следует импортировать в первую очередь, поскольку Люди и Сделки связываются с Компаниями.

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

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

Ваш файл в формате CSV, XLSX или XLS
В файле менее 10 000 записей
В вашем файле нет повторяющихся доменов
Все пользовательские поля созданы в Настройки → Модель данных
Нужно импортировать более 10 000 компаний? Разбейте на несколько файлов или используйте импорт через API.

Шаг 1: Подготовьте данные о компаниях

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

ПолеОбязательно?ФорматЗаметки
НазваниеРекомендуетсяТекстОтображаемое название компании
ДоменРекомендуетсяhttps://domain.comУникальный идентификатор
АдресНеобязательноНесколько столбцовСм. ниже
СотрудникиНеобязательноЧислоКоличество сотрудников
Пользовательские поляНеобязательноРазличаетсяДолжны существовать в модели данных

Формат домена

Используйте формат https://domain.com для доменов.Это соответствует формату, используемому, когда Компании автоматически создаются при синхронизации почты/календаря, что предотвращает появление дубликатов в дальнейшем.
Столбцы домена:
  • Domain / Domain Label: acme.com
  • Domain / Domain URL: https://acme.com

Формат адреса

Адрес — это вложенное поле с несколькими столбцами:
Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
123 Main Street,San Francisco,CA,USA,94105

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

name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
Widget Co,https://widgets.co,widgets.co,New York,USA,50
Совет профессионала: Нажмите 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 для столбцов, которые вы не хотите импортировать

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

  • Домен: сопоставьте с Domain / Domain URL (не с Domain Label)
  • Адрес: сопоставьте каждую часть с соответствующим столбцом (City, State и т. д.)
  • Поля Select: значения должны соответствовать существующим вариантам (или вы сопоставите их на следующем шаге)

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

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

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

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

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

ОшибкаПричинаРешение
Дублирующийся доменДомен уже существует в TwentyУдалите из файла или обновите существующую запись
Недопустимый формат доменаНеверный форматИспользуйте https://domain.com
Отсутствует обязательное полеОбязательное поле пустоЗаполните значение или удалите строку

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

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

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

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

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

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

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

Домен — уникальный идентификатор в Twenty. Это предотвращает дубли компаний и обеспечивает корректную привязку писем к нужной компании при синхронизации электронной почты.
Вы можете оставить домен пустым. Однако мы рекомендуем по возможности добавлять домены для улучшения качества данных и автоматической привязки писем.
Да! Сначала вы можете импортировать компании, а позже импортировать контакты и связать их с помощью домена компании.
Если вы укажете уникальный идентификатор (домен или id), который совпадает с существующей компанией, Twenty обновит эту компанию вместо создания дубликата.
Либо удалите дубликат из вашего файла, либо добавьте id компании, чтобы вместо этого обновить существующую запись.

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

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