Resumo feito por IA verificado ◀▼
Os administradores podem fazer a importação em massa de dados do usuário usando um arquivo CSV para adicionar ou atualizar usuários e definir funções e privilégios. Antes de importar, assegure-se de que as importações de dados estejam ativadas e que as organizações sejam importadas primeiro. Considere os limites de tamanho de arquivo, as atualizações de dados e as notificações por e-mail. Use a ferramenta de importação de dados para gerenciar importações, garantir o mapeamento correto de campos e revisar detalhes da importação.
Os administradores podem adicionar muitos usuários em uma importação em massa em vez de adicionar usuários manualmente, um de cada vez. Para fazer isso, crie um arquivo CSV (valores separados por vírgula) que contenha os dados dos usuários. Além dos dados essenciais do usuário, como endereço de e-mail e número de telefone, você também pode definir funções de usuário, privilégios de um agente e adicionar usuários a uma organização. Você pode usar a importação em massa para adicionar novos usuários ou atualizar os existentes. A importação em massa por arquivo CSV funciona apenas para usuários e funções do Support.
Você deve ser um administrador para fazer importação em massa de usuários e organizações.
- Para proteger os dados na sua conta do Zendesk, as importações de dados são desativadas por padrão. O responsável pela conta ou o administrador deve entrar em contato com o Suporte ao cliente Zendesk para ativar as exportações de dados e o acesso à página de importações.
- Se você quiser importar tanto usuários quanto organizações em massa, importe as organizações primeiro.
Considerações para importação em massa de usuários
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.
Atualização dos dados do perfil de usuário existente
Como os dados são atualizados pelo importador de dados
- phone (adicionado como número de telefone secundário)
- email (adicionado como endereço de e-mail secundário)
Todos os outros dados são substituídos pelo importador de dados.
Considerações sobre o envio de um e-mail para usuários importados em massa
Antes de fazer uma importação em massa de usuários, é importante verificar as configurações em seu e-mail de boas-vindas. Quando você adiciona novos usuários por meio de uma importação em massa enquanto o Guide está ativado, cada usuário recebe a mensagem de e-mail de boas-vindas. O e-mail de boas-vindas contém um link para a confirmação dos seus endereços de e-mail, que solicita que eles selecionem uma senha e façam o acesso. Você pode impedir que o e-mail de boas-vindas seja enviado a esses usuários.
Como evitar o envio da mensagem de e-mail de boas-vindas para os usuários
- Na Central de administração, clique em
Pessoas na barra lateral e selecione Configuração > Usuários finais. - Na seção E-mail de boas-vindas ao usuário, desmarque Também enviar um e-mail de confirmação quando um novo usuário for criado por um agente ou administrador.
- Clique em Salvar.
Criação do arquivo CSV de dados do usuário
Quando cria uma lista de usuários para a importação, você provavelmente gera essa lista a partir de outro sistema de gerenciamento de usuários, como um banco de dados de funcionários. Muitos destes sistemas possuem um recurso de criação do arquivo de exportação CSV. Se você precisa criar a lista do zero, use um programa como o Microsoft Excel ou o OpenOffice.org Calc.
- Você pode baixar um modelo CSV na Central de administração > Importador de dados > Importar > Baixar um modelo CSV.
- 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 sem dados no arquivo substituirão a maioria de dados existentes do usuário em questão. Para saber quais são as exceções, consulte Atualização dos dados do perfil de usuário existente.
- 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. os campos de nome, e-mail e restrição são obrigatórios ao importar novos usuários. Ao atualizar usuários existentes pela importação em massa, é necessário apenas um identificador exclusivo (como um e-mail ou ID externa).
| Campo | Descrição |
|---|---|
| name | Obrigatório para importar novos usuários. Nome completo do usuário. |
| emails |
Obrigatório para importar novos usuários. Endereço de e-mail completo do usuário (algumusuário@minhaempresa.com). Se incluir mais de um endereço de e-mail para um usuário, separe-os por uma barra vertical (|). Por exemplo: first@yourcompany.com|second@yourcompany.com
|
| ticket_restriction |
Obrigatório para importar novos usuários. As restrições definem os privilégios do membro da equipe ou do usuário final, os tickets aos quais ele tem acesso e etc. Isso é necessário para importar novos usuários quando a função do usuário é definida como Agente. Em planos não Enterprise, os seguintes valores de restrição são compatíveis:
Os valores restritivos de organization e requested podem ser atribuídos quando a função do usuário está definida como "End-user". Todos os outros se aplicam apenas aos membros da equipe.
Observação: nos planos Enterprise, as funções de agente anulam as restrições de agente padrão. Isso significa que não é possível usar as restrições padrão listadas na tabela acima para importar ou atualizar um agente. Você deve especificar uma função de agente. Se você usar acidentalmente um nome de função que não existe no Zendesk Support, o agente é definido com a função padrão de agente light.
|
| external_id | Se você possui uma ID que não o endereço de e-mail do usuário (como ID do funcionário ou número de referência do cliente), pode incluí-la aqui. As IDs externas precisam ser exclusivas para cada usuário, senão os dados serão sobrescritos. Se precisar configurar vários endereços de e-mail ou números de telefone para um único usuário, você pode fazer isso criando várias entradas para o usuário no arquivo CSV e usando a mesma coluna external_id para todas as linhas que quer associar a um único usuário. Com exceção dos números de telefone ou e-mail adicionais, os valores em todas as outras colunas devem permanecer os mesmos para cada linha. Se qualquer ID externo, endereço de e-mail ou número de telefone corresponder a mais de um usuário existente, essa linha será rejeitada da importação em massa.
Observação: quando você importa usuários com o campo external_id como o único identificador deles (ou seja, você não inclui o endereço de e-mail), é necessário incluir também o campo de e-mail no arquivo CSV sem nenhum dado. Por exemplo:
|
| details | Informações detalhadas sobre o usuário, como um endereço. As informações são visíveis somente para membros da equipe, e não para usuários finais. |
| notes | Observações sobre o usuário. As observações são visíveis somente para os membros da equipe e não para os usuários finais. |
| phones | Os números de telefone do usuário. Números de telefone exclusivos são adicionados como linhas diretas. Os números que já existem são adicionados como linhas secundárias. Se você estiver incluindo mais de um número de telefone para um usuário, separe os números com uma barra vertical (|). Para funcionarem com o Zendesk, os números de telefone precisam estar no formato do padrão internacional E.164. |
| shared_phone | O número de telefone compartilhado do usuário. Para funcionarem com o Zendesk, os números de telefone precisam estar no formato do padrão internacional E.164. |
| role | Diferenciação entre maiúscula e minúscula: End-user ou Agent. Se você não configurar uma função, o usuário será definido como End-user. |
| custom_role | Quando a função é definida como Agent, especifique o nome da função personalizada, conforme listado na página Funções na Central de administração. Light agent também é aceito. |
| skip_verify_email | Se você precisa criar usuários sem enviar um e-mail de verificação, defina este valor como true. |
| time_zone | Consiste em uma cadeia de caracteres, como "Eastern Time (US & Canada)". Para ver uma lista de nomes válidos, consulte o menu de lista de fusos horários na página Localização (Conta > Aparência > Localização) na Central de administração. Exemplo: Se o menu lista "(GMT+02:00) Berlin", use "Berlin" como o nome para time_zone. |
| locale | A localidade do usuário. Uma tag compatível com BCP-47 para a localidade (por exemplo, en-US). Quando locale e locale_id estão presentes, locale_id é ignorado e somente locale é usado. |
| locale_id | O identificador de idioma do usuário. |
| moderator | Booliano. Designa se o usuário tem recursos de moderação do fórum. |
| only_private_comments | Booliano. Quando definido como true, o usuário só pode criar comentários privados. |
| remote_photo_url | Uma URL direcionando para a foto do perfil do usuário. |
| signature | A assinatura do usuário. Somente agentes e administradores podem ter assinaturas. |
| suspended | Booliano. Indica se o usuário foi suspenso. Os tickets de usuários suspensos também são suspensos, e esses usuários não podem entrar no portal do usuário final. |
| alias | Um alias exibido aos usuários finais. |
| organizations | O nome da organização a qual o usuário será adicionado. A organização já deve existir, senão a importação falhará.
Nos planos Professional e Enterprise, é possível adicionar um usuário a várias organizações separando os nomes das organizações com uma barra vertical. Por exemplo: A organização padrão de um usuário é a primeira organização em ordem alfabética. Não é possível definir outra organização padrão durante uma importação em massa. No entanto, a organização padrão de um usuário pode ser ajustada manualmente ou com o ponto de extremidade Support API - Set Membership as Default. |
| default_group_id |
Novos membros da equipe (administradores e agentes) são adicionados automaticamente ao grupo padrão da conta. No entanto, você pode usar este campo para especificar grupos padrão alternativos para os usuários durante importações em massa. Usuários finais não podem ser adicionados a grupos. |
| tags | É possível adicionar tags de usuários quando a marcação com tags de usuários e organizações está ativada para o Zendesk Support (consulte Inclusão de tags em usuários e organizações). Separe cada tag com uma vírgula. |
| custom_fields.<chave de campo> | Ao executar uma importação em massa de usuários, você pode importar um campo de usuário personalizado especificando o prefixo custom_fields. e a chave de campo. Por exemplo, para a chave de campo custom_fields.subscription_date As chaves de campo personalizado diferenciam maiúsculas de minúsculas e precisam ser inseridas em letras minúsculas. Se você está importando informações para uma caixa de seleção, insira true para marcá-la ou false para deixá-la desmarcada. Para definir o valor das opções de lista suspensa, use a tag que você adicionou ao criar a lista suspensa. Para campos de data personalizados, use os formatos AA/MM/DD ou AAAA-MM-DD. Para localizar a chave de um campo de usuário personalizado:
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.
Observação: se o campo de usuário personalizado 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.
|
Uso do importador de dados para importar dados do usuário
Você pode usar o importador de dados para importar um arquivo CSV que cria ou atualiza usuários 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 Usuários.
- Em Tipo de importação, escolha uma destas opções:
- Apenas criar: somente novos usuários são adicionados. Todos os dados no arquivo CSV relativos a usuários existentes são ignorados.
- Apenas atualizar: atualize os dados dos usuários existentes listados em seu arquivo CSV. O external_id é obrigatório para atualizar usuários. Quaisquer dados relativos a novos usuários são ignorados.
- Criar e atualizar: adicione novos usuários e atualize os dados dos usuários existentes listados em seu arquivo CSV.
Observação: Se qualquer ID externo, endereço de e-mail ou número de telefone corresponder a mais de um usuário existente, essa linha será rejeitada da importação em massa. Verifique seu histórico de importações. - 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.