Importar do Zendesk

Shayan TaslimAtualizado

Use 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 Help Center do Zendesk. Para migrar artigos do Zendesk Help Center, use Importar uma central 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 se conecta ao Zendesk com uma concessão OAuth client_credentials (não é necessário URI de redirecionamento).

  1. Abra Zendesk Admin Center → Apps and integrations → APIs → OAuth clients.

  2. Crie um cliente OAuth confidencial e conceda a ele os escopos hc:read e users:read. Esses escopos permitem que o UserJot leia tópicos da comunidade, publicações, comentários, votos, inscrições e e-mails dos membros sem acessar tickets do Support.

  3. Copie o identificador do cliente e o segredo do cliente.

O UserJot não armazena suas credenciais do Zendesk permanentemente. Elas são criptografadas apenas enquanto a tarefa de importação em segundo plano está em execução e são excluídas imediatamente depois.

Executar a importação

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

  2. Insira o subdomínio do Zendesk (o subdomínio .zendesk.com, como acme.zendesk.com; domínios personalizados mapeados para um host, como support.acme.com, não são aceitos), o identificador do cliente e o segredo do cliente e clique em Continuar.

  3. Em Escolher tópicos, mapeie cada tópico do Zendesk para um quadro do UserJot ou deixe o tópico definido como Não importar. Os tópicos com nomes iguais aos de quadros existentes no UserJot (sem diferenciar maiúsculas de minúsculas) são selecionados automaticamente. Mapeie pelo menos um tópico e clique em Continuar.

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

O UserJot executa a importação em segundo plano e envia um e-mail ao administrador que a iniciou quando ela termina (assunto: Your Zendesk import is done). É seguro executar a importação novamente, pois publicações, comentários, votos e seguidores já importados são deduplicados pelos respectivos IDs do Zendesk.

O que é importado e o que é ignorado

Dados do Zendesk

Comportamento no UserJot

Publicações

Importadas como solicitações públicas com título, conteúdo (HTML convertido em texto simples, até 20.000 caracteres), data de criação original, status e total de votos positivos.

Status

none → Pendente, planned → Planejada, completed → Concluída, not_planned e answered → Fechada.

Comentários

Importados sem encadeamento nas publicações (até 10.000 caracteres), com a data de criação e a contagem de votos positivos. Comentários vazios, sem texto ou imagens, são ignorados.

Imagens

Imagens HTTPS externas são copiadas e anexadas. Imagens /hc/ hospedadas no Zendesk permanecem como links no texto do conteúdo, pois o Zendesk bloqueia downloads do lado do servidor.

Votos

Votos positivos são importados; votos negativos são ignorados. Linhas individuais de votantes são criadas para usuários com e-mail ou ID externo (votantes excluídos do Zendesk ainda são contabilizados no total da publicação).

Seguidores

Importados como assinantes de solicitações, com a data original em que começaram a seguir, quando o usuário tem e-mail ou ID externo.

Não importados

Tickets do Support, artigos do Help Center, tags de conteúdo, votos negativos, tópicos não mapeados e registros de alterações.

Solução de problemas

  • "Não foi possível encontrar uma conta do Zendesk." Insira o subdomínio .zendesk.com em vez de um domínio personalizado.

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

  • "Este cliente OAuth não pode ler o fórum." Confirme se os escopos hc:read e users:read estão ativados no cliente.

  • Limites de taxa. O carregamento de tópicos é limitado a 10 solicitações por hora, e o início de uma importação é limitado a 3 por hora e 5 por dia.

Próximas etapas

Isso respondeu à sua pergunta?