É necessário ser um administrador para exportar dados.
Ativação e desativação da exportação de dados
Quando a exportação de dados está ativada, os administradores em um domínio de e-mail específico podem exportar dados do Zendesk. O domínio de e-mail do responsável pela conta é usado como padrão, mas o responsável pela conta pode alterar o domínio se necessário.
- Entre em contato com o Suporte ao cliente Zendesk. Inclua o nome do subdomínio do seu Zendesk Support.
Como alterar o domínio de e-mail para que os administradores exportem dados
-
Na Central de administração, clique em
Conta na barra lateral e selecione Ferramentas > Relatórios.
Se necessário, clique na aba Exportar para exibir as opções de exportação de dados. Algumas versões legadas do Zendesk exibem as opções de exportação em uma aba separada.
Observação: você não verá essa opção de exportação, a menos que tenha entrado em contato conosco para ativar a exportação de dados. - Em Domínio de e-mail aprovado, substitua o domínio.
Por exemplo, minhaempresa.com.
Se você não colocar nenhum valor nesse campo, a capacidade de exportação de dados não ficará limitada a administradores com permissão em um domínio específico. Nesse caso, qualquer administrador do Zendesk Support poderá exportar dados, independentemente do domínio de seu e-mail. Se você incluir algum valor nesse campo, os administradores precisarão entrar usando o domínio de e-mail aprovado para terem a opção de exportação de dados.
- Clique em Salvar.
-
Na Central de administração, clique em
Conta na barra lateral e selecione Ferramentas > Relatórios.
Se necessário, clique na aba Exportar para exibir as opções de exportação de dados. Algumas versões legadas do Zendesk exibem as opções de exportação em uma aba separada.
- Clique em Desativar exportações.
- Clique em Ok para confirmar.
Exportação dos dados para um arquivo para download
É possível exportar dados para um arquivo JSON, CSV ou XML para obter um instantâneo dos dados no momento em que você selecionar essa opção.
Quando você solicitar um arquivo, um trabalho em segundo plano será iniciado e você será notificado por e-mail quando ele estiver concluído. Em seguida, você pode baixar um arquivo zip contendo os relatórios de dados. O link para download é válido por, no mínimo, três dias.
Quando os dados são exportados para um arquivo XML, o arquivo ZIP gerado é um arquivo ZIP32. No entanto, ao exportar os dados para um arquivo JSON ou CSV, o arquivo ZIP gerado será um arquivo ZIP64, que é usado para oferecer suporte para conjuntos de dados em formato JSON e CSV maiores que 4 GB. Consulte Anúncio da melhoria na exportação de grandes conjuntos de dados.
-
Na Central de administração, clique em
Conta na barra lateral e selecione Ferramentas > Relatórios.
Se necessário, clique na aba Exportar para exibir as opções de exportação de dados. Algumas versões legadas do Zendesk exibem as opções de exportação em uma aba separada.
Se você é um administrador em uma conta com a exportação de dados ativada e não vê essa opção, pode ser que você tenha restrições de domínio de e-mail configuradas e não esteja acessando de um domínio de e-mail aprovado.
- Selecione uma opção de exportação.
-
Para exportações JSON, selecione o intervalo de datas e o tipo de dado a ser exportado e clique em Exportar.
A exportação JSON é ideal para contas com mais de 200.000 tickets. As contas com mais de um milhão de tickets são baixadas em formato JSON apenas em incrementos de 31 dias.
- Para exportações CSV ou XML, clique em Solicitar arquivo ao lado da opção de exportação apropriada.
Para obter mais detalhes sobre as opções de exportação, consulte Noções básicas sobre as opções de exportação de dados.
-
Para exportações JSON, selecione o intervalo de datas e o tipo de dado a ser exportado e clique em Exportar.
- Um trabalho em segundo plano é iniciado e você é notificado por e-mail quando ele estiver concluído.
- Clique no link em sua notificação por e-mail para baixar o arquivo zip contendo o relatório.
O link para download é válido por, no mínimo, três dias.
Se você não receber a notificação por e-mail, clique em mais recente ao lado de Exportação JSON completa, Exportação CSV, Exportação XML completa ou Exportação XML do usuário para baixar o último relatório gerado. O relatório mais recente exibe os dados da sua conta com base no último arquivo recebido, mas não seus dados atuais de conta. Para obter mais informações, consulte Atrasos no recebimento de um e-mail com o arquivo de exportação de dados para download.
Noções básicas sobre as opções de exportação de dados
É possível solicitar e baixar cada um dos relatórios de dados a seguir:
Exportação JSON completa
exporta dados completos como uma lista de objetos em formato JSON. A exportação JSON permite exportar a maioria dos dados de sua conta Zendesk, incluindo as informações de ticket, usuário e organização. As contas com mais de um milhão de tickets são baixadas em formato JSON em incrementos de 31 dias.
O Zendesk exporta dados em "NDJSON" (JSON delimitado por nova linha). Esse formato permite que os sistemas transmitam um objeto JSON por vez, em vez de ler o arquivo inteiro de uma vez só. Isso é útil para arquivos de exportação extremamente grandes (como as exportações do Zendesk), que podem ser excessivos para um visualizador de JSON tradicional.
Mais informações sobre NDJSON.
-
Exemplo: o Support exportou os objetos a seguir:
{"ticket":{"id":....}} {"ticket":{"id":....}} {"ticket":{"id":....}}
Para criar um arquivo JSON válido, você encapsularia os objetos em uma matriz conforme a seguir:
Os intervalos de dados para essas exportações usam um carimbo de data/hora gerado pelo sistema. Em geral, esses carimbos de data/hora correspondem à atualização mais recente registrada do ticket, do usuário ou da organização (não à data de criação). Em alguns casos, as atualizações do sistema não geram eventos do ticket. Nesses casos, talvez você perceba alguns tickets inesperados na saída.{"tickets":[ {"ticket":{"id":....}}, {"ticket":{"id":....}}, {"ticket":{"id":....}} ]}
Com a exportação JSON, se o tamanho dos dados exportados de um ticket exceder 1 MB, os comentários do ticket não serão inclusos no arquivo JSON. O arquivo ZIP resultante que pode ser baixado inclui dois arquivos JSON:- Um arquivo JSON com todos os tickets exportados, incluindo tickets que excederem o limite de 1 MB, que são exportados sem comentários.
- Um arquivo JSON com os tickets que excederem o limite de 1 MB e uma mensagem de erro informando o motivo pelos quais os comentários não foram inclusos (excederam o limite de 1 MB). Por exemplo:
Exportação CSV
Com a exportação CSV, se o tamanho dos dados exportados exceder 1 MB, o ticket não é exportado. Ele não é incluído no arquivo CSV resultante. No entanto, normalmente, isso não acontece, porque as exportações CSV não incluem os comentários dos tickets, que normalmente são os maiores componentes de dados em um ticket.
Consulte Noções básicas sobre quais dados do ticket estão na exportação CSV para consultar os dados do ticket inclusos em exportações CSV.
Exportação XML completa
- Contas, todas as configurações da sua conta
- Entradas, todo o conteúdo adicionado aos seus fóruns (incluindo comentários). Esse é um recurso legado do Zendesk. Na maioria das contas, a exportação de dados não inclui entradas.
- Fóruns, são informações detalhadas sobre seus fóruns. Esse é um recurso legado do Zendesk. Na maioria das contas, a exportação de dados não inclui fóruns.
- Grupos, que são informações detalhadas sobre seus grupos
- Organizações, que são informações detalhadas sobre suas organizações
- Tickets, que são todos os detalhes (incluindo comentários) de todos os tickets
- Usuários, que é a lista de todos os seus usuários (usuários finais, agentes e administradores).
Exportação XML do usuário
- Grupos, que são informações detalhadas sobre seus grupos
- Organizações, que são informações detalhadas sobre suas organizações
- Usuários, que é a lista de todos os seus usuários (usuários finais, agentes e administradores).
Noções básicas sobre quais dados do ticket estão na exportação CSV
Os dados do ticket na exportação CSV incluem os dados exibidos na tabela a seguir. Os textos multilinha, os campos de seleção múltipla e os campos de data personalizados são apagados das exportações CSV, mas podem ser incluídos nas exportações JSON completa e XML.
Dados | Descrição |
---|---|
ID | O número do ticket. |
Requester | O nome do solicitante. |
Requester ID | O número da ID do solicitante. |
Requester external ID | A ID de um sistema externo. Opcional para contas com o single sign-on do Professional ou Enterprise habilitado através de JWT ou SAML. |
Requester email | O endereço de e-mail principal do solicitante. Se você quiser exportar uma lista de endereços de e-mail secundários dos usuários, você precisa usar o ponto de extremidade da API de lista de usuários, enquanto transfere identidades localmente (por exemplo: |
Requester domain | O domínio de e-mail do endereço de e-mail principal do solicitante. |
Submitter | O nome do primeiro emissor. O nome do solicitante é exibido se foi ele quem enviou o ticket. Se um agente enviou o ticket em nome do solicitante, o nome do agente é usado. Se o solicitante for alterado, o emissor não muda. |
Assignee | O atribuído no momento da exportação. |
Group | O grupo no momento da exportação. |
Subject | O assunto do ticket. |
Tags | As tags adicionadas ao ticket no momento da exportação. |
Status | O status no momento da exportação |
Priority | A prioridade no momento da exportação. |
Via | O canal de origem do ticket. |
Ticket type | O tipo no momento da exportação. |
Created at | A data e hora originais da criação. Exibidas no fuso horário da conta. |
Updated at | A data e hora da atualização mais recente. Exibidas no fuso horário da conta. |
Assigned at | A data e hora da atribuição de agente mais recente (por exemplo, a hora da atribuição ao atribuído mais recente). Exibidas no fuso horário da conta. |
Organization | A organização o solicitante atual (se houver). |
Due date | A data de vencimento no momento da exportação. Exibidas no fuso horário da conta. |
Initially assigned at | A data e hora da primeira atribuição a um agente (não um grupo). Exibidas no fuso horário da conta. |
Solved at | A data e hora da última ou mais recente alteração ao status resolvido. Exibidas no fuso horário da conta. |
Resolution time | A hora final ou mais recente de resolução em horas, arredondada para a hora cheia mais próxima. |
Satisfaction Score | O status do índice de satisfação atual (Não oferecido, Oferecido, Bom ou Ruim). |
Group stations | O número de alterações feitas à atribuição de grupo. A atribuição inicial no momento da criação do ticket também conta como uma estação. |
Assignee stations | O número de alterações feitas à atribuição de agente. A atribuição inicial no momento da criação do ticket também conta como uma estação. |
Reopens | O número de vezes que um ticket foi alterado de Resolvido para Aberto (por um agente ou usuário final). |
Replies | O número de respostas públicas do agente em um ticket para um comentário de um agente ou usuário final. |
First reply time in minutes | O tempo entre a hora de criação do ticket e carimbo de data/hora do primeiro comentário público do agente, exibido em minutos. |
First reply time in minutes within business hours | Igual ao acima, mas apenas o tempo passado durante o horário de operação é contado. |
First resolution time in minutes | O tempo entre a hora de criação do ticket e carimbo de data/hora da primeira alteração do status para resolvido, exibido em minutos. |
First resolution time in minutes within business hours | Igual ao acima, mas apenas o tempo passado durante o horário de operação é contado. |
Full resolution time in minutes | O tempo entre o horário de criação do ticket e carimbo de data/hora da alteração final e mais recente do status para resolvido, exibido em minutos. |
Full resolution time in minutes within business hours | Igual ao acima, mas apenas o tempo passado durante o horário de operação é contado. |
Agent wait time in minutes | O tempo total gasto no status Pendente, exibido em minutos. |
Agent wait time in minutes within business hours | Igual ao acima, mas apenas o tempo passado durante o horário de operação é contado. |
Requester wait time in minutes | O tempo total combinado gasto nos status Novo e Aberto. Se o ticket for reaberto após a resolução, o tempo gasto no status Resolvido também é contado. O tempo após a alteração final para o status Resolvido não é incluído. |
Requester wait time in minutes within business hours | Igual ao acima, mas apenas o tempo passado durante o horário de operação é contado. |
On hold time in minutes | O tempo total gasto no status Em espera, exibido em minutos. |
On hold time in minutes within business hours | Igual ao acima, mas apenas o tempo passado durante o horário de operação é contado. |
0 Comentários
Por favor, entre para comentar.