Como exportar tudo do helpdesk antigo: tickets, artigos e contatos

A exportação é a metade da migração que está inteiramente sob o seu controle — e é justamente a metade que quase todo time começa tarde demais. Você não precisa ter escolhido o destino para começar: uma exportação completa e verificada é útil mesmo se você acabar ficando onde está. Ela é o seu backup, a sua posição de negociação e a prova do que você de fato possui.

Este guia cobre o que tirar de um helpdesk antigo, qual caminho usar para cada tipo de objeto e as armadilhas que ficam invisíveis até a segunda semana na ferramenta nova.

O que você pode (e deve) exportar

Um helpdesk guarda mais tipos de objeto do que a maioria dos administradores imagina. O conjunto completo que vale a pena extrair:

• Tickets e conversas — as mensagens, seus autores, carimbos de data e hora, status, responsáveis e tags.
• Contatos e organizações — os cadastros de clientes com campos personalizados e os vínculos entre eles.
• Artigos da base de conhecimento — o corpo do texto, as categorias, os sinalizadores de visibilidade e as imagens que moram dentro deles.
• Macros e respostas salvas — a linguagem que os seus clientes já reconhecem.
• Definições dos campos personalizados — não apenas os valores, mas os tipos e as opções permitidas.
• Histórico de CSAT — notas e comentários, se você acompanha tendências de satisfação.
• Anexos — os arquivos pendurados em tickets e artigos, que quase nunca viajam junto com a exportação principal.

Os três caminhos de exportação

Todo helpdesk relevante oferece alguma combinação de três caminhos:

1. Exportação em massa nativa. Um botão ou uma tarefa agendada que produz CSV, JSON ou XML. É o começo mais rápido, mas costuma estar travado atrás da faixa do plano, às vezes tem teto de volume e raramente é completo — anexos e imagens de artigos são as lacunas de sempre.
2. A API. Completa e programável, porém paginada e com limite de requisições. É o caminho para tudo aquilo que a exportação em massa deixa de fora, e o único confiável para anexos.
3. Um serviço de migração. O fornecedor de destino roda a exportação por você contra as APIs de origem. É o menor esforço — só garanta que você também receba (ou consiga rodar de novo) uma cópia bruta para o seu próprio arquivo.

Um plano sensato combina os dois primeiros: exportação em massa para os 90% fáceis, scripts de API para o resto. E se o destino conduzir a migração, guarde a sua própria exportação assim mesmo.

Tickets: o formato pesa mais que o volume

CSV achata; JSON preserva. Uma exportação em CSV normalmente entrega uma linha por ticket ou por mensagem e perde o encadeamento das respostas, os papéis dos autores e os metadados que tornam o histórico realmente útil. Se existir exportação em JSON ou caminho por API, prefira — a importação do destino sempre consegue simplificar uma estrutura, mas nunca consegue reinventá-la.

Regras práticas para a exportação de tickets:

• Exporte em lotes, do mais antigo para o mais novo, respeitando os limites de requisição. Puxar o histórico completo de uma conta grande pode levar dias dentro das cotas de API — agende o trabalho em vez de ficar de babá dele.
• Anote a convenção de fuso horário. A maioria das APIs devolve UTC; algumas exportações em massa localizam os carimbos de data em silêncio. Confira um punhado deles contra a interface antes de confiar em milhares.
• Filtre antes de exportar. Tickets fechados como spam e os de uma palavra só incham o trabalho e poluem a busca no destino. Ninguém nunca procurou por um deles.
• Capture o histórico de status, se der. Relatórios de SLA e de tempo de resolução dependem das transições de estado, não apenas do estado final.

Contatos e organizações

Contatos ocupam pouco espaço, então os times tratam o assunto com displicência — e depois passam um trimestre limpando duplicados. Antes de exportar:

• Confirme que o e-mail está preenchido nos cadastros que interessam; é a chave de deduplicação que praticamente todo destino usa.
• Exporte os campos personalizados junto com as definições deles, não apenas os valores. Uma lista suspensa que chega como texto livre é um dano permanente.
• Preserve os vínculos entre contato e organização — eles costumam viver em uma exportação ou em um endpoint separado.

