Resumo feito por IA verificado ◀▼
Administradores podem importar dados de usuários em massa usando um arquivo CSV para adicionar ou atualizar informações do usuário, incluindo funções e associações à organização. Antes de importar, assegure-se de que as importações de dados estejam ativadas e que as organizações sejam importadas primeiro. Atente para as limitações, como o limite máximo de 2.000 linhas por arquivo e a impossibilidade de importar determinados tipos de dados. Considere as configurações de e-mail de boas-vindas para gerenciar as notificações enviadas a novos usuários.
O Zendesk recomenda usar o importador de dados para importar dados de usuários, em vez da página legada Ações em massa, descrita neste artigo. No entanto, se preferir, você ainda pode usar a página Ações em massa para importar informações novas ou atualizadas de usuários.
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 (legado)
Existem diversas limitações e considerações que você deve analisar antes de importar usuários em massa.
Limitações da importação em massa de usuários e organizações (legado)
Você pode importar um conjunto principal de dados sobre os usuários e as organizações. Por exemplo, você pode importar os dados descritos na tabela a seguir. No entanto, não é possível importar fusos horários, fotos, preferências de idioma e outros dados. 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.
- Ao usar as páginas de ações em massa, 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.
- 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 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.
Como os dados são atualizados pela importação de ações em massa (legado)
- name
- external_id
- role
- restriction
- organization
- custom fields
- tags (somente ao usar o importador de dados)
- details
- notes
- tags
- phone (adicionado como número de telefone secundário)
- email (adicionado como endereço de e-mail secundário)
Considerações sobre o envio de um e-mail para usuários importados em massa (legado)
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 (legado)
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.
- 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 exceções, consulte Como os dados são atualizados pela importação de ações em massa.
- 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. |
| Obrigatório para importar novos usuários. Endereço de e-mail completo do usuário (algumusuário@minhaempresa.com). O campo de e-mail aceita um valor em branco ou vazio. Ainda que o campo de e-mail esteja em branco ou vazio, o sistema cria o perfil de usuário. | |
| 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: se você importar usuários com o campo external_id como o único identificador deles (ou seja, você não está incluindo também o endereço de e-mail), precisará incluir também o campo de e-mail no arquivo CSV vazio. 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. |
| phone | 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. Para funcionarem com o Zendesk, os números de telefone precisam estar no formato do padrão internacional E.164. |
| shared_phone_number | Se for um número de telefone compartilhado, defina como "true". Um número de telefone compartilhado não pode ser usado como identidade do usuário. |
| role | Diferenciação entre maiúscula e minúscula: End-user, Agent ou Admin. Se você não configurar uma função, o usuário será definido como End-user. |
| organization | 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. |
| 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. |
| brand | Se a conta tem diversas marcas, é possível especificar um subdomínio de marca. O subdomínio de marca que você especifica determina a marca do e-mail de boas-vindas enviado para o usuário, desde que a marca esteja ativa e tenha a central de ajuda ativada. Quando o subdomínio da marca especificado não está ativo, não tem uma central de ajuda ativada ou não existe, a coluna é ignorada e o e-mail de boas-vindas é enviado usando a marca padrão. Os subdomínios de marca diferenciam letras maiúsculas de minúsculas e devem ser uma correspondência exata para serem importados.
Especifique apenas o subdomínio da marca. Por exemplo, use meudomínio e não meudomínio.zendesk.com. |
| custom_fields.<chave de campo> | Ao realizar uma importação em massa de usuários, você pode importar um campo de usuário 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 As chaves de campo personalizado diferenciam maiúsculas e minúsculas e precisam ser inseridas em caixa baixa. Se você estiver 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 de uma importação de ações em massa para importar dados do usuário (legado)
Embora a Zendesk recomende o uso do importador de dados, você ainda pode usar as páginas de ações em massa para importar informações novas e atualizadas dos usuários.
- Na Central de administração, clique em Pessoas na barra lateral e selecione Ações em massa > Importar usuários.
- Selecione as opções de importação:
-
Criar novos usuários: essa opção é selecionada por padrão e não pode ser desmarcada. Isso ocorre porque os usuários listados no arquivo CSV que não existem na sua conta do Zendesk são sempre criados.
-
Atualizar usuários existentes: selecione essa opção de importação se você também quiser modificar dados de usuários existentes.
É necessário incluir um external_id ou endereço de e-mail para cada usuário no arquivo CSV para que eles possam ser identificados. Além dos campos de identificação do usuário, inclua apenas os campos que deseja atualizar no arquivo CSV. Se você não inserir o valor de um campo em seu arquivo CSV, esse valor será substituído para o usuário existente.
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: se você não quiser adicionar novos usuários, use o importador de dados. Ao usar as páginas de ações em massa, se o seu arquivo CSV contiver informações sobre novos usuários, eles sempre serão adicionados, independentemente da opção de importação selecionada. -
- (Opcional) Selecione Incluir ID externa no arquivo CSV de saída?.
Quando o processo de importação estiver concluído, você receberá uma notificação por e-mail que inclui um link para um arquivo de resultados da importação CSV separado. Use esse link para baixar o arquivo e visualizar os resultados da importação. O arquivo mostra o status dos dados do usuário que você tentou importar (Created, Updated, Failed, Unchanged). Se você selecionar essa opção, o relatório incluirá o endereço de e-mail ou um ID externo para cada usuário criado ou atualizado.
Se você não selecionar essa opção, os IDs externos serão apagados do arquivo de resultados da importação CSV. Nesse caso, apenas o endereço de e-mail do usuário será listado para cada usuário criado ou atualizado.
- Clique em uma das seguintes opções: Selecionar arquivo ou Deixe-me colar os dados.
- Clique em Importar.
A importação é adicionada à fila e os usuários são adicionados ao Zendesk Support quando o processo de importação é concluído. Você receberá um e-mail quando a importação for concluída.