Como exportar tickets do Zendesk: Guia completo (CSV e API)

Postado por Natalia Tomchyshyn

Atualizado em 4 de junho de 2026

Precisa extrair seus dados Zendesk ? Seja para gerar um relatório, fazer backup do seu histórico, migrar para uma nova plataforma ou simplesmente responder a uma pergunta da liderança com números concretos, você tem várias maneiras de fazer isso. Nem todas são iguais.

Este guia aborda todos os métodos de exportação oferecidos Zendesk , o que cada um realmente oferece (e o que ele omite silenciosamente) e quando é melhor usar uma ferramenta de migração.

O que você pode — e o que não pode — exportar do Zendesk

Antes de clicar em qualquer coisa, é importante saber o que o sistema de exportação do Zendeskabrange. Existem quatro tipos de dados que você pode exportar:

• **Tickets** — campos do ticket, status, responsável, solicitante, etiquetas, datas
• **Usuários** — registros de agentes e usuários finais
• **Organizações** — nomes de organizações, domínios, campos personalizados

O que está visivelmente ausente das exportações padrão:

• Comentários do ticket e histórico da conversa — as respostas e anotações internas não estão incluídas na exportação da visualização CSV
• Anexos — os arquivos anexados aos ingressos não são incluídos em nenhuma exportação nativa
• Comentários de satisfação do cliente sobre o ticket — embora a classificação bruta de satisfação "Bom" ou "Ruim" seja incluída como metadados nas exportações em massa de tickets, o feedback textual escrito pelo cliente é completamente removido
• Transcrições de bate-papo em tempo real — produto separado, caminho de exportação separado
• Dados de objetos personalizados — disponíveis somente via API

Conhecer essas lacunasfront economiza muito tempo. Se você precisar do histórico de conversas, a exportação padrão não será útil — e abordaremos suas opções mais adiante neste guia.

Método 1 — Exportar tickets Zendesk a partir de uma visualização (CSV)

O método de exportação mais rápido e acessível. Funciona sem qualquer configuração especial de conta e qualquer agente com as permissões corretas pode executá-lo.

Instruções passo a passo

1. Faça login na sua conta Zendesk .
2. Na barra lateral esquerda, clique no ícone **Exibições** (a grade de linhas horizontais).
3. Selecione a visualização que contém os tickets que você deseja exportar. Se você não tiver uma visualização personalizada configurada, use uma das visualizações integradas, como *Todos os tickets não resolvidos*.
4. Acesse o canto superior direito da página de visualização. Observação: se você tiver algum filtro de pesquisa temporário ativo aplicado à visualização, o botão de exportação ficará completamente oculto. Limpe todos os filtros ativos primeiro. Dependendo da sua versão, clique em Exportar CSV ou clique no menu suspenso Ações e selecione Exportar como CSV.
5. Confirme a exportação CSV . Zendesk processa o arquivo e envia um link para download para o endereço de e-mail cadastrado em sua conta.
6. Abra o e-mail e baixe o arquivo ZIP contendo seu CSV.

O que está incluído no arquivo CSV

O CSV exportado inclui os campos de coluna visíveis na sua visualização, além dos campos padrão:

O limite de 1.000 ingressos — e como contorná-lo

Este é o ponto de frustração mais comum: Zendesk trunca as exportações de visualizações em 1.000 tickets. Se a sua visualização contiver mais registros, a exportação para silenciosamente em 1.000, sem nenhum aviso ou mensagem de erro.
Para contornar isso:

• Crie várias visualizações filtradas com intervalos de datas, cada uma contendo menos de 1.000 tickets, e exporte cada visualização separadamente.
• Em vez disso, utilize a exportação em lote completa (Método 2) — ela não possui limite de bilhetes por exportação.
• Utilize a API Zendesk (Método 4) para acesso programático a todos os registros.

Método 2 — Exportação completa de dados em massa (CSV)

A exportação completa de dados fornece um repositório completo dos seus dados principais, sem limite de tickets. É o método ideal quando você precisa de um backup completo ou está se preparando para uma migração.

