Центр поддержкиСлучаи и прием

Для: Администраторы и Менеджеры

Найдите столбцы, необходимые для каждого импорта.

Обязательные и необязательные столбцы CSV для каждого типа импорта, с указанием форматов, которые принимает каждый из них.

В этой статье8 разделов

На этой странице перечислены столбцы, которые используются для хранения информации о каждом типе импорта, указанном в разделе Интеграция › Импорты. Также указано, как правильно записывать значения в эти столбцы.

Каждый импорт

  • Первая строка содержит названия столбцов, которые могут располагаться в любом порядке. Следующие строки представляют собой отдельные записи. Сохраните файл в формате CSV UTF-8, чтобы имена с диакритическими знаками правильно отображались.
  • Файл может содержать до 25 000 строк под названиями колонок. Файлы более длинные не работают должным образом; они не могут быть импортированы. Необходимо разделить файл на несколько файлов по 25 000 строк в каждом, а затем импортировать каждый из этих файлов отдельно.
  • Пустая ячейка считается незаполненной. Применяется значение по умолчанию; ничего не удаляется из этой ячейки.
  • Избегайте отображения столбцов, которые не перечислены здесь. Большинство из них игнорируются. Однако в разделе Изменение пользователей наличие неизвестного столбца приводит к отказу в обработке записи.
  • Пишите даты в виде года первым, например 2026-03-15. Затем указывайте “да” или “нет”, используя символы true или false.
  • В одном из столбцов разместите список элементов, разделенный запятыми, например: role::staff,role::clients.
  • Назовите случай по его ID теговИдентификатор метки Постоянная метка, которую вы присваиваете делу, например, rear-end-2026, также отображается в качестве идентификатора ссылки и используется при импорте. или по его ID из списка случаев в административном панели. Назовите человека по его ID референса или ID пользователя, который можно найти в разделе «Изменение пользователя». Использование заглавных букв не имеет значения.
  • Напишите роль… role:: И его название, например: role::clients.
  • Импортер не может заполнять поля, связанные с конфигурацией данных; кроме того, он не проверяет те поля, которые отмечены как необходимые. В результате поля для создаваемого случая или человека остаются пустыми. Необходимо заполнить эти поля позже, при создании соответствующего случая или человека.

Добавить пользователей

СтолбецЧто это делаетНеобходимыйПо умолчанию
usernameИх адрес электронной почты, или номер мобильного телефона с кодом страны, например +12035556677. Тот человек, который уже находится в вашем хабе, не проходит проверку.Да.—
given_nameИмяДа.—
family_nameФамилияДа.—
localeЯзык: ar, de, en, es, fr, id, it, ja, pl, pt, ru или zhНет.en
zoneinfoЧасовая зона, например: America/New_YorkНет.US/Eastern
host_ref_idУ вас должна быть своя идентификационная информация для них – например, номер клиента. Эта информация состоит из букв, цифр, диакритических знаков. Все символы должны писаться в строчных буквах. Ни один человек не может использовать одну и ту же информацию для нескольких людей.Нет.Ничего.
host_default_roleЭта роль принимается в первую очередь, когда элементы добавляются в определенную структуру, например, в role::clients. Однако она не предоставляет никаких преимуществ.Нет.Ничего.
host_staff_designationИх обычные обозначения персонала: primary, attorney, paralegal, case_manager, lead_attorney или lead_paralegalНет.primary
birthdateДата рожденияНет.Ничего.
genderMale или FemaleНет.Ничего.
address1, address2, locality, region, postal_codeАдрес: второй столбец, город, штат и почтовый индексНет.Ничего.
countryДвухбуквенный код страны, например: USНет.Ничего.
company, titleКомпания и должностьНет.Ничего.
host_create_casetrue позволяет им создавать различные ситуации, подобные той, что происходит при использовании Можно создать дело в функции «Изменение пользователя».Нет.false
host_add_case_userЭти функции позволяют добавлять людей в определенную ситуацию, например, в структуру Можно добавить пользователя дела как.Нет.Ничего.
host_remove_case_usertrue позволяет им удалять людей из какого-либо случая, подобно Может удалить пользователя дела.Нет.false

Все входящие пользователи являются таковыми по своей природе. Чтобы предоставить какому-либо человеку доступ к административному панелю, смотрите раздел “Предоставление доступа члену команды к административному панелю”.

Изменить пользователей

СтолбецЧто это делаетНеобходимыйПо умолчанию
user_idЧеловек, который должен быть изменен… Администратора нельзя изменить с помощью импорта.Да.—
host_user_status0 отключает их, а 1 снова активирует их.Нет.Не изменилось.
Любая колонка с именами пользователей, кроме usernameЗаменяет этот элемент детали.Нет.Не изменилось.

