Centro de Ajuda do Zendesk

Traduza categorias, secções e artigos do Centro de Ajuda para as respetivas versões nos idiomas existentes, com controlo manual da sincronização e da publicação.

Traduza o conteúdo do Centro de Ajuda sem sair do Zendesk. A ligação do Lingo.dev lê as categorias, secções e artigos selecionados no idioma predefinido do Centro de Ajuda, traduz o conteúdo através de um motor de localização e grava as versões nos idiomas de destino nesses mesmos elementos.

No menu de navegação do Studio 2.5, abra Studio 2.5 → Integrações em vez de Definições → Integrações. Os links existentes para ligação e configuração continuam a funcionar.

As execuções são manuais. Depois de alterar um artigo, inicie a sincronização do conteúdo que pretende atualizar. Antes da primeira gravação, escolha se as traduções devem ficar como rascunho ou ser publicadas: gravar como rascunho uma versão de destino já publicada pode torná-la indisponível para os leitores até voltar a ser publicada.

Preparar o acesso e os idiomas do Centro de Ajuda #

A integração com o Centro de Ajuda do Zendesk está disponível com o plano Enterprise. Consulte os preços para saber qual é a disponibilidade atual. Em Definições → Integrações, aparece Não disponível no seu plano junto ao Zendesk quando a organização precisa de um plano que permita o acesso.

Utilize uma conta de administrador do Zendesk com acesso ao conteúdo do Centro de Ajuda. São necessários privilégios de administrador para registar o webhook de publicação de artigos que recolhe atividade para o Radar. As gravações são atribuídas à conta que autoriza o acesso, pelo que deve utilizar uma conta de serviço adequada se a equipa precisar de uma atribuição partilhada. No Lingo.dev, precisa das permissões e do direito de acesso à ligação para a organização, bem como de acesso ao motor de localização selecionado.

Ative os idiomas de destino nas definições de idioma do Centro de Ajuda. A lista de localização ao nível da conta Zendesk é independente e não ativa as traduções do Centro de Ajuda. Com a autorização adequada, o endpoint só de leitura https://<subdomain>.zendesk.com/api/v2/help_center/locales.json apresenta a configuração de idiomas do Centro de Ajuda.

O Lingo.dev lê o idioma predefinido do Centro de Ajuda em cada execução e utiliza-o como idioma de origem. Não é possível selecionar outro idioma de origem no formulário de ligação.

Ligar e traduzir o primeiro artigo #

  1. Abra Definições → Integrações e selecione Ligar junto ao Zendesk. Introduza um nome e o subdomínio do Centro de Ajuda. Para acme.zendesk.com, introduza acme.
  2. Continue para o Zendesk e autorize o acesso. A ligação só é criada depois de a autorização ser concluída com êxito.
  3. No Studio, selecione o Centro de Ajuda em Ligados e, em seguida, selecione Configurar.
  4. Escolha um motor de localização e um modo de gravação e, em seguida, selecione Continuar. Para esta primeira execução, selecione um idioma de destino entre os que estão ativados no Centro de Ajuda. O idioma de origem é excluído; se não houver outro idioma disponível, ative primeiro um no Zendesk.
  5. Abra Artigos e ative o interruptor Sincronizar de um artigo cujo texto de origem esteja estável. Aguarde até a definição ser guardada, selecione a caixa de verificação na linha desse artigo e escolha Colocar sincronização na fila.
  6. Verifique o resultado do workflow e o próprio artigo de destino no Zendesk. Confirme o título, o corpo, as ligações, o idioma e se está em rascunho ou publicado. Se o artigo se destinar a publicação, abra também o URL apresentado aos leitores.

A primeira sincronização aproveita as traduções completas já existentes sem as substituir, preservando tanto o texto como o estado de rascunho. O conteúdo em falta é traduzido. Utilize Traduzir novamente quando pretender substituir deliberadamente uma tradução existente.

Selecionar toda a área que pretende traduzir #

As categorias, secções e artigos têm tabelas separadas e interruptores Sincronizar cuja definição é mantida entre execuções. Ativar uma categoria traduz o nome e a descrição dessa categoria; não ativa as respetivas secções ou artigos. Selecione-os separadamente ao preparar uma área completa do Centro de Ajuda.

ElementoCampos traduzidos
CategoriaNome/título e descrição
SecçãoNome/título e descrição
ArtigoTítulo e corpo

As caixas de verificação das linhas limitam as operações pontuais Colocar sincronização na fila ou Colocar nova tradução na fila aos elementos com o interruptor Sincronizar já ativado. Selecionar uma linha não ativa a definição permanente do respetivo interruptor. As ações do cabeçalho abrangem todos os elementos ativados na ligação. Antes de iniciar uma ação, confirme que seleção será processada.

O corpo dos artigos é processado em HTML para reconstruir a formatação, as ligações e os conteúdos multimédia incorporados. A gravação pode adaptar as ligações reconhecidas do Centro de Ajuda ao idioma de destino. Verifique essas ligações no resultado, incluindo se o destino traduzido existe. As ligações externas e a navegação específica do site continuam a exigir verificações próprias.