Como ativar a exportação de dados (é necessário ser o proprietário da conta)

Por padrão, a exportação completa de dados está desativada por motivos de segurança. O proprietário da conta não precisa entrar em contato com o suporte, mas deve habilitá-la explicitamente acessando Central de Administração → Conta → Segurança → Exportação de dados. Lá, você deve especificar os domínios de e-mail aprovados que podem receber os arquivos exportados. Após a configuração, qualquer administrador poderá solicitar uma exportação para um endereço de e-mail aprovado.

Passo a passo: solicite a exportação completa do seu bilhete

1. No Zendesk, clique no ícone do Centro de Administração (ícone de grade).
2. Acesse Conta → Segurança → Exportação de dados.
3. Deslize a tela até a seção de exportação CSV .
4. Defina um intervalo de datas se quiser limitar o escopo ou deixe em branco para obter todos os registros históricos.
5. Clique em Exportar.
6. Zendesk processa a exportação em segundo plano e envia por e-mail uma pasta ZIP contendo seu arquivo CSV para o endereço de e-mail aprovado.

Passo a passo: exportar usuários e organizações

Como a ferramenta nativa de exportação de dados em massa restringe os arquivos CSV exclusivamente a registros de tickets, extrair uma planilha limpa com os diretórios de seus clientes e da sua organização requer um script de API programático:

1. Gere um token de API navegando até Central de administração → Aplicativos e integrações → APIs → API Zendesk .
2. Certifique-se de que o Acesso por Token esteja ativado e clique em Adicionar Token de API para gerar uma credencial segura.
3. Utilize um script programático (como Python) para fazer requisições aos endpoints /api/v2/users.json ou /api/v2/organizations.json.
4. Configure seu loop de código para analisar seus diretórios de usuários e organizações ativos, extrair seus atributos personalizados e gravá-los diretamente em um arquivocsv local em sua máquina.

Guia de Formato e Método

Quanto tempo demora uma exportação Zendesk ?

• Contas pequenas (menos de 10.000 tickets): geralmente alguns minutos
• Contas de médio porte (10.000 a 500.000 tickets): de 30 minutos a algumas horas
• Contas grandes (> 1.000.000 de tickets): podem levar até 24 horas; exportadas automaticamente em incrementos de 31 dias

Método 3 — Exportar dados da Base de Conhecimento/Guia Zendesk para CSV

Os métodos acima abrangem dados de tickets, usuários e organizações. Zendesk Guide (sua base de conhecimento) é um tipo de conteúdo separado e requer uma abordagem diferente.

Usando a exportação integrada da Central de Ajuda

Zendesk não oferece um botão nativo de exportação com um clique para artigos ou categorias do Guia no painel de administração padrão. Embora a visualização **Gerenciar Artigos** permita selecionar vários artigos para atualizar suas configurações (como alterar rótulos ou autores em massa), ela não permite baixar ou exportar o conteúdo deles. Para exportar completamente o Guia para CSV, um script da API Python é a abordagem mais confiável.

Exportando dados do Guia com um script Python

Para exportar um guia completo para CSV, a abordagem mais confiável é um script em Python que utilize a API Zendesk Help Center. Aqui está um exemplo mínimo funcional:

Pré-requisitos:

• Python 3 instalado
• Biblioteca `requests`: execute `pip install requests`
• Seu subdomínio Zendesk , e-mail de administrador e token de API

