Importação em massa de organizações

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 arquivo de dados CSV de importação não deve conter mais que 2.000 linhas de dados (uma linha para o cabeçalho e o restante para os dados de usuário ou organização).
• Você pode importar apenas um arquivo CSV de 2.000 ou menos linhas de dados por vez. Portanto, se você possui mais de 1.999 usuários ou organizações para importar, precisa criar arquivos separados para cada lote e importá-los um por um. Um máximo de dois lotes pode ser enfileirado e importado 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 Mac.

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	Se você tem uma ID exclusiva de identificação, que não o nome da organização, você pode incluí-la aqui.
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. 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 os prefixos e a chave de campo dos 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 erro especificando quais registros não puderam ser salvos. Para campos de data personalizados, use os formatos AA/MM/DD ou AAAA-MM-DD. 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 a ID da organização ou do usuário, você pode exportar dados de sua conta ou usar a Organizations API ou a Users API. Consulte Inclusão de campos personalizados às organizações.

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

Você pode importar novas organizações ou atualizar as informações das organizações existentes.

Como importar os dados CSV da organização

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 desejado:

   • 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. Se você tiver colunas vazias de dados, isso substituirá 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.

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. Você receberá um e-mail quando a importação for concluída.