Importar do Zendesk

Shayan TaslimAtualizado

Utilize o importador do Zendesk para migrar publicações, comentários, votos positivos e seguidores de um fórum da comunidade Zendesk (Zendesk Gather) para os quadros do UserJot.

Note

Este importador migra fóruns da comunidade Zendesk, não tickets do Zendesk Support nem artigos da base de conhecimento do Centro de Ajuda Zendesk. Para migrar artigos do Centro de Ajuda Zendesk, utilize Importar um centro de ajuda existente.

Disponível para administradores e proprietários do espaço de trabalho em todos os planos, incluindo o Free.

Criar um cliente OAuth confidencial no Zendesk

O UserJot liga-se ao Zendesk através de uma concessão OAuth client_credentials (não é necessário um URI de redirecionamento).

  1. Abra Zendesk Admin Center → Apps e integrações → APIs → Clientes OAuth.

  2. Crie um cliente OAuth confidencial e conceda-lhe os âmbitos hc:read e users:read. Estes âmbitos permitem ao UserJot ler tópicos da comunidade, publicações, comentários, votos, subscrições e endereços de e-mail dos membros, sem aceder aos tickets do Support.

  3. Copie o Identificador do cliente e o Segredo do cliente.

O UserJot não armazena permanentemente as suas credenciais do Zendesk. Estas são encriptadas apenas enquanto a tarefa de importação em segundo plano está em execução e são eliminadas imediatamente a seguir.

Executar a importação

  1. No UserJot, abra Definições → Dados e importação e clique em Importar do Zendesk.

  2. Introduza o subdomínio Zendesk (o subdomínio .zendesk.com, por exemplo acme.zendesk.com; não são aceites domínios personalizados associados ao anfitrião, como support.acme.com), o Identificador do cliente e o Segredo do cliente e, em seguida, clique em Continuar.

  3. Em Escolher tópicos, associe cada tópico do Zendesk a um quadro do UserJot ou deixe o tópico definido como Não importar. Os tópicos com nomes iguais aos de um quadro existente do UserJot (sem distinção entre maiúsculas e minúsculas) são selecionados automaticamente. Associe pelo menos um tópico e clique em Continuar.

  4. Reveja Pronto para importar (a execução demora normalmente cerca de 15 minutos) e clique em Iniciar importação.

O UserJot executa a importação em segundo plano e, quando esta estiver concluída, envia um e-mail ao administrador que a iniciou (assunto: Your Zendesk import is done). É seguro executar novamente uma importação, uma vez que as publicações, os comentários, os votos e os seguidores já importados são identificados pelos respetivos IDs do Zendesk e não são duplicados.

O que é importado e o que é ignorado

Dados do Zendesk

Comportamento no UserJot

Publicações

Importadas como pedidos públicos, com título, corpo (HTML convertido em texto simples, até 20 000 caracteres), data de criação original, estado e total de votos positivos.

Estados

none → Pendente, planned → Planeado, completed → Concluído, not_planned e answered → Fechado.

Comentários

Importados diretamente para as respetivas publicações (até 10 000 caracteres), com a data de criação e o número de votos positivos. Os comentários vazios, sem texto nem imagens, são ignorados.

Imagens

As imagens HTTPS externas são copiadas e anexadas. As imagens /hc/ alojadas no Zendesk permanecem como ligações no texto do corpo, porque o Zendesk bloqueia as transferências do lado do servidor.

Votos

Os votos positivos são importados; os votos negativos são ignorados. São criadas linhas individuais de votação para os utilizadores que tenham um endereço de e-mail ou um ID externo (os votos de utilizadores eliminados do Zendesk continuam a contar para o total da publicação).

Seguidores

Importados como subscritores de pedidos, com a data original em que começaram a seguir, quando o utilizador tem um endereço de e-mail ou um ID externo.

Não importado

Tickets do Support, artigos do Centro de Ajuda, etiquetas de conteúdo, votos negativos, tópicos não associados e registos de alterações.

Resolução de problemas

  • «Não foi possível encontrar uma conta Zendesk.» Introduza o subdomínio .zendesk.com em vez de um domínio personalizado.

  • «O Zendesk não aceitou esse identificador e segredo.» Confirme que o cliente OAuth no Zendesk está definido como Confidencial, e não como Público.

  • «Este cliente OAuth não consegue ler o fórum.» Confirme que os âmbitos hc:read e users:read estão ambos ativados no cliente.

  • Limites de taxa. O carregamento de tópicos está limitado a 10 pedidos por hora e o início de uma importação está limitado a 3 por hora e 5 por dia.

Próximos passos

Isto respondeu à sua pergunta?