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ê também pode adicionar ou atualizar vários usuários e vários registros de objetos personalizados de uma só vez.
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 funcionará como esperado.
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.
- O número máximo de linhas depende do método de importação.
- Ao usar as páginas de ações em massa para importar dados novos e existentes de usuários e organizações, o arquivo de dados CSV para importação pode conter, no máximo, 2.000 linhas. Ou seja, uma linha de cabeçalho e até 1.999 linhas de dados.
- Quando o importador de dados é usado para importar dados novos e existentes de usuários e organizações, o arquivo CSV para 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.
- Não inclua o mesmo usuário ou a mesma organização mais de uma vez em um arquivo CSV. Isso pode causar falha na importação.
- Não há garantia de que os registros são criados ou atualizados na ordem em que são exibidos no arquivo CSV.
- 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 X (anteriormente 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.
- O arquivo deve ser um CSV formatado adequadamente e salvo utilizando codificação de caracteres UTF-8.
- A primeira linha do arquivo CSV é a linha do cabeçalho.
- A linha do cabeçalho deve conter os campos obrigatórios e os outros campos listados na tabela a seguir que você deseja incluir.
- Na linha do cabeçalho, use domain_names ou default, dependendo do seu método de importação. Essas duas opções não podem ser usadas em conjunto.
- 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.
| 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. |
| domain_names (apenas com importador de dados) |
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. Use em vez do cabeçalho default ao utilizar o importador de dados. |
| default (sem importador de dados) |
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). Use em vez do cabeçalho domain_names quando não estiver utilizando o importador de dados. 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á definir tags para a organização. Separe cada tag com espaços. Ao fazer a importação em massa de organizações, as tags em seu arquivo CSV substituem as tags atuais das organizações. Para que isso não aconteça, considere usar a API de tags para atualizar as tags. |
| organization_fields.<chave de campo> (apenas com importador de dados) |
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 organization_fields. Por exemplo, para a chave de campo subscription_date, use o exemplo a seguir para definir os valores importados para esse campo. organization_fields.subscription_date para localizar a chave de um campo de organização personalizado, clique no ícone Admin. ( Se o valor de um campo não for formatado corretamente, a importação falhará e você verá os detalhes do erro no registro do histórico de importações. 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 do campo de lista suspensa, use a tag que você adicionou ao criar a lista suspensa.
Observação: Os campos de relacionamento de pesquisa não são compatíveis ao importar organizações na página Importador de dados.
|
| custom_fields.<chave do campo> (sem importador de dados) |
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. ( Se o valor de um campo não estiver formatado corretamente, a importação falhará e você receberá por e-mail 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 o ID da organização; para um usuário, insira o ID do usuário; para um registro de objeto personalizado, insira o ID do registro. Para encontrar o ID de uma organização, um usuário ou registro de objeto personalizado, você pode exportar dados de sua conta ou usar a Organizations API, a Users API ou a Custom Object Records API.
Os campos de relacionamento de pesquisa não são compatíveis ao importar organizações na página Importador de dados. |
) 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.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 importar dados de organizações
Você pode usar o importador de dados para importar um arquivo CSV que cria novas organizações, ou atualiza as existentes, e captura registros de todas as tentativas de importação por meio da página Importador de dados.
- Na Central de administração, clique em
Objetos e regras na barra lateral e selecione Ferramentas > Importador de dados. - Clique em Importar.
- Em Alvo desejado, selecione Organizações.
- Em Tipo de importação, escolha uma destas opções:
- Apenas criar: somente novas organizações são criadas. Os dados no arquivo CSV relativos a organizações existentes são ignorados.
- Apenas atualizar: substitui os dados das organizações existentes listadas no arquivo CSV. O external_id é obrigatório para atualizar organizações. Os dados relativos a novas organizações são ignorados.
- Criar e atualizar: cria novas organizações e atualiza os dados das organizações existentes listadas no arquivo CSV.
- 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. - Clique em Next.
- 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.
- 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 ações em massa para importar dados da organização
Recomendamos usar o importador de dados, mas você ainda pode usar as páginas de ação em massa para importar dados novos e existentes de organizações. Você receberá um e-mail quando suas importações dessa página forem concluídas.
- Na Central de administração, clique em
Pessoas na barra lateral e selecione Ações em massa > Importar organizações. - 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.
O external_id e ou nome das organizações precisam ser incluídos no CSV para que possam ser identificadas. Além de um campo identificador das organizações, você só precisa incluir os campos que deseja atualizar no arquivo. Se a linha de uma organização tiver um campo em branco, ele substituirá os dados existentes dessa organização.
-
- Clique em Selecionar arquivo ou no link Deixe-me colar os dados.
- Clique em Importar.
Após o início da importação, as alterações importadas não podem ser revertidas.
- (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.