Migração do Zendesk Guide de outra plataforma: Um guia completo para 2026

Mover sua base de conhecimento para uma nova plataforma é um daqueles projetos que parecem simples até você começar. De repente, você está lidando com hierarquias de conteúdo, links quebrados, anexos ausentes e permissões de usuário que não se mapeiam da maneira que você esperava.

Este guia orienta você na migração para o Zendesk Guide de outra plataforma. Quer você venha do Freshdesk, Gorgias ou de uma solução personalizada, você aprenderá os métodos disponíveis, as armadilhas a evitar e como decidir se a migração é a jogada certa para sua equipe.

O que é o Zendesk Guide e por que migrar para ele?

O Zendesk Guide é o componente de base de conhecimento da plataforma de atendimento ao cliente do Zendesk. Ele permite que você crie, organize e publique artigos de ajuda que os clientes podem acessar por meio de uma central de ajuda com a sua marca.

As equipes normalmente migram para o Guide por alguns motivos:

• Consolidação Você já está usando o Zendesk para tickets e deseja relatórios unificados
• Melhor pesquisa A pesquisa baseada em IA do Zendesk exibe artigos relevantes de forma mais eficaz do que os sistemas legados
• Foco no autoatendimento Você está investindo em desvio e deseja uma base de conhecimento projetada para o autoatendimento do cliente
• Crescimento Sua plataforma atual não consegue escalar com seu conteúdo ou volume de usuários

Aqui está a versão curta: o Guide funciona melhor se você estiver comprometido com o ecossistema Zendesk. A base de conhecimento se integra perfeitamente com tickets do Zendesk, agentes de IA e análises. Se você não estiver usando o Zendesk para suporte, o Guide se torna uma opção independente cara.

Planejando sua migração para o Zendesk Guide

A preparação separa as migrações tranquilas dos desastres. Antes de tocar em qualquer dado, você precisa entender com o que está trabalhando.

Quais dados você pode migrar?

Lista de verificação pré-migração

• Audite seu conteúdo Remova duplicatas, artigos desatualizados e páginas órfãs
• Mapeie sua estrutura Documente sua hierarquia atual (pastas, categorias, seções) e planeje como ela se mapeia para a estrutura de Categorias → Seções → Artigos do Guide
• Configure campos personalizados Crie campos no Zendesk para armazenar IDs legados e metadados
• Crie contas de agente Seus autores de conteúdo precisam de contas do Zendesk antes da migração
• Desative os gatilhos Desative as notificações para que os clientes não recebam spam durante a migração

Métodos de migração comparados

Você tem três abordagens principais para inserir dados no Zendesk Guide. Cada um se adapta a diferentes níveis de habilidade técnica e complexidades de migração.

Método 1: API do Zendesk (para equipes técnicas)

A API do Zendesk oferece controle total. Você escreve scripts para extrair dados do seu sistema de origem e inseri-los no Guide por meio de endpoints REST.

Melhor para: Grandes conjuntos de dados, transformações complexas ou quando você precisa preservar relacionamentos específicos

Prós:

• Controle total sobre o mapeamento de dados
• Lida com anexos e imagens embutidas corretamente
• Pode ser executado incrementalmente e retomado se interrompido
• Gratuito (além do seu tempo de desenvolvimento)

Contras:

• Requer recursos de engenharia
• Limites de taxa se aplicam (~2.000 tickets/hora)
• Você lida com todos os casos de erro e condições extremas

Método 2: Ferramentas de migração de terceiros

Serviços como Help Desk Migration e Import2 fornecem interfaces sem código para transferência de dados.

Melhor para: Equipes sem desenvolvedores que precisam de migração confiável e rápida

Preços do Help Desk Migration:

Preços de amostra: ~$100 para 1.000 registros, ~$514 para 10.000 registros (preços não lineares)

Import2: Oferece uma migração de amostra gratuita em menos de 15 minutos. O preço é personalizado com base no volume e nas plataformas.

Método 3: Importação manual de CSV

O Zendesk oferece suporte à importação de CSV para dados básicos de tickets e usuários. Para conteúdo da base de conhecimento, isso é limitado e geralmente não é recomendado para nada além de um punhado de artigos.

Melhor para: Pequenos conjuntos de dados ou transferências únicas de registros específicos

Processo de migração passo a passo

Veja como funciona a migração real, supondo que você esteja usando uma ferramenta de terceiros ou uma abordagem de API.

Passo 1: Ative o Zendesk Guide

O Guide não está habilitado por padrão. Navegue até Central de administração → Configurações do Guide para ativá-lo. Você também vai querer configurar o tema da sua central de ajuda e a marca básica antes de importar o conteúdo.

Passo 2: Crie sua estrutura de conteúdo

Antes de importar artigos, configure o esqueleto:

1. Importe ou crie seus agentes como usuários do Zendesk
2. Crie categorias (organização de nível superior)
3. Crie seções dentro de cada categoria
4. Documente todos os IDs você precisará deles para o próximo passo

O Guide usa uma hierarquia de três níveis: Categorias → Seções → Artigos. Os planos Enterprise oferecem suporte a até seis níveis com subseções.

