Resumo: ◀▼
Você pode fazer importação em massa ou atualizar diversas organizações usando um arquivo CSV, economizando tempo em comparação com a adição individual de cada uma. O arquivo CSV deve seguir regras de formatação e limites de tamanho específicos, e você precisa ser um administrador para realizar importações. O processo oferece suporte a dados organizacionais principais e campos personalizados, mas apresenta limitações como a ausência de garantia de ordem de importação e a proibição de entradas duplicadas em um mesmo arquivo. Os registros do histórico de importações acompanham o progresso.
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 com o importador de dados
Você pode importar um conjunto principal de dados sobre os usuários e as organizações. 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.
- Ao usar o importador de dados, o arquivo CSV de importação deve ter um tamanho máximo de até 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.
- 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.
- Não é possível usar a importação em massa para importar informações de contato de contas de usuários finais do Facebook ou do X (antigo 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, use um arquivo de dados CSV da organização. Esta seção explica como configurar seu arquivo de dados CSV.
- O arquivo deve ser um CSV formatado adequadamente e salvo usando 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. |
| 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. Use esse campo em vez do cabeçalho padrão ao utilizar o importador de dados. |
| domain_names | Os nomes de domínio da organização para mapeamento de usuários. Se você estiver incluindo mais de um nome de domínio para uma organização, faça a separação com um caractere de barra vertical (|). |
| group_id | 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 ativada para o Zendesk Support, você poderá definir tags para a organização. Separe cada tag com uma barra vertical ( | ). 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> | 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, consulte Localização da chave ou do ID de um campo personalizado. 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.
|
Importação de organizações com o importador de dados
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.
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.
- 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ção.
- Em Opções de importação, selecione uma das seguintes opções:
- Criar apenas registros: somente novas organizações são criadas. Os dados no arquivo CSV relativos a organizações existentes são ignorados.
- Atualizar apenas registros: 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 registros: 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 Avançar.
- 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.