Importação em massa de organizações

Atenção: atualmente, o importador de dados está na versão beta aberta. A página Importar organizações na Central de administração continuará disponível nessa versão.

Em vez de adicionar uma organização por vez, você pode adicionar várias organizações em massa importando um arquivo CSV (valores separados por vírgula). Também é possível usar a importação em massa para adicionar e atualizar organizações. Você deve ser um administrador para fazer importação em massa de organizações. Você pode adicionar ou atualizar vários usuários de uma só vez (consulte Importação em massa de usuários).

Observação: se você quiser importar tanto usuários quanto organizações em massa, deve importar primeiro as organizações. Para obter informações sobre a importação em massa de usuários, consulte Importação em massa de usuários.

A importação em massa de organizações não pode ser desfeita. Antes de importar o arquivo CSV que contém as informações de todas as organizações, teste esse mesmo arquivo CSV com um registro de uma única organização para se certificar de que o carregamento executará as tarefas pretendidas.

Este artigo abrange as seguintes seções:

• Limitações da importação em massa de usuários e organizações
• Criação do arquivo de dados CSV da organização
• Importação do arquivo de dados CSV da organização

Limitações da importação em massa de usuários e organizações

Você pode importar um conjunto principal de dados sobre os usuários e as organizações. Com o recurso de importação em massa, você pode, por exemplo, importar os dados descritos na tabela a seguir; no entanto, não é possível importar fusos horários, fotos, preferências de idioma etc. Para importar dados não listados na tabela a seguir, use a REST API do Zendesk. Consulte Importação de usuários com a API do Zendesk ou Importação de organizações com a API do Zendesk.

Há também estas limitações para a importação em massa:

• O número máximo de linhas depende do método de importação.
  • Para dados do usuário e atualização de dados de organização existentes, o arquivo de importação de dados em CSV pode conter um máximo de 2.000 linhas. Ou seja, uma linha de cabeçalho e até 1.999 linhas de dados.
  • Para dados de novas organizações usando o importador de dados (beta), o arquivo CSV de importação não pode ultrapassar o tamanho de 1 GB. Recomendamos um máximo de 500.000 linhas. Ou seja, uma linha de cabeçalho e até 499.999 linhas de dados. Além disso, o tamanho de cada linha deve ser de até 128 KB.
• Ao usar o importador de dados, as seguintes limitações também se aplicam:
  • O arquivo CSV de importação deve ter, no máximo, 200 colunas.
  • O arquivo CSV de importação não garante a ordem de importação das linhas.
• Você só pode importar um arquivo CSV por vez. Portanto, se tiver mais dados do que o número máximo de linhas compatível com o arquivo CSV, você precisará criar arquivos separados para cada lote e importá-los um depois do outro. Quando o importador de dados não é utilizado, até dois lotes são enfileirados e executados em segundo plano. Se você quiser importar mais de dois lotes, precisará aguardar até que os primeiros lotes tenham sido importados.
• Você não pode usar a importação em massa para importar informações de contato de contas de usuários finais no Facebook ou no Twitter. Em vez disso, use a REST API do Zendesk. Consulte Importação de usuários com a API do Zendesk.

Criação do arquivo de dados CSV da organização

Para importar organizações em massa, você deve usar um arquivo de dados de organização em CSV. Esta seção discutirá como configurar seu arquivo de dados CSV.

Ao criar seu arquivo, é importante atender aos seguintes requisitos:

• O arquivo deve ser um CSV formatado adequadamente e salvo utilizando codificação de caracteres UTF-8.
• A primeira linha do arquivo CSV corresponde à linha do cabeçalho e você deve incluí-la no arquivo.
• A linha do cabeçalho deve conter os campos obrigatórios e os outros campos listados na tabela a seguir que você deseja incluir.
• Os campos incluídos devem aparecer na linha do cabeçalho na ordem que estiverem listados a seguir.
• Se você não está importando dados para um campo, não os liste na linha do cabeçalho.
• As colunas vazias de dados no arquivo substituirão todos os dados existentes da organização em questão.
• Adicione quebras de linha às observações ou aos campos personalizados multilinha pressionando ALT+ENTER no Windows ou CTRL+OPTION+RETURN no macOS.

A tabela a seguir lista os campos que podem ser incluídos no arquivo.

Tabela 1. Dados de importação da organização