Импортер не может изменять адрес электронной почты, номер телефона или тип пользователя у человека. Язык и часовой пояс остаются за человеком сразу после его входа в ваш центр управления. Изменение этих параметров здесь не влияет на то, что происходит с человеком в реальном времени.

Создать кейсы

СтолбецЧто это делаетНеобходимыйПо умолчанию
ref_idID случая: буквы, цифры, знаки отрицания и слегка выделенные символы; все эти символы пишутся в строчной форме. ID случая другого типа не соответствует условиям для разбиения на ряды.Да.—
titleНазвание делаДа.—
case_typeОдин из ваших хабов… Типы случаевТип дела Категория для конкретных случаев, например, «общие», используется для того, чтобы автоматизация выполнялась в нужных случаях., Написано так: настройки › ПоляНет.general
case_status1 — для открытого состояния; 0 — для закрытого состояния.Нет.1
date_openedДата начала рассмотрения делаНет.Сегодня
descriptionОписание делаНет.Ничего.
case_stageИд его этап/фазаЭтап Этап, через который проходит дело, например, прием заявки или отправка запроса, который фирма обозначает и описывает и который отображается на странице дела., Копировано из него. Идентификатор этапа внутри настройки › ЭтапыНет.Никакой стадии
hidden_modulesРазделы, которые нужно скрыть в данном случае. Разделы должны быть разделены запятыми. Пример: invoices,notes; case, convos, events, forms, signs, invoices, notes, tasks и team.Нет.Ничего не скрыто.

Изменить регистры

СтолбецЧто это делаетНеобходимыйПо умолчанию
case_idНужно изменить ситуацию.Да.—
title, description, case_status, date_openedЧто касается функции «Создание случаев», то речь идет о замене содержания самого случая.Нет.Не изменилось.
case_typeОдин из типов случаев, связанных с вашим хабом, или сам тип случая – даже если вы уже удалили его из своих настроек.Нет.Не изменилось.
case_stageЭтот этап позволяет переместить случай в нужное место. Импортера не может вывести случай из этого этапа.Нет.Не изменилось.
hidden_modulesЗаменяет те разделы, которые скрыты в случае. Импорт не может снова показать все эти разделы.Нет.Не изменилось.

ID случая не может быть изменен.

Назначайте пользователей на обращения.

СтолбецЧто это делаетНеобходимыйПо умолчанию
case_idДело/СитуацияДа.—
user_idЧеловек, которого нужно добавить.Да.—
case_role_idИх роль в этом деле заключается в использовании символа clients, как с одним, так и с двумя символами role::.Да.—
case_notifytrue отправляет им приглашение на участие в процедуре.Да.—
client_designationВ роли клиента: primary или guardianНет.primary
staff_designationВ должности сотрудника или в любой из своих собственных должностей: primary, attorney, paralegal, case_manager, lead_attorney или lead_paralegalНет.primary

Заполните столбец, указывающий роль строки. Оставьте другие поля пустыми. Если в строке, относящейся к определенной должности или категории, значение primary или guardian, то эта строка не будет отображаться. Также строка не будет отображаться, если в ней указано имя сотрудника из коллектива клиентов. Строка также не будет отображаться, если в ней указано имя человека, уже работающего над данным делом, или если в деле уже работает 20 человек.

Создание сообщений о случаях

СтолбецЧто это делаетНеобходимыйПо умолчанию
case_idДело/СитуацияДа.—
user_idОт кого пост: это человек, который занимается данным делом. Его роль заключается в добавлении сообщений на сайт. Это может быть сотрудник организации.Да.—
messageТекст сообщенияДа.—
permissionsРоли, которые могут это видеть, например role::staffНет.Все, кто занимается этим делом…

Каждый пост сообщает людям о том, что было добавлено самим автором этого поста. Строка для закрытых случаев отсутствует.

Удалить пользователей, назначенных на дела.

СтолбецЧто это делаетНеобходимыйПо умолчанию
case_idДело/СитуацияДа.—
user_idЧеловек, который должен снять это.Да.—

Тот, кто не занимается этим делом, не может считаться профессионалом в своей области.

Статьи по теме

Импорт клиентов из CSV-файлаДля добавления множества клиентов одновременно загрузите CSV-файл с их именами, адресами электронной почты или номерами телефонов.Случаи и прием · 10 minИмпорт случаев из CSV-файлаСоздавайте множество дел одновременно из CSV-файла, указывая для каждого дела идентификатор тега, заголовок, тип и статус.Случаи и прием · 10 minДобавляйте людей в дела массово.Назначайте существующих пользователей сразу на множество дел из CSV-файла, указывая их роли, и выбирайте, будет ли каждому из них отправлено приглашение.Случаи и прием · 10 min