Exportar os dados do Zendesk Guide para um arquivo CSV pode ser um passo crucial para empresas que desejam analisar, migrar ou reutilizar o conteúdo de seu Centro de Ajuda. Existem dois métodos principais para realizar isso:
- Usar um script em Python – Esta abordagem foi sugerida por Scott Havard na comunidade Zendesk. Envolve usar a API do Centro de Ajuda Zendesk para extrair dados manualmente. É uma ótima opção para quem tem experiência com programação e deseja personalizar a saída de acordo com necessidades específicas.
- Exportação automatizada com Help Desk Migration – Este serviço simplifica o processo ao oferecer uma solução pronta para usar para exportar o conteúdo do Zendesk Guide, eliminando a necessidade de scripts complexos.
A seguir, exploraremos em detalhes o método do script em Python, incluindo os passos necessários, dicas de solução de problemas e considerações. Além disso, destacaremos como o Help Desk Migration oferece uma alternativa amigável para exportar e migrar os dados do Zendesk Guide.
Exportar dados do Zendesk Guide usando um script em Python
- Baixar Python Certifique-se de que o Python está instalado no seu sistema. Você pode baixar o Python no site oficial.
- Instalar dependências Abra sua linha de comando ou terminal e execute:
bash
pip install requests pandas - Baixar os scripts Clone ou baixe o repositório de scripts Python. Certifique-se de ter os arquivos de script necessários que correspondem ao tipo de exportação desejada.
- Editar o script Os scripts exigem credenciais do Zendesk para acessar os dados do seu Centro de Ajuda. Abra o script e modifique o seguinte:
- Seu subdomínio do Zendesk
- Credenciais da API (token da API ou credenciais OAuth)
Certifique-se de que sua conta tenha as permissões necessárias para acessar os dados que deseja exportar.
- Executar o script Navegue até o diretório onde o script está localizado. Por exemplo, se o script estiver salvo na sua área de trabalho, execute:
bash
cd /users/seunome/desktopDepois, execute o script usando:
bash
python articleid.pySubstitua
articleid.pypelo nome apropriado do script que você deseja executar. - Ver saída Após executar o script, um arquivo .csv será criado no diretório atual. O arquivo incluirá títulos de artigos, IDs de artigos e outras informações relevantes do Zendesk Guide.
- Script Article_Information_Export: Este script exporta todos os dados disponíveis em um único arquivo .csv.
- Outros scripts: Esses scripts exportam tipos específicos de dados (por exemplo, apenas títulos de artigos) em um arquivo .csv.
Resolução de Erros Comuns
Erros de Sintaxe
Se você encontrar erros de sintaxe como "Non-ASCII character," certifique-se de que o script esteja salvo com uma codificação apropriada (preferencialmente UTF-8). Use um editor de texto como Visual Studio Code ou Sublime Text para editar e salvar corretamente o script.
Problemas de Codificação de Caracteres
Para evitar UnicodeEncodeError, especialmente ao lidar com caracteres especiais, talvez seja necessário remover ou substituir caracteres problemáticos no script. Por exemplo:
decode_10_nozwsp = decode_10.replace(u'\u200b', '')
Dados Ausentes (Artigos Internos)
Se você estiver tentando exportar artigos internos ou rascunhos, apenas o OAuth pode não ser suficiente, pois agora ele só exporta conteúdo publicado por padrão. Você pode usar Basic Auth para recuperar artigos internos ou modificar o endpoint para especificar seções/categorias internas. No entanto, isso pode não retornar dados devido a alterações de segurança. Considere ajustar sua abordagem ou usar Basic Auth para uma exportação mais abrangente.
Seguindo essas etapas e usando os scripts fornecidos, você pode exportar com sucesso os dados dos artigos do Zendesk Guide para o formato .csv para facilitar o manuseio. Se encontrar problemas relacionados a artigos internos, limitações do OAuth ou erros de codificação, ajuste o script para atender melhor às suas necessidades.
Serviço de Migração de Help Desk: Exportação Automatizada de Dados do Zendesk Help Center
Além de usar scripts de API, o Help Desk Migration oferece um serviço automatizado de migração de dados, que simplifica o processo de exportação de dados do Zendesk Help Center e sua migração para outras instâncias do Zendesk ou diferentes plataformas.
Com o Help Desk Migration, você pode:
- Exportar dados do Help Center: Exporte facilmente todo o conteúdo do seu Zendesk Help Center, incluindo artigos, seções e categorias, diretamente para um arquivo CSV.
- Migração automatizada e segura: Transfira seus dados do Help Center de uma instância do Zendesk para outra ou para outra plataforma de suporte de maneira segura. O processo é automatizado, garantindo uma migração rápida, precisa e sem complicações, sem necessidade de scripts de API complexos.
Ao contrário da criação manual de scripts, o Help Desk Migration simplifica todo o processo, tornando-se a solução ideal para empresas que precisam exportar e migrar dados do Zendesk Help Center de maneira eficiente e sem complexidade técnica.
Como migrar o Zendesk Guide com o Help Desk Migration
O Help Desk Migration pode migrar o conteúdo do Zendesk Guide como parte de um processo de migração de help desk. A migração geralmente inclui a transferência de dados como artigos, categorias e seções da base de conhecimento do Zendesk Guide para uma plataforma de destino compatível. Aqui está uma visão geral de como o processo funciona:
- Avaliação: Analise a estrutura do Zendesk Guide para determinar quais dados precisam ser migrados, incluindo artigos, seções, categorias e formatação.
- Preparação:
- Reúna as credenciais necessárias, como chaves de API, para a origem (Zendesk Guide).
- Certifique-se de que a plataforma de destino seja compatível com a migração da base de conhecimento e tenha a estrutura necessária para acomodar o conteúdo do Zendesk Guide.
- Configuração:
- Use o Migration Wizard para mapear os campos de dados entre o Zendesk Guide e a plataforma de destino.
- Personalize as configurações para manter as hierarquias de artigos, anexos, tags e outros metadados.
- Migração de demonstração: Realize uma migração de demonstração gratuita para transferir um pequeno conjunto de dados. Isso garante a integridade dos dados e permite verificar como o conteúdo será exibido na plataforma de destino.
- Migração completa: Depois que os resultados da demonstração forem revisados e confirmados, prossiga com a migração completa dos dados do Zendesk Guide. O processo é automatizado, minimizando o trabalho manual e o risco de erros.
- Verificações pós-migração:
- Revise o conteúdo da base de conhecimento transferido na plataforma de destino.
- Confirme se os artigos, seções e categorias estão organizados e formatados corretamente.
Conclusão
Ambas as opções para exportar os dados do Zendesk Guide oferecem vantagens distintas, mas a escolha depende das suas necessidades específicas e da experiência técnica. Enquanto o uso de um script Python oferece flexibilidade para quem está confortável com codificação, ele requer tempo e esforço para configurar, solucionar problemas e personalizar. Por outro lado, o Help Desk Migration oferece uma solução de migração de dados automatizada e fácil de usar que elimina a complexidade e garante precisão. Seja para exportar dados para análise, migração ou reaproveitamento, o Help Desk Migration simplifica o processo, economizando tempo e recursos valiosos. Para empresas que buscam eficiência e confiabilidade, este serviço automatizado é a escolha ideal.
