Central de ajudaCasos e admissão

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, como role::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

ColunaO que fazObrigatórioPadrão
usernameO 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_nameNome próprioSim—
family_nameSobrenomeSim—
localeLíngua: ar, de, en, es, fr, id, it, ja, pl, pt, ru ou zhNãoen
zoneinfoFuso horário, como America/New_YorkNãoUS/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ãoNenhum
host_default_roleO 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ãoNenhum
host_staff_designationAs designações habituais de seus funcionários são: primary, attorney, paralegal, case_manager, lead_attorney ou lead_paralegal.Nãoprimary
birthdateData de nascimentoNãoNenhum
genderMale ou FemaleNãoNenhum
address1, address2, locality, region, postal_codeEndereço: segunda linha, cidade, estado e CEPNãoNenhum
countryCódigo de país de dois caracteres, como USNãoNenhum
company, titleEmpresa e cargoNãoNenhum
host_create_casetrue permite que eles criem casos, como Pode criar um caso na opção “Editar Usuário”.Nãofalse
host_add_case_userOs papéis que eles podem usar para adicionar pessoas a um caso, como Pode adicionar um usuário de caso comoNãoNenhum
host_remove_case_usertrue permite que eles removam pessoas de um caso, assim como Pode remover um usuário de casoNãofalse

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

ColunaO que fazObrigatórioPadrão
user_idA pessoa que precisa ser alterada… Um administrador não pode ser alterado por meio de uma importação.Sim—
host_user_status0 as desativa e 1 as ativa novamente.NãoInalterado
Qualquer coluna que contenha usuários adicionais, exceto a usernameSubstitui esse detalhe.NãoInalterado

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

ColunaO que fazObrigatórioPadrão
ref_idO 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—
titleO título do casoSim—
case_typeUm 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 › CamposNãogeneral
case_status1 para aberto, 0 para fechado.Não1
date_openedA data em que o caso foi iniciadoNãoHoje
descriptionDescrição do casoNãoNenhum
case_stageO “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 › EtapasNãoNenhuma fase
hidden_modulesSeçõ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 teamNãoNenhum escondido.

Modificar casos

ColunaO que fazObrigatórioPadrão
case_idA necessidade de mudançaSim—
title, description, case_status, date_openedQuanto à opção “Criar casos”, trata-se de substituir o conteúdo que já existe no caso.NãoInalterado
case_typeUm 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ãoInalterado
case_stageO movimento leva o caso para aquela fase. Um importador não pode retirar um caso de sua fase correspondente.NãoInalterado
hidden_modulesSubstitui as seções que estão ocultas no caso. Uma importação não pode mostrar todas essas seções novamente.NãoInalterado

O ID da etiqueta do caso não pode ser alterado.

Atribua usuários a casos

ColunaO que fazObrigatórioPadrão
case_idO casoSim—
user_idA pessoa a ser adicionadaSim—
case_role_idO papel deles no caso, como por exemplo clients, com ou sem role::.Sim—
case_notifytrue envia-lhes a convocatória para participar do caso.Sim—
client_designationNo papel do cliente: primary ou guardianNãoprimary
staff_designationNo papel de funcionário ou em algum dos seus próprios cargos: primary, attorney, paralegal, case_manager, lead_attorney ou lead_paralegalNãoprimary

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

ColunaO que fazObrigatórioPadrão
case_idO casoSim—
user_idDe 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—
messageO texto da publicaçãoSim—
permissionsOs personagens que podem ver isso, como por exemplo role::staffNãoTodos 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

ColunaO que fazObrigatórioPadrão
case_idO casoSim—
user_idA pessoa que deve removê-lo.Sim—

Quem não está envolvido no caso falha na competição.

Artigos relacionados

Importar clientes de um arquivo CSVAdicione vários clientes de uma só vez, carregando um arquivo CSV com seus nomes e endereços de e-mail ou números de telefone.Casos e admissão · 10 minImportar casos de um arquivo CSVCrie vários casos simultaneamente a partir de um arquivo CSV, contendo o ID da tag, o título, o tipo e o status de cada caso.Casos e admissão · 10 minAdicionar pessoas a casos em massaAtribua usuários existentes a vários casos simultaneamente a partir de um arquivo CSV, com suas respectivas funções, e escolha se cada um receberá um convite.Casos e admissão · 10 min