Esta ligação não traduz pedidos de apoio, macros, temas, publicações da comunidade nem artigos baseados em blocos de conteúdo do Zendesk. Localiza o conteúdo do Centro de Ajuda; não é uma ligação para triagem de pedidos de apoio.

Atualizar conteúdo alterado ou substituí-lo #

Sincronizar compara o conteúdo de origem atual com o estado registado e as traduções existentes. Utilize esta opção para atualizações de rotina do conteúdo de origem, conteúdo em falta e trabalho que tenha ficado incompleto numa execução anterior.

Traduzir novamente volta a gerar as traduções dos elementos e idiomas selecionados, mesmo que o texto de origem não tenha sido alterado. Esta opção pode substituir alterações humanas já aceites. A ação global do cabeçalho pede confirmação; nas ações sobre as linhas selecionadas, continua a ser necessário escolher o âmbito da substituição pretendida.

Só pode haver uma execução ativa por ligação. Os pedidos adicionais são colocados na fila e, se esta estiver cheia, é necessário aguardar até haver capacidade. Execuções de workflow apresenta os resultados; Parar cancela o trabalho que ainda pode ser interrompido. Um resultado que indique que o conteúdo está atualizado significa que nenhuma das alterações selecionadas precisava de processamento, e não que tenha sido feita uma nova avaliação da qualidade da tradução.

Verificar o que os leitores podem ver #

O modo Publicar grava as traduções como publicadas. O modo Rascunho grava versões por idioma ainda não publicadas, para revisão no Zendesk. Ao atualizar uma versão de idioma já publicada no modo Rascunho, o novo rascunho pode tornar essa versão indisponível até alguém voltar a publicá-la. Antes de iniciar a atualização, decida se essa interrupção é compatível com o lançamento.

Após a gravação, verifique o URL de destino no idioma pretendido. Compare o título e o corpo do artigo com a revisão do conteúdo de origem, siga as ligações e procure fragmentos no idioma de origem. Concluir a execução da tradução é apenas uma parte do lançamento; a aceitação e a publicação continuam a ser decisões editoriais.

Lidar com alterações na origem e resultados parciais #

A gravação volta a ler o elemento de origem. Se este tiver sido alterado ou removido após o planeamento, o Lingo.dev ignora o destino. Quando o conteúdo de origem estiver pronto, execute outra sincronização manual para reconciliar o novo estado.

Uma falha num idioma não anula as gravações bem-sucedidas nos restantes. Verifique os elementos gravados, ignorados e com falha e, em seguida, volte a tentar apenas no âmbito afetado. Forçar a operação em todo o Centro de Ajuda pode substituir texto já aceite sem corrigir a causa original.

Se faltar conteúdo no resultado, verifique a seleção de elementos, os idiomas ativados no Centro de Ajuda, o acesso ao motor de localização, o modo de gravação, as exclusões de blocos de conteúdo e se o conteúdo de origem foi alterado. Aproveitar uma tradução completa já existente não gera texto novo, por definição. Se um idioma de destino tiver sido desativado no Zendesk, as execuções ignoram-no; atualize a seleção de idiomas de destino da ligação.

Em caso de indisponibilidade temporária do Zendesk, volte a tentar quando o serviço estiver restabelecido. Utilize Voltar a ligar na ligação existente se for necessário restabelecer a autorização; desligar e criar uma nova ligação elimina o estado de sincronização.

Desligar ou voltar a ligar #

Altere os idiomas de destino, o motor de localização e o modo no separador Definições do Centro de Ajuda no Studio. Altere o nome da conta ou volte a ligá-la em Definições → Integrações. Utilize Voltar a ligar para restabelecer a autorização na ligação existente.

Desligar interrompe as leituras e gravações e remove a ligação local, o histórico de execuções e o registo de sincronização de cada elemento. As traduções existentes no Zendesk mantêm-se. Criar uma nova ligação posteriormente estabelece um novo estado de referência: a primeira sincronização mantém as traduções completas já existentes e preenche o conteúdo em falta. Revogue separadamente a autorização do fornecedor quando o acesso deva terminar. Quando necessário, restaure diretamente no Zendesk o texto publicado anteriormente.

Recolher atividade no Radar #

A ligação também fornece ao Radar a atividade do Centro de Ajuda. Recolher traduções para medição descreve a configuração dos eventos e como importar o histórico do fornecedor antes de executar uma medição histórica.

Se a tradução manual funcionar, mas não aparecer atividade de novos artigos, verifique o registo do webhook da ligação e a entrega dos eventos. A autorização pode ser concluída com êxito mesmo que uma conta sem privilégios de administrador não consiga registar o webhook. Em Definições → Integrações, utilize Voltar a ligar na ligação existente do Zendesk e autorize o acesso como administrador. Publique um artigo de teste e confirme o respetivo evento no Radar antes de passar a depender da recolha automática.