Passo 3: Importe artigos

Agora o trabalho pesado. Usando o método escolhido:

• Mapeie o conteúdo HTML para o formato de artigo do Zendesk
• Lide com imagens embutidas (elas precisam de upload separado e substituição de URL)
• Preserve os carimbos de data/hora originais, se possível (requer API)
• Armazene IDs legados em campos personalizados para referência

Passo 4: Lide com anexos e imagens

Os anexos não migram automaticamente com o texto do artigo. Você precisa:

• Carregar anexos via API ou manualmente
• Atualizar o HTML do artigo para apontar para novos URLs de anexos
• Testar se todas as imagens e arquivos carregam corretamente

Passo 5: Defina permissões e segmentos de usuário

Configure quem pode ver o quê:

• Artigos públicos (visíveis para todos)
• Apenas usuários registrados
• Segmentos de usuário específicos (artigos internos, conteúdo VIP, etc.)

Passo 6: Valide e entre em operação

Antes de virar a chave:

• Compare a contagem de artigos entre os sistemas antigo e novo
• Verifique a formatação, especialmente blocos de código e tabelas
• Teste a funcionalidade de pesquisa
• Configure redirecionamentos 301 dos URLs da sua antiga central de ajuda

Armadilhas comuns de migração e como evitá-las

Depois de revisar dezenas de migrações, estes são os problemas que surgem repetidamente:

IDs originais são perdidos O Zendesk gera novos IDs para tudo. Crie campos personalizados para armazenar seus IDs legados para que você possa referenciar números de tickets e IDs de artigos antigos.

Confusão de fuso horário As exportações JSON usam UTC. As exportações CSV usam o fuso horário da sua conta. Documente seus fusos horários antes de exportar ou os carimbos de data/hora estarão errados.

Anexos quebrados Planeje um fluxo de trabalho de migração de anexos separado. Não presuma que eles virão com o texto do artigo.

Comentários ausentes Conversas paralelas e notas internas geralmente não são transferidas automaticamente. Você pode precisar convertê-las em notas privadas durante a migração.

Spam de notificação Sempre desative gatilhos e automações antes da migração. Você não quer que os clientes sejam notificados sobre cada ticket importado.

Problemas de formatação Teste a renderização HTML, especialmente para blocos de código, tabelas e mídia incorporada. O que parece certo no seu sistema antigo pode quebrar no Guide.

Uma alternativa moderna à migração: eesel AI

Aqui está algo que os guias de migração raramente mencionam: você pode não precisar migrar.

Na eesel AI, adotamos uma abordagem diferente. Em vez de mover todo o seu conteúdo para uma nova plataforma, nosso agente de IA se conecta diretamente à sua central de ajuda existente seja Zendesk, Freshdesk, Gorgias ou outra plataforma e aprende com seu conteúdo onde ele já existe.

Veja como funciona:

1. Conecte-se em minutos Sem migração de dados. Nós nos integramos com sua central de ajuda existente e aprendemos com seus tickets, central de ajuda e macros.

2. Comece com orientação Como qualquer novo contratado, nossa IA começa elaborando respostas para sua equipe revisar. Você verifica se ela entende seu negócio antes de expandir seu papel.

3. Suba de nível para autônomo À medida que a IA se prova, você pode fazer com que ela lide diretamente com o suporte de linha de frente, escalando apenas os casos extremos que você definir.

4. Controle em português claro Sem configuração complexa. Diga à IA coisas como "Sempre escale disputas de cobrança para um humano" ou "Para clientes VIP, coloque o gerente de contas em cópia".

O resultado? Você obtém suporte baseado em IA sem o projeto de migração de meses. Sua equipe continua trabalhando nas ferramentas que conhece. Seus clientes obtêm respostas mais rápidas. E você evita o risco de perda de dados ou links quebrados que vem com qualquer migração de plataforma importante.

Também oferecemos o AI Copilot para equipes que desejam assistência de IA sem automação total e o AI Triage para marcar, rotear e priorizar tickets automaticamente. Nossa integração de IA do Zendesk funciona perfeitamente com sua configuração existente do Zendesk.

Consulte nossos preços para obter detalhes cobramos por interação, não por agente, para que você não seja penalizado por aumentar sua equipe.

Escolhendo a abordagem certa para sua equipe

Então, qual caminho você deve seguir? Aqui está uma estrutura simples:

Migre para o Zendesk Guide se:

• Você já está comprometido com o Zendesk para tickets
• Você precisa de relatórios unificados em tickets e conhecimento
• Você está aposentando sua antiga plataforma completamente
• Você tem os recursos para um projeto de migração de várias semanas

Aumente com o eesel AI se:

• Sua plataforma atual ainda funciona bem
• Os custos de migração (tempo + dinheiro) são muito altos
• Você deseja os benefícios da IA sem trocar de plataforma
• Você precisa mostrar resultados rapidamente

Conclusão: A migração é um meio para um fim, não o fim em si. Se seu objetivo é um melhor atendimento ao cliente, o aumento da IA geralmente oferece resultados mais rápidos com menos risco do que uma migração completa da plataforma.