import requests import csv SUBDOMAIN = "seu-subdomínio" EMAIL = "seu-email@exemplo.com" API_TOKEN = "seu-token-de-api" url = f"https://{SUBDOMAIN}zendesk/api/v2/help_center/articles.json" auth = (f"{EMAIL}/token", API_TOKEN) articles = [] while url: response = requests.get(url, auth=auth) data = response.json() articles.extend(data["articles"]) url = data.get("next_page") with open("zendeskcsv, "w", newline="", encoding="utf-8") as f: writer = csv(f, fieldnames=["id", "title", "body", "section_id", "created_at", "updated_at"]) writer.writeheader() for article in articles: writer.writerow({ "id": article["id"], "title": article["title"], "body": article.get("body", ""), "section_id": article.get("section_id", ""), "created_at": article["created_at"], "updated_at": article["updated_at"], }) print(f"Exported {len(articles)} articles to zendesk_guide_export.csv")

O script percorre automaticamente todos os artigos página por página. Execute-o e você obterá um CSV limpo com IDs dos artigos, títulos, conteúdo bruto (HTML), atribuições de seção e registros de data e hora.

Solução de problemas:

• **Erros de sintaxe/terminal** — certifique-se de estar executando o Python 3 (`python3` e não `python` em alguns sistemas operacionais)
• **Problemas de codificação de caracteres** — o parâmetro `encoding="utf-8"` no script lida com a maioria dos casos de formatação de estilos; se você vir tags HTML quebradas ou texto ilegível no Excel, use o menu Dados → Escolher **Texto/CSV** do Excel e selecione explicitamente o formato UTF-8 na importação do arquivo.
• **Artigos restritos ausentes** — artigos internos/restritos para agentes exigem credenciais de API de nível administrativo; verifique se seu token de API pertence a uma conta de administrador ativa com permissões para visualizar todos os segmentos do Guia.

Comparação dos 4 métodos de exportação

Para extrair fluxos de conversas nativamente (o texto propriamente dito dentro das mensagens e notas internas) em massa, você deve consultar o endpoint de Eventos de Tickets Incrementais em vez do endpoint básico de encapsulamento de tickets. Esse fluxo retorna parâmetros de conversa específicos quando você aplica o parâmetro de carregamento lateral `include=comment_events`

Substitua `start_time=0` por um timestamp Unix para obter apenas os registros atualizados após esse horário — útil para sincronizações incrementais diárias.

Autenticação: Use autenticação básica com `{email}/token` como nome de usuário e seu token de API como senha, ou OAuth se você o tiver configurado.

Paginação: Os endpoints incrementais utilizam marcadores de fluxo. Para rastreamento baseado em tempo, você deve capturar a string inteira `end_time` da resposta JSON e inseri-la como o novo `start_time` na sua requisição de API subsequente. Repita esse loop continuamente até que a propriedade booleana `end_of_stream` da resposta JSON seja verdadeira.

Como exportar comentários e conversas de tickets Zendesk

Essa é a pergunta que a maioria dos guias ignora — e é a que mais prejudica as equipes.

O problema: Tanto a visualização padrão CSV quanto a exportação completa em lote omitem os comentários dos tickets. Você obtém o conteúdo do ticket (status, responsável, datas, tags), mas não a conversa em si — as respostas, anotações internas e o contexto que tornam os tickets úteis como registros.

Por que os comentários estão faltando na exportação padrão?

A exportação CSV do Zendeskfoi projetada para geração de relatórios e análises, não para portabilidade completa de dados. Presume-se que você continuará usando Zendesk, portanto, não precisa do conteúdo da conversa como um arquivo portátil.

Como obter comentários através da API

Utilizando a API de Tickets com carregamento lateral:

Esta função retorna todas as respostas públicas, notas internas privadas e eventos do sistema para um ticket em ordem cronológica, incluindo o autor e o registro de data e hora de cada comentário.

Para exportar em massa comentários de todos os tickets, use o endpoint de exportação incremental com `include=comment_events`, conforme mostrado no Método 4.

A desvantagem: extrair comentários de uma conta grande por meio da API leva tempo e exige a escrita de código para vincular os tickets aos seus respectivos comentários e gerar uma estrutura coerente.

Quando uma ferramenta de migração é a opção mais rápida

Se você precisa de comentários porque está migrando de plataforma, existe um caminho mais rápido. Help Desk Migration migra todo o histórico de conversas — respostas públicas, anotações internas e anexos de arquivos — diretamente para o seu novo help desk, com mapeamento automático de campos e sem a necessidade de um arquivo CSV intermediário.

O que o HDM migra do Zendesk:

• Ingressos com histórico completo da conversa (pública + privada)
• Anexos
• Usuários e organizações
• Artigos da base de conhecimento (Guia)
• Campos e etiquetas personalizados

Comparação de todos os métodos de exportação

Solução de problemas comuns de erros de exportação Zendesk

O e-mail de exportação nunca chegou

• Verifique primeiro sua pasta de spam
• Certifique-se de que o endereço de e-mail da sua conta Zendesk esteja acessível
• Para exportações em grande volume, contas grandes podem levar até 24 horas — aguarde antes de fazer uma nova solicitação
• Solicitar uma nova exportação enquanto outra está em processamento pode causar conflitos na fila; cancele primeiro a solicitação pendente na guia Relatórios
• Lembre-se de que, uma vez solicitada uma exportação, ela não pode ser cancelada ou modificada na interface do usuário. Solicitar várias extrações em um curto período pode sobrecarregar a fila do servidor; o ideal é permitir que o sistema termine de processar a solicitação inicial.

O link para download expirou

Os links para download dos relatórios exportados Zendesk expiram após um determinado período (normalmente 3 dias para exportações em lote e menos tempo para exportações de visualização). Se o seu link expirou, retorne a **Central de administração → Relatórios → Exportar** e solicite o arquivo novamente.

Erros de sintaxe no arquivo baixado

Mais comum com exportações JSON. Zendesk exporta NDJSON (JSON delimitado por nova linha) — cada linha é um objeto JSON separado, não uma matriz JSON padrão. Ferramentas que esperam uma matriz `[...]` gerarão um erro de análise.

Solução: envolva o arquivo em um array JSON ou converta-o com um script simples:

problemas de codificação de caracteres

Se caracteres especiais (acentos, alfabetos não latinos, travessões) aparecerem ilegíveis no Excel:

1. Não clique duas vezes no CSV para abri-lo
2. No Excel, acesse **Dados → De Texto/CSV**
3. Selecione o arquivo e escolha **UTF-8** como codificação no assistente de importação

Artigos internos (restritos) ausentes na exportação do Guia

O script Python ou a chamada de API requer credenciais de administrador para acessar artigos internos. Se o seu token de API pertencer a uma conta de agente, os artigos internos serão filtrados silenciosamente. Alterne para um par de e-mail/token de administrador.

Quando as exportações manuais não são suficientes — migrando para uma nova plataforma

Exportações manuais funcionam bem para backups, relatórios e extrações pontuais de dados. Elas deixam de funcionar quando o objetivo é migrar para uma plataforma diferente.

Os problemas se acumulam:
- Comentários e histórico de conversas exigem a API, não uma exportação pela interface do usuário
- Importar um JSON ou CSV para um novo help desk requer mapeamento de campos — raramente uma correspondência exata
- Os anexos permanecem no Zendesk, não no seu arquivo de exportação
- Contas grandes levam horas ou dias para serem exportadas e mais horas para serem importadas
- Atualizações incrementais entre o início da exportação e a conclusão da migração criam lacunas de dados

É para isso que servem as ferramentas específicas de migração.

Como Help Desk Migration lida com a transferência completa de dados Zendesk

Help Desk Migration conecta-se diretamente ao Zendesk via API e à sua plataforma de destino, transferindo dados sem a necessidade de um CSV intermediário:

1. **Conecte-se Zendesk** — insira seu subdomínio e token de API
2. **Conecte seu destino** — Freshdesk, Jira Service Management, HubSpot, Intercomou mais de 60 outras opções
3. **Mapeie seus campos** — o assistente mostra os campos de origem e destino lado a lado; campos personalizados incluídos
4. **Executar uma Migração de Demonstração** — migra uma amostra de 20 tickets para que você possa verificar o resultado antes de confirmar a alteração
5. **Execute a migração completa** — o HDM lida automaticamente com paginação, limitação de taxa, anexos e histórico de conversas
6. **Migração Delta** — execute uma sincronização final após a migração principal para capturar os tickets atualizados durante o período

O que se move:

• Ingressos com histórico completo da conversa (notas públicas e privadas)
• Anexos do bilhete
• Usuários e organizações
• Artigos da base de conhecimento com estrutura (categorias, seções)
• Campos e etiquetas personalizados

Perguntas frequentes