Central de Ajuda do Zendesk
Traduza categorias, seções e artigos da Central de Ajuda nas versões de idioma já existentes, com controle manual da sincronização e da publicação.
Traduza o conteúdo da Central de Ajuda sem sair do Zendesk. A conexão do Lingo.dev lê as categorias, seções e artigos selecionados no idioma padrão da Central de Ajuda, traduz o conteúdo com um engine de localização e grava as versões nos idiomas de destino nesses mesmos itens.
No menu de navegação do Studio 2.5, acesse Studio 2.5 → Integrações em vez de Configurações → Integrações. Os links de conexão e configuração existentes continuam funcionando.
As execuções são manuais. Quando um artigo mudar, inicie a sincronização do conteúdo que deseja atualizar. Antes da primeira gravação, escolha se as traduções serão salvas como rascunho ou publicadas: gravar como rascunho uma versão de destino já publicada pode deixá-la indisponível para os leitores até que seja publicada novamente.
Prepare o acesso e os idiomas da Central de Ajuda #
A integração com a Central de Ajuda do Zendesk está disponível no plano Enterprise. Consulte os preços para conferir a disponibilidade atual. Em Configurações → Integrações, a indicação Indisponível no seu plano aparece ao lado do Zendesk quando a organização precisa de um plano que dê acesso ao recurso.
Use uma conta de administrador do Zendesk com acesso ao conteúdo da Central de Ajuda. O acesso de administrador é necessário para registrar o webhook de publicação de artigos que coleta atividades para o Radar. As gravações são atribuídas à conta que autoriza o acesso, por isso use uma conta de serviço adequada se a equipe precisar de atribuição compartilhada. No Lingo.dev, você precisa ter permissão e acesso à conexão habilitado para a organização, além de acesso ao engine de localização selecionado.
Ative os idiomas de destino nas configurações de idioma da Central de Ajuda. A lista de idiomas de localização da conta do Zendesk é separada e não ativa as traduções da Central de Ajuda. Com a autorização adequada, o endpoint de somente leitura https://<subdomain>.zendesk.com/api/v2/help_center/locales.json lista a configuração de idiomas da Central de Ajuda.
A cada execução, o Lingo.dev consulta o idioma padrão da Central de Ajuda e o usa como origem. Você não seleciona outro idioma de origem no formulário de conexão.
Conecte e traduza o primeiro artigo #
- Abra Configurações → Integrações e selecione Conectar para o Zendesk. Informe um nome e o subdomínio da Central de Ajuda. Para
acme.zendesk.com, informeacme. - Prossiga para o Zendesk e autorize o acesso. A conexão só é criada quando a autorização é concluída com sucesso.
- No Studio, selecione a Central de Ajuda em Conectado e, em seguida, selecione Configurar.
- Escolha um engine de localização e um modo de gravação e selecione Continuar. Para esta primeira execução, selecione um idioma de destino entre os que estão ativados na Central de Ajuda. O idioma de origem não entra na seleção; se não houver outro disponível, ative um no Zendesk primeiro.
- Abra Artigos e ative a opção Sincronizar para um artigo com texto de origem estável. Aguarde a configuração ser salva, marque a caixa de seleção na linha desse artigo e escolha Enfileirar sincronização.
- Confira o resultado do workflow e o próprio artigo de destino no Zendesk. Verifique o título, o corpo, os links, o idioma e se ele está como rascunho ou publicado. Se o artigo deve estar publicado, abra também a URL disponível para os leitores.
A primeira sincronização aproveita as traduções completas já existentes sem sobrescrevê-las, preservando o texto e o estado de rascunho. Ela traduz o conteúdo que estiver faltando. Use Retraduzir quando a intenção for substituir uma tradução existente.
Selecione toda a área que deseja traduzir #
Categorias, seções e artigos têm tabelas separadas e opções de Sincronizar que permanecem salvas. Ativar uma categoria traduz o nome e a descrição dela, mas não ativa suas seções nem seus artigos. Selecione esses itens separadamente ao preparar uma área completa da Central de Ajuda.
| Item | Campos traduzidos |
|---|---|
| Categoria | Nome/título e descrição |
| Seção | Nome/título e descrição |
| Artigo | Título e corpo |
As caixas de seleção das linhas limitam uma ação pontual de Enfileirar sincronização ou Enfileirar retradução aos itens cuja opção Sincronizar já está ativada. Marcar uma linha não ativa a opção salva para ela. As ações do cabeçalho abrangem todo o escopo ativado na conexão. Antes de iniciar uma ação, confira quais itens ela vai processar.
O corpo dos artigos passa por processamento de HTML para reconstruir a formatação, os links e as mídias incorporadas. Durante a gravação, os links reconhecidos da Central de Ajuda podem ser adaptados ao idioma de destino. Confira esses links no resultado e verifique também se a página de destino traduzida existe. Links externos e elementos de navegação específicos do site precisam ser verificados separadamente.
Esta conexão não traduz tickets, macros, temas, publicações da comunidade nem artigos baseados em blocos de conteúdo do Zendesk. Ela localiza o conteúdo da Central de Ajuda; não é uma conexão para triagem de tickets de suporte.
Atualize o conteúdo alterado ou substitua-o #
Sincronizar compara o conteúdo de origem atual com o estado registrado e as traduções existentes. Use essa opção para atualizações de rotina na origem, conteúdo ausente e trabalho incompleto de uma execução anterior.
Retraduzir gera novamente os itens e idiomas selecionados, mesmo que o texto de origem não tenha mudado. Essa ação pode substituir edições humanas já aceitas. A ação geral do cabeçalho pede confirmação; nas ações das linhas selecionadas, você ainda precisa escolher o escopo de substituição desejado.
Só uma execução fica ativa por conexão. As solicitações adicionais entram na fila e, se ela estiver cheia, será preciso aguardar a liberação de capacidade. Execuções de workflow mostra os resultados; Parar cancela o trabalho que ainda pode ser interrompido. Um resultado indicado como atualizado significa que nenhuma alteração selecionada precisava ser processada, e não que a qualidade da tradução foi avaliada novamente.
Verifique o que os leitores podem ver #
O modo Publicar grava as traduções já publicadas. O modo Rascunho grava versões não publicadas em cada idioma para revisão no Zendesk. Ao atualizar uma versão de idioma já publicada no modo Rascunho, o novo rascunho pode deixá-la indisponível até que alguém a publique novamente. Antes de iniciar a atualização, avalie se essa interrupção é compatível com o lançamento.
Após a gravação, confira a URL de destino no idioma desejado. Compare o título e o corpo da página com a revisão do conteúdo de origem, acesse os links e procure trechos que ainda estejam no idioma de origem. Concluir uma execução de tradução é apenas uma etapa do lançamento; a aceitação e a publicação continuam sendo decisões editoriais.
Lide com alterações na origem e resultados parciais #
Na gravação, o item de origem é lido novamente. Se ele tiver sido alterado ou removido após o planejamento, o Lingo.dev ignora o destino. Quando a origem estiver pronta, execute outra sincronização manual para conciliar o novo estado.
Uma falha em um idioma não desfaz as gravações concluídas com sucesso nos demais. Confira os itens gravados, ignorados e com falha e tente novamente no escopo afetado. Forçar o processamento de toda a Central de Ajuda pode substituir textos já aceitos sem corrigir a causa original.
Se o resultado não aparecer, confira a seleção de itens, os idiomas ativados na Central de Ajuda, o acesso ao engine de localização, o modo de gravação, as exclusões por blocos de conteúdo e se houve mudanças na origem. Aproveitar uma tradução completa já existente não gera texto novo — esse é o comportamento esperado. Se um idioma de destino tiver sido desativado no Zendesk, as execuções vão ignorá-lo; atualize a seleção de idiomas de destino da conexão.
Se o Zendesk ficar temporariamente indisponível, tente novamente quando o serviço voltar. Use Reconectar na conexão existente se precisar restaurar a autorização; desconectar e criar uma nova conexão descarta o estado de sincronização.
Desconecte ou reconecte #
Altere os idiomas de destino, o engine de localização e o modo na aba Configurações da Central de Ajuda no Studio. Renomeie ou reconecte a conta em Configurações → Integrações. Use Reconectar para restaurar a autorização na conexão existente.
Desconectar interrompe as leituras e gravações e remove a conexão local, o histórico de execuções e o registro de sincronização de cada item. As traduções existentes no Zendesk permanecem. Criar uma nova conexão depois disso estabelece um novo ponto de partida: a primeira sincronização mantém as traduções completas já existentes e preenche o conteúdo ausente. Revogue a autorização no provedor separadamente quando o acesso precisar ser encerrado. Se necessário, restaure o texto publicado anteriormente diretamente no Zendesk.
Colete atividades no Radar #
A conexão também fornece atividades da Central de Ajuda ao Radar. Coletar traduções para medição explica a configuração dos eventos e como importar o histórico do provedor antes de executar uma medição histórica.
Se a tradução manual funcionar, mas as novas atividades de artigos não aparecerem, verifique o registro do webhook da conexão e a entrega dos eventos. A autorização pode ser concluída com sucesso mesmo quando uma conta sem privilégios de administrador não consegue registrar o webhook. Em Configurações → Integrações, use Reconectar na conexão existente do Zendesk e autorize o acesso como administrador. Publique um artigo de teste e confira o evento dele no Radar antes de depender da coleta automática.