Para: Administradores e Gerentes
Consulte as colunas que cada importação precisa.
As colunas CSV obrigatórias e opcionais para cada tipo de importação, com os formatos que cada uma aceita.
Neste artigo8 seções
Esta página lista as colunas que cada tipo de importação é referenciado em Integração › Importações. Também indica como escrever os valores dessas colunas.
Cada importação
- A primeira linha contém os nomes das colunas, em qualquer ordem. Cada linha seguinte representa um registro. Salve o arquivo como CSV UTF-8, para que os nomes com acentos sejam exibidos corretamente.
- O arquivo pode conter até 25.000 linhas, sob os nomes das colunas. Arquivos mais longos não funcionam adequadamente e não conseguem importar nada. É necessário dividir o arquivo em arquivos com no máximo 25.000 linhas cada, e importar cada um deles separadamente.
- Uma célula em branco é considerada como não preenchida. A configuração padrão continua aplicada, e nada é apagado.
- Deixe de fora as colunas que não estão listadas aqui. A maioria delas é ignorada. No entanto, na seção Modificar usuários, uma coluna desconhecida faz com que a linha seja considerada inválida.
- Escreva os anos da data primeiro, como 2026-03-15. Use “
true” ou “false” para indicar sim ou não. - Coloque uma lista em uma única célula, separada por vírgulas, como
role::staff,role::clients. - Nomeie um caso pelo seu ID da etiquetaID da etiqueta Uma etiqueta permanente que você atribui a um caso, como rear-end-2026, também exibida como ID de referência e usada em importações., ou pelo seu ID de caso, presente na lista de casos do Painel de Administração. Nomeie uma pessoa pelo seu ID de referência ou pelo seu ID de usuário, que foi copiado a partir da opção “Editar Usuário”. As letras maiúsculas não têm importância.
- Escreva um papel para
role::e o nome dele, comorole::clients. - Um importador não pode preencher os campos personalizados, e também não verifica aqueles marcados como Requeridos. O caso ou pessoa que ele cria possui todos esses campos vazios. É necessário preencher esses campos posteriormente, no próprio caso ou pessoa em questão.
Adicionar usuários
| Coluna | O que faz | Obrigatório | Padrão |
|---|---|---|---|
username | O endereço de e-mail deles, ou o número de celular com o código do país, como +12035556677. Alguém que já está no seu hub falhou na tarefa. | Sim | — |
given_name | Nome próprio | Sim | — |
family_name | Sobrenome | Sim | — |
locale | Língua: ar, de, en, es, fr, id, it, ja, pl, pt, ru ou zh | Não | en |
zoneinfo | Fuso horário, como America/New_York | Não | US/Eastern |
host_ref_id | É necessário ter um identificador próprio para eles, como um número de cliente. Esse identificador pode conter letras, números, traços e barras. Todos os caracteres devem ser escritos em minúsculas. Nenhuma duas pessoas podem compartilhar o mesmo identificador. | Não | Nenhum |
host_default_role | O papel é atribuído primeiro, quando eles são adicionados a um caso, como por exemplo role::clients. Isso não gera nenhum benefício. | Não | Nenhum |
host_staff_designation | As designações habituais de seus funcionários são: primary, attorney, paralegal, case_manager, lead_attorney ou lead_paralegal. | Não | primary |
birthdate | Data de nascimento | Não | Nenhum |
gender | Male ou Female | Não | Nenhum |
address1, address2, locality, region, postal_code | Endereço: segunda linha, cidade, estado e CEP | Não | Nenhum |
country | Código de país de dois caracteres, como US | Não | Nenhum |
company, title | Empresa e cargo | Não | Nenhum |
host_create_case | true permite que eles criem casos, como Pode criar um caso na opção “Editar Usuário”. | Não | false |
host_add_case_user | Os papéis que eles podem usar para adicionar pessoas a um caso, como Pode adicionar um usuário de caso como | Não | Nenhum |
host_remove_case_user | true permite que eles removam pessoas de um caso, assim como Pode remover um usuário de caso | Não | false |
Todos os usuários importados são considerados “Usuários”. Para conceder acesso ao Painel de Administração a alguém, consulte Conceder acesso ao Painel de Administração a um membro da equipe.
Modificar usuários
| Coluna | O que faz | Obrigatório | Padrão |
|---|---|---|---|
user_id | A pessoa que precisa ser alterada… Um administrador não pode ser alterado por meio de uma importação. | Sim | — |
host_user_status | 0 as desativa e 1 as ativa novamente. | Não | Inalterado |
Qualquer coluna que contenha usuários adicionais, exceto a username | Substitui esse detalhe. | Não | Inalterado |
Um importador não pode alterar o endereço de e-mail, número de telefone ou tipo de usuário de ninguém. A linguagem e a zona horária são características pessoais da pessoa, uma vez que ela se torna parte do seu hub. Alterá-las aqui não afeta o que essa pessoa recebe.
Criar casos
| Coluna | O que faz | Obrigatório | Padrão |
|---|---|---|---|
ref_id | O ID do caso é composto por letras, números, traços e barras. Esses caracteres são escritos em minúsculas. Um ID de caso diferente também não consegue passar no teste. | Sim | — |
title | O título do caso | Sim | — |
case_type | Um dos seus hubs Tipos de casosTipo de caso Uma categoria para casos, como "geral", usada para direcionar automações aos casos corretos., Escrito da seguinte forma: Configurações › Campos | Não | general |
case_status | 1 para aberto, 0 para fechado. | Não | 1 |
date_opened | A data em que o caso foi iniciado | Não | Hoje |
description | Descrição do caso | Não | Nenhum |
case_stage | O “id” da sua etapaEstágio Uma etapa pela qual um caso passa, como Entrada ou Envio de Demanda, que a empresa nomeia e descreve e que aparece na página do caso., copiado do seu ID da etapa em Configurações › Etapas | Não | Nenhuma fase |
hidden_modules | Seções a serem ocultadas neste caso, separadas por vírgulas, como invoices,notes: qualquer uma das case, convos, events, forms, signs, invoices, notes, tasks e team | Não | Nenhum escondido. |
Modificar casos
| Coluna | O que faz | Obrigatório | Padrão |
|---|---|---|---|
case_id | A necessidade de mudança | Sim | — |
title, description, case_status, date_opened | Quanto à opção “Criar casos”, trata-se de substituir o conteúdo que já existe no caso. | Não | Inalterado |
case_type | Um dos tipos de casos do seu hub, ou o próprio tipo de caso, mesmo que você tenha removido esse tipo de caso das suas configurações. | Não | Inalterado |
case_stage | O movimento leva o caso para aquela fase. Um importador não pode retirar um caso de sua fase correspondente. | Não | Inalterado |
hidden_modules | Substitui as seções que estão ocultas no caso. Uma importação não pode mostrar todas essas seções novamente. | Não | Inalterado |
O ID da etiqueta do caso não pode ser alterado.
Atribua usuários a casos
| Coluna | O que faz | Obrigatório | Padrão |
|---|---|---|---|
case_id | O caso | Sim | — |
user_id | A pessoa a ser adicionada | Sim | — |
case_role_id | O papel deles no caso, como por exemplo clients, com ou sem role::. | Sim | — |
case_notify | true envia-lhes a convocatória para participar do caso. | Sim | — |
client_designation | No papel do cliente: primary ou guardian | Não | primary |
staff_designation | No papel de funcionário ou em algum dos seus próprios cargos: primary, attorney, paralegal, case_manager, lead_attorney ou lead_paralegal | Não | primary |
Preencha a coluna correspondente ao papel da linha em questão. Deixe as outras colunas vazias ou insira primary/guardian nas linhas que representam funções ou designações de funcionários. Se alguém já estiver envolvido no caso, se o caso já contiver 20 pessoas, ou se o caso já foi resolvido, essa linha também não será preenchida.
Criar postagens de caso
| Coluna | O que faz | Obrigatório | Padrão |
|---|---|---|---|
case_id | O caso | Sim | — |
user_id | De quem é a publicação: alguém que está envolvido no caso e cujo papel é criar publicações, como parte do pessoal responsável pelo caso. | Sim | — |
message | O texto da publicação | Sim | — |
permissions | Os personagens que podem ver isso, como por exemplo role::staff | Não | Todos envolvidos no caso |
Cada post informa as pessoas sobre o que foi adicionado por aquela pessoa. Uma linha para um caso fechado não funciona.
Remover usuários atribuídos a casos
| Coluna | O que faz | Obrigatório | Padrão |
|---|---|---|---|
case_id | O caso | Sim | — |
user_id | A pessoa que deve removê-lo. | Sim | — |
Quem não está envolvido no caso falha na competição.