Campo	Descrição
name	Obrigatório. O nome da organização.
external_id	Opcional, mas recomendável; obrigatório se você pretende usar o importador de dados para atualizar esses registros no futuro. Um valor de identificação exclusivo, como um número de identificação de funcionário ou cliente em um sistema externo.
notes	Observações sobre a organização. As observações são visíveis somente para os agentes e não para os usuários finais.
details	Informações detalhadas sobre a organização, como o endereço. As informações são visíveis somente para os agentes e não para os usuários finais.
default	Para o mapeamento dos usuários para uma organização. Insira um ou mais domínios de e-mail, separados por espaços (por exemplo, empresa1.com empresa2.com). Consulte Inclusão automática de usuários em organizações com base no domínio de e-mail.
shared	True ou False (Verdadeiro ou falso). Configura a organização como compartilhada. Consulte Configuração de uma organização compartilhada para os usuários finais.
shared_comments	True ou False (Verdadeiro ou falso). Permite que todos os usuários da organização adicionem comentários aos tickets dos outros. O campo “shared“ também deve ser configurado como true (verdadeiro). Consulte Configuração de uma organização compartilhada para os usuários finais.
group	Insira um grupo padrão para a organização. Consulte Mapeamento de um grupo a uma organização.
tags	Quando a marcação com tags de usuários e organizações tiver sido habilitada para o seu Zendesk Support (consulte Inclusão de tags em usuários e organizações), você poderá adicionar tags à organização. Separe cada tag com espaços.
custom_fields.<chave do campo>	Ao realizar uma importação em massa de organizações, você pode importar um campo de organização personalizado especificando a chave de campo e o prefixo custom_fields.  Por exemplo, para a chave de campo subscription_date, use o exemplo a seguir para definir os valores importados para esse campo. custom_fields.subscription_date para localizar a chave de um campo de organização personalizado, clique no ícone Admin. () e, em seguida, clique no nome de um campo personalizado em Campos de organização. A chave de campo é exibida no painel de propriedades à direita. Se o valor de um campo não estiver formatado corretamente, a importação falhará e você receberá um relatório de erros especificando quais registros não puderam ser salvos. Para campos de data personalizados, use os formatos AA/MM/DD ou AAAA-MM-DD. Para os campos de caixa de seleção, use Verdadeiro ou Falso. Para definir o valor das opções de lista suspensa, use a tag que você adicionou ao criar a lista suspensa. Observação: se o campo personalizado da organização que você está importando for o campo de relacionamento de pesquisa, insira a ID do objeto relacionado como o valor para esse campo. Por exemplo, para uma organização, digite a ID da organização; já para um usuário, a ID do usuário. Para encontrar o ID da organização ou do usuário, exporte os dados de sua conta ou use a Organizations API ou a Users API. Os campos de relacionamento de pesquisa não são compatíveis ao importar organizações na página Importador de dados. Consulte Inclusão de campos personalizados às organizações.

Importação do arquivo de dados CSV da organização

Você pode usar a importação em massa para criar novas organizações ou atualizar as informações das organizações existentes.

Sua importação é adicionada à fila e as organizações são adicionadas ao seu Zendesk Support após a conclusão do processo de importação. Esse processo normalmente demora uma hora por arquivo para ser concluído, mas também depende do tamanho do arquivo e da fila. Consulte Limitações da importação em massa de usuários e organizações.

Uso do importador de dados para criar novas organizações (beta)

O importador de dados está na versão beta. Você pode usá-lo para importar um arquivo CSV que cria novas organizações e captura registros de todas as tentativas de importação por meio da página Importador de dados. Na versão beta, o importador de dados não pode ser usado para atualizar dados de organizações existentes.

Como criar novas organizações com o importador de dados

1. Na Central de administração, clique em Objetos e regras na barra lateral e selecione Ferramentas > Importador de dados.
2. Clique em Importar.
3. Em Carregamento de arquivo, arraste e solte o arquivo ou clique para carregar e selecione o arquivo CSV no explorador de arquivos.

   Se precisar alterar o arquivo selecionado, clique no ícone de apagar () ao lado do nome do arquivo.

4. Clique em Next.
5. Analise a lista Mapeamento de campos.
   • Se o mapeamento de campos estiver correto, clique em Avançar.
   • Se o mapeamento de campos não estiver correto, clique em Voltar. Edite o arquivo CSV para ficar de acordo com os requisitos de formato e, em seguida, recarregue o arquivo.
6. Analise o resumo de detalhes da importação na janela de confirmação e clique em Começar a importação.

   Após o início da importação, as alterações importadas não podem ser revertidas. Para verificar o status de uma importação, confira o histórico de importações.

Uso de uma importação de CSV para atualizar dados de uma organização existente

A página Importador de dados só pode ser usada para criar novas organizações por meio de uma importação de CSV na versão beta. Se você precisar usar uma importação de CSV para atualizar organizações existentes, deve utilizar a página Central de administração > Pessoas > Ações em massa > Importar organizações. Você também pode usar essa página para criar novas organizações. Você receberá um e-mail quando a importação for concluída.

Como atualizar organizações com uma importação de CSV

1. Na Central de administração, clique em Pessoas na barra lateral e selecione Ações em massa > Importar organizações.
2. Escolha o tipo de importação que deseja realizar:

   • Criar novas organizações

   • Atualizar organizações existentes: use esse tipo de importação para substituir os dados existentes de organizações listadas em seu arquivo CSV. Você precisa incluir apenas os campos que deseja atualizar no arquivo. Colunas vazias de dados substituirão os dados existentes da organização em questão.

3. Clique em Selecionar arquivo ou no link Deixe-me colar os dados.
4. Clique em Importar.

   Após o início da importação, as alterações importadas não podem ser revertidas.

5. (Opcional) Visualize o status de importações em andamento na página Central de administração > Objetos e regras > Ferramentas > Importador de dados. Após a conclusão, a importação é capturada no registro do histórico de importações na página Importador de dados.