Base de conhecimento: a exportação com dependências escondidas

O corpo dos artigos sai fácil, em HTML. As dependências, não:

• As imagens quase sempre estão só linkadas, e não embutidas — a exportação aponta para arquivos no CDN do fornecedor antigo. Baixe agora todas as imagens referenciadas; essas URLs podem morrer no dia em que a sua conta for encerrada.
• Rascunhos e sinalizadores de visibilidade se perdem ou são achatados em algumas exportações. Registre quais artigos eram internos antes da mudança, ou você corre o risco de publicar o seu manual de escalonamento para o mundo inteiro.
• As árvores de categorias costumam sair em um arquivo separado dos artigos. Capture a estrutura, inclusive a ordenação.
• Os links entre artigos apontam para as URLs antigas. Você vai reescrevê-los na importação; a lista deles você precisa ter agora.

Macros, automações e o resto

Macros exportam como texto na maioria das ferramentas — trabalho curto. Já as regras de automação e de roteamento normalmente não exportam em nenhum formato aproveitável: documente-as à mão, em linguagem simples, e encare a reescrita como uma oportunidade de redesenho, não como um trabalho de cópia. Exporte também as tags, o histórico de CSAT e qualquer visão da qual os seus relatórios dependam.

As armadilhas que aparecem na segunda semana

• Links de anexo que expiram. A exportação aponta para URLs de armazenamento que param de responder depois do encerramento da conta. Copie os arquivos, não os links.
• Tetos de exportação. Algumas tarefas em massa truncam em silêncio ao bater um limite de linhas. Reconcilie os números: a exportação tem que bater com a contagem de tickets que a própria interface informa.
• Mapeamento de identidade dos agentes. As mensagens referenciam as contas de agente por ID interno. Exporte também a lista de agentes, ou a autoria vira um quebra-cabeça.
• Tickets excluídos e arquivados. Alguns caminhos os incluem, outros não. Decida de propósito quais deles você quer.
• Estrangulamento por limite de requisições no meio do trabalho. Um script que não trata backoff morre às 3 da manhã e deixa uma exportação parcial com cara de completa.

Verifique a exportação antes de confiar nela

Uma exportação que você não verificou é uma esperança, não um backup. Antes de cantar vitória:

• Reconcilie as contagens. Tickets, contatos e artigos na exportação têm que bater com o que a interface da ferramenta antiga informa. Divergência significa um teto, um filtro ou um script que morreu às 3 da manhã.
• Abra uma amostra aleatória. Dez tickets espalhados pelo período: encadeamento intacto, autores resolvidos, carimbos de data coerentes, anexos de fato presentes como arquivos.
• Confira o registro mais antigo e o mais novo. O truncamento mora nas pontas — um trabalho que parou calado no meio parece completo até você olhar a cauda.
• Guarde duas cópias em lugares que você controla e anote a data da exportação. Se a migração escorregar um trimestre, você vai saber exatamente quão velho é esse retrato.

Uma palavra sobre os três grandes

Zendesk, Freshdesk e Intercom oferecem caminhos legítimos de exportação — exportações em massa e APIs bem documentadas — ainda que a disponibilidade varie conforme a faixa do plano e o acesso de administrador seja exigido em todos eles. Nenhum deles mantém os seus dados como refém; o atrito está na completude e nos formatos, não na permissão. Reserve um dia para aprender as manias da sua ferramenta específica e comece pela documentação de exportação do próprio fornecedor — é ela que diz, com autoridade, o que o seu plano inclui. E se você estiver comparando destinos ao mesmo tempo, a nossa comparação com o Zendesk cobre o caminho da migração nos dois sentidos.

Onde o MoveDesk entra

A migração assistida do MoveDesk roda essa exportação inteira contra a sua conta de origem por você — tickets, contatos, artigos, macros e anexos vindos de Zendesk, Intercom ou Freshdesk — de graça em todos os planos. Ainda assim, recomendamos guardar a sua própria cópia bruta: os dados são seus, e uma segunda cópia não custa nada.

Comece a exportação esta semana, mesmo que a decisão esteja a meses de distância. Uma cópia verificada dos seus próprios dados é a posição mais forte de onde um time de suporte pode negociar.