Qual é o meu plano?
Suite, todas as versões Team, Growth, Professional, Enterprise ou Enterprise Plus
Support Team, Professional ou Enterprise
Caminho: Central de administração > Objetos e regras > Ferramentas > Importador de dados

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.

Importante:
  • 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.
Este artigo contém as seguintes seções:
  • Importação em massa de usuários com o importador de dados
  • Importação em massa de usuários (legado)

Importação em massa de usuários com o importador de dados

O importador de dados fornece uma maneira consistente de importar usuários, organizações e objetos personalizados, além de ser a ferramenta recomendada para isso.

Consulte os tópicos a seguir:
  • Considerações para importação em massa de usuários
  • Criação do arquivo CSV de dados do usuário
  • Uso do importador de dados para importar dados do usuário

Considerações para importação em massa de usuários

Há uma série de limitações e considerações que você deve analisar antes de importar usuários em massa:
  • Limitações da importação em massa com o importador de dados
  • Atualização dos dados do perfil de usuário existente
  • Considerações sobre o envio de um e-mail para usuários importados em massa

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. 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 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.

  • 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.
  • 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.

Atualização dos dados do perfil de usuário existente

Ao fazer uma importação em massa, você pode atualizar os usuários existentes. Note que alguns dados são substituídos, enquanto outros são apenas anexados aos dados existentes.
Observação: para atualizar um usuário existente, o arquivo CSV precisa incluir o external_id ou o endereço de e-mail do usuário para que o Zendesk consiga identificá-lo.
Como os dados são atualizados pelo importador de dados
Ao usar o importador de dados, apenas os seguintes dados do usuário são anexados (adicionados aos dados existentes):
  • 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

  1. Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Usuários finais.
  2. 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.

  3. Clique em Salvar.

Criação do arquivo CSV de dados do usuário

Ao criar uma lista de usuários para a importação, você provavelmente gerará 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ê deseja criar uma lista do zero, pode usar um programa como o Microsoft Excel ou OpenOffice.org Calc.

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 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.
Observação: o Microsoft Excel não salva seu arquivo imediatamente. Para salvar seu arquivo, carregue-o no Google Sheets, baixe-o novamente e depois carregue-o no Zendesk. Como opção, você pode usar o Open Office para salvar o arquivo.

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).

Tabela 1. Dados de importação de usuário
Campo Descrição
name Obrigatório para importar novos usuários. Nome completo do usuário.
email 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 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:
  • assigned: o membro da equipe pode acessar apenas os tickets atribuídos a ele.
  • groups: o membro da equipe pode acessar apenas os tickets no(s) grupo(s) dele. Observação: para adicionar um membro da equipe a um grupo, consulte Visualização e gerenciamento da associação a grupos de membros da equipe ou use a API do Support.
  • none: o usuário não tem restrições e pode acessar todos os tickets.
  • organization: o usuário pode acessar apenas os tickets solicitados por ele ou por outros usuários na organização.
  • requested: o usuário pode acessar apenas os próprios tickets. Ele deve ser listado como o solicitante do ticket.
  • (sem importador de dados) Light Agent: o usuário tem as mesmas restrições de um agente light.
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 deseja 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 o endereço. As informações são visíveis somente para os membros da equipe e não para os 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 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, Agent ou Admin. Se você não configurar uma função, o usuário será definido como End-user.
organizations O nome da organização a qual o usuário será adicionado. A organização já deve existir ou 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: Organization1|Organization2|Organization3

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 Você poderá adicionar tags de usuários 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). Separe cada tag com uma vírgula.
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:
  • Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Campos do usuário. Em seguida, clique no nome do campo personalizado. 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.

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.

Como adicionar ou atualizar usuários com o importador de dados
  1. Na Central de administração, clique em Objetos e regras na barra lateral e selecione Ferramentas > Importador de dados.
  2. Clique em Importar.
  3. Em Alvo desejado, selecione Usuários.
  4. 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.
  5. 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.

  6. Clique em Avançar.
  7. 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.
  8. 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.

Importação em massa de usuários (legado)

Se por qualquer motivo você não está usando o importador de dados, utilize as informações neste tópico:
  • Considerações para importação em massa de usuários (legado)
  • Criação do arquivo CSV de dados do usuário
  • Uso de uma importação de ações em massa para importar dados do usuário (legado)

Considerações para importação em massa de usuários (legado)

Limitações da importação em massa de usuários (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 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.

  • 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.
  • 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.

Como os dados são atualizados pelas ações de importação em massa

Ao usar a página de ações em massa legada para importar dados do usuário, os seguintes dados do usuário são substituídos:
  • name
  • external_id
  • role
  • restriction
  • organization
  • custom fields
  • tags (somente ao usar o importador de dados)
Os dados do usuário a seguir são anexados (adicionados aos dados existentes):
  • 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

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

  1. Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Usuários finais.
  2. 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.

  3. Clique em Salvar.

Criação do arquivo CSV de dados do usuário

Ao criar uma lista de usuários para a importação, você provavelmente gerará 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ê deseja criar uma lista do zero, pode usar um programa como o Microsoft Excel ou OpenOffice.org Calc.

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 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.
Observação: o Microsoft Excel não salva seu arquivo imediatamente. Para salvar seu arquivo, carregue-o no Google Sheets, baixe-o novamente e depois carregue-o no Zendesk. Como opção, você pode usar o Open Office para salvar o arquivo.

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).

Tabela 2. Dados de importação de usuário
Campo Descrição
name Obrigatório para importar novos usuários. Nome completo do usuário.
email Obrigatório para importar novos usuários. Endereço de e-mail completo do usuário (algumusuário@minhaempresa.com).
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 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:
  • assigned: o membro da equipe pode acessar apenas os tickets atribuídos a ele.
  • groups: o membro da equipe pode acessar apenas os tickets no(s) grupo(s) dele. Observação: para adicionar um membro da equipe a um grupo, consulte Visualização e gerenciamento da associação a grupos de membros da equipe ou use a API do Support.
  • none: o usuário não tem restrições e pode acessar todos os tickets.
  • organization: o usuário pode acessar apenas os tickets solicitados por ele ou por outros usuários na organização.
  • requested: o usuário pode acessar apenas os próprios tickets. Ele deve ser listado como o solicitante do ticket.
  • (sem importador de dados) Light Agent: o usuário tem as mesmas restrições de um agente light.
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 deseja 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 o endereço. As informações são visíveis somente para os membros da equipe e não para os 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 ou 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: Organization1|Organization2|Organization3

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 Você poderá adicionar tags de usuários 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). 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:
  • Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Campos do usuário. Em seguida, clique no nome do campo personalizado. 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.

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 seja recomendável usar o 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.

Como importar os dados do usuário CSV
  1. Na Central de administração, clique em Pessoas na barra lateral e selecione Ações em massa > Importar usuários.
  2. 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. Consulte Atualização dos dados do perfil de 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, deverá usar 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.
  3. (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 (Criado, Atualizado, Ignorado). 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.

  4. Clique em uma das seguintes opções: Selecionar arquivo ou Deixe-me colar os dados.
  5. Clique em Importar.

Sua importação é adicionada à fila e os usuários são adicionados ao seu Zendesk Support quando o processo de importação é concluído. Você receberá um e-mail quando a importação for concluída.

Powered by Zendesk