Ligue o seu Centro de Ajuda do Zendesk a um motor de localização. Escolha as categorias, secções e artigos que quer incluir, e o Lingo.dev traduz tudo para os seus idiomas de destino e envia as traduções de volta para o Zendesk.
Funciona com conteúdos do Zendesk Guide (Centro de Ajuda): categorias, secções e artigos.
A integração com o Zendesk é ativada por organização. Se não a vir em Definições -> Integrações, fale connosco e tratamos da ativação.
Antes de começar#
Vai precisar de três coisas:
Acesso de administrador ao Zendesk. A ligação usa OAuth, e a conta que autoriza tem de ter permissão para gerir o conteúdo do Centro de Ajuda.
Os seus idiomas de destino têm de estar ativados no Zendesk. O Zendesk só aceita traduções para um idioma que o Help Center já reconheça. Ative-os no Zendesk em Knowledge -> Settings -> Language settings.
Os idiomas adicionados em Admin Center -> Account -> Appearance -> Localization fazem parte de uma lista separada e NÃO ativam um idioma do Help Center.
Para ver exatamente que idiomas o seu Help Center aceita, abra
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsoncom sessão iniciada como administrador. Tudo o que esse endpoint listar é o que pode selecionar no Lingo.dev.Um motor de localização. O glossário, a voz da marca e as regras desse motor definem o que as traduções do seu Centro de Ajuda vão seguir.
Os códigos de idioma têm de corresponder exatamente aos do Zendesk
O Zendesk usa códigos como en-us e de-de. Se o idioma de origem do seu Centro de Ajuda aparecer como en-us, escolha English (United States) no Lingo.dev, e não apenas English — são dois idiomas diferentes (en-US vs en), e esta diferença é, de longe, o motivo mais comum para uma ligação falhar.
Ligue o seu Centro de Ajuda#
Abra a integração
Vá a Definições -> Integrações e clique em Connect em Zendesk.
Preencha o formulário
| Campo | O que introduzir |
|---|---|
| Subdomínio | Apenas o identificador do seu URL do Zendesk. Em https://acme.zendesk.com, introduza acme — sem https://, sem .zendesk.com |
| Motor | O motor de localização que vai traduzir este conteúdo |
| Idioma de origem | O idioma em que os seus artigos estão escritos, exatamente como o Zendesk o apresenta |
| Idiomas de destino | Os idiomas para os quais quer traduzir. Todos têm de estar primeiro ativados no Zendesk |
| Guardar como rascunhos | Deixe esta opção ativa para guardar as traduções como rascunhos não publicados. Desative-a para publicar de imediato |
Autorize no Zendesk
Será redirecionado para o Zendesk. Clique em Allow. Depois volta à página do Zendesk no Lingo.dev com a ligação ativa.
Escolha o que é traduzido#
A página do Zendesk tem dois separadores: Content e Runs.
O separador Content lista tudo o que existe no seu Centro de Ajuda — categorias, secções e artigos, tudo na mesma tabela. Use os filtros acima (All, Categories, Sections, Articles) para reduzir a lista e as caixas de seleção para escolher o que quer incluir. O nome de cada linha tem ligação para esse item no Zendesk, para que possa confirmar exatamente o que está a selecionar.
Selecionar uma categoria não seleciona automaticamente o que está dentro dela
Categorias, secções e artigos são escolhidos de forma independente. Se quiser traduzir uma categoria inteira, selecione a categoria e as respetivas secções e artigos.
Guarde antes de sincronizar. Uma nova ligação começa com um âmbito vazio e a sincronização usa o âmbito guardado — não o que estiver atualmente assinalado no ecrã. Se sincronizar antes de guardar o que quer que seja, a execução volta sem nada para traduzir. Clique em Guardar e só depois traduza.
O que é traduzido#
| Item | Campos traduzidos |
|---|---|
| Categoria | Título, descrição |
| Secção | Título, descrição |
| Artigo | Título, corpo |
O corpo dos artigos é traduzido em HTML, por isso a formatação, as ligações e os conteúdos multimédia incorporados mantêm-se intactos ao longo de todo o processo.
Sincronizar e retraduzir#
Dois botões, duas ações diferentes:
| Botão | O que faz | Quando usar |
|---|---|---|
| Sync | Traduz apenas o que mudou desde a última execução | Atualizações de rotina. É esta a opção certa na maior parte dos casos |
| Retranslate | Traduz novamente tudo o que está dentro do âmbito, a partir do zero | Depois de alterar o glossário, a voz da marca ou as regras do seu motor, quando quiser regenerar traduções existentes |
Ambos estão disponíveis em dois locais: no cabeçalho da página, onde abrangem todo o âmbito guardado, e acima da tabela de conteúdo, onde abrangem apenas as linhas que selecionou.
As execuções são manuais. Editar um artigo no Zendesk não inicia uma execução — é quem a utiliza que decide quando traduzir.
Só pode haver uma execução em curso de cada vez. Enquanto houver uma execução ativa, ambos os botões ficam desativados.
Acompanhe uma execução#
O separador Runs lista todas as execuções com o respetivo estado, o que as desencadeou, quando começaram e quanto tempo demoraram. Se uma execução ainda estiver em curso, pode cancelá-la diretamente na lista.
Abra uma execução para ver os detalhes: em que fase está — a importar conteúdo do Zendesk, a traduzir, a escrever de volta —, bem como o progresso geral e o progresso por idioma de destino, para poder ver, por exemplo, que o alemão já terminou enquanto o japonês ainda está em curso.
Uma execução que termina como nada para traduzir não é uma falha. Significa que tudo o que está no âmbito já corresponde às respetivas traduções, o que é o resultado normal de sincronizar duas vezes sem editar nada pelo meio.
Onde ficam as traduções#
Cada tradução fica associada ao mesmo artigo, secção ou categoria, como uma versão por idioma — o próprio modelo de tradução do Zendesk. Os seus leitores só têm de mudar de idioma no Centro de Ajuda para a ver; nada é duplicado nem movido.
A quem são atribuídas as traduções
No Zendesk, cada tradução é atribuída à conta que autorizou a ligação, e não à pessoa que clicou em Sincronizar. Se preferir não ter o nome de um colega em todo o Centro de Ajuda, faça a ligação com uma conta de serviço partilhada.
Rascunhos vs. publicados#
Com Guardar como rascunhos ativado, as traduções chegam ao Zendesk como rascunhos não publicados. Nada fica visível para os seus clientes até alguém fazer a revisão e publicar no Zendesk. Esta é a predefinição mais segura e a melhor opção enquanto estiver a avaliar a qualidade da tradução.
Se desativar esta opção, as traduções são publicadas assim que forem gravadas.
Pode alterar isto mais tarde em Definições -> Integrações -> Zendesk, juntamente com o seu motor e os idiomas de destino.
Desligar a ligação#
Ao desligar, remove a ligação, o respetivo histórico de execuções e o registo por artigo do que já foi traduzido. As traduções já escritas mantêm-se no Zendesk — pertencem ao seu Centro de Ajuda, não a nós.
Voltar a ligar é recomeçar do zero
Como o estado de sincronização por artigo desaparece, a primeira sincronização depois de voltar a ligar trata todo o seu âmbito como novo e traduz tudo novamente — com o custo que isso implica. Desligue apenas quando quiser mesmo parar, não para resolver problemas.
Limites#
| Limite | Detalhe |
|---|---|
| Tipos de conteúdo | Categorias, secções e artigos. Tickets, macros, temas e publicações da comunidade não estão incluídos |
| Blocos de conteúdo | Os artigos criados a partir de blocos de conteúdo do Zendesk não são traduzidos |
| Acionadores | Apenas manual — sem webhook nem sincronização automática quando um artigo é alterado |
| Execuções em simultâneo | Uma por ligação |
| Idiomas de destino | Têm de estar ativados no seu Centro de Ajuda do Zendesk antes de uma execução poder escrever neles |
Resolução de problemas#
A ligação falha logo depois de clicar em Allow. Quase sempre é uma incompatibilidade de idioma: o idioma de origem que selecionou não existe no Help Center. Abra https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, tome nota do código exato apresentado e volte a ligar com esse código.
Falta um idioma de destino no menu pendente. Ative-o primeiro no Zendesk em Knowledge -> Settings -> Language settings e, em seguida, volte a abrir a configuração no Lingo.dev.
A sincronização indica que não há nada para traduzir. Ou o seu âmbito guardado está vazio — selecione conteúdo no separador Conteúdo e clique em Guardar — ou tudo o que está incluído já está atualizado.
As traduções não aparecem no Centro de Ajuda. Verifique se a ligação está em modo de rascunho. Os rascunhos existem no Zendesk, mas permanecem invisíveis para os clientes até serem publicados.
