Centro de Ajuda do Zendesk
Ligue o seu Centro de Ajuda do Zendesk a um motor de localização. Ative a sincronização para as categorias, secções e artigos que quer incluir, e a Lingo.dev traduz esse conteúdo para os idiomas do seu Centro de Ajuda e escreve as traduções de volta no Zendesk.
Funciona com conteúdos do Zendesk Guide (Centro de Ajuda): categorias, secções e artigos.
O Zendesk está disponível com o plano Enterprise. Se a página Connect indicar Zendesk is not on your plan, contacte-nos e tratamos disso.
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 precisa de permissão para gerir o conteúdo do Centro de Ajuda. Cada tradução que a Lingo.dev escreve fica atribuída a essa conta no Zendesk, por isso ligue com uma conta de serviço partilhada se preferir não ter o nome de um colega em todo o Centro de Ajuda.
Os seus idiomas de destino ativados no Zendesk. A Lingo.dev disponibiliza exatamente os idiomas que o seu Centro de Ajuda tem ativados, e mais nenhuns. 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 o que o seu Centro de Ajuda 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 a Lingo.dev vai disponibilizar.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.
O idioma de origem não é algo que escolha: a Lingo.dev lê o idioma predefinido do seu Centro de Ajuda no Zendesk em cada execução.
O Centro de Ajuda já está traduzido?
A primeira sincronização mantém as traduções que já existem no Zendesk. Para cada item e idioma, se o Zendesk já tiver uma tradução completa, a Lingo.dev deixa-a como está e traduz apenas o que falta. Para substituir uma tradução existente, use Retraduzir.
Ligue o seu Centro de Ajuda#
Abra a integração
Vá a Studio -> All integrations e clique em Connect no cartão do Zendesk.
Preencha o formulário
| Campo | O que introduzir |
|---|---|
| Nome | Nome a dar a esta ligação para distinguir os seus Centros de Ajuda |
| Centro de Ajuda | Apenas o subdomínio do seu URL do Zendesk. Para https://acme.zendesk.com, introduza acme; o formulário mostra .zendesk.com a seguir |
| Motor | O motor de localização cujo glossário, regras e voz da marca estas traduções seguem |
| Modo | Draft escreve as traduções como rascunhos não publicados; Publish publica-as assim que são escritas. Veja Rascunhos vs Publicadas abaixo |
Clique em Continue to Zendesk.
Autorize no Zendesk
O Zendesk pede-lhe que conceda acesso à Lingo.dev. Clique em Allow. Nada é criado até o fazer: clique em Deny e volta ao formulário sem que seja criada qualquer ligação.
Escolha os idiomas
De volta à Lingo.dev, verá os idiomas que o seu Centro de Ajuda tem ativados, excluindo o idioma predefinido. Todos vêm pré-selecionados. Desmarque os que não quiser e clique em Save and open.
Se o Centro de Ajuda tiver apenas um idioma, a Lingo.dev pede-lhe primeiro que adicione outro no Zendesk.
Escolha o que é traduzido#
A página da ligação tem cinco separadores: Categories, Sections, Articles, Workflow runs e Settings.
Os primeiros três listam o conteúdo desse tipo, uma linha por item, com uma caixa de pesquisa por nomes e IDs. O nome de cada linha liga a esse item no Zendesk, para que possa confirmar o que está a escolher. Cada linha tem um interruptor Sync: ative-o e esse item passa a fazer parte da ligação a partir desse momento. A alteração é guardada no momento em que muda o interruptor; não existe botão Guardar. O interruptor no cabeçalho da tabela ativa ou desativa a sincronização para tudo o que está na lista.
As caixas de seleção servem para execuções pontuais. Se selecionar linhas, aparecem dois botões, Queue sync (N) e Queue retranslation (N), que executam apenas essas linhas sem alterar o que tem a sincronização ativada.
Nada acontece em cascata
Ativar uma categoria traduz o respetivo nome e descrição, não as secções e os artigos que estão dentro dela. Para incluir uma categoria inteira, ative também os seus artigos no separador Articles. O interruptor do cabeçalho ativa tudo o que está listado, e pode desmarcar o que não quiser.
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 tudo novamente, tenha mudado ou não | Depois de alterar o glossário, a voz da marca ou as regras do seu motor, quando quiser regenerar traduções existentes |
Ambos ficam no cabeçalho da página, onde abrangem tudo o que tem a sincronização ativada, e aparecem por cima da tabela quando seleciona linhas, onde abrangem apenas essas linhas. Retranslate a partir do cabeçalho pede-lhe primeiro confirmação, porque cada item selecionado e cada idioma são cobrados.
As execuções são manuais. Editar um artigo no Zendesk não inicia uma execução — é quem a utiliza que decide quando traduzir.
Há apenas uma execução de cada vez por ligação. Se pedir outra enquanto uma estiver em curso, entra na fila atrás da anterior; se a fila estiver cheia, tente novamente quando uma execução terminar.
Acompanhe uma execução#
O separador Workflow runs lista todas as execuções: quando começaram, o que as desencadeou, que idiomas abrangeram, quanto tempo demoraram e o respetivo estado. Uma execução que ainda está em curso tem um botão Stop. Abra uma linha para ver o resultado por idioma.
Uma execução que termina como Up to date não é uma falha. Significa que nada mudou desde a última execução, 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.
Rascunhos vs. publicados#
No modo Draft, as traduções chegam ao Zendesk como rascunhos não publicados. Nada fica visível para os seus leitores até alguém as rever e publicar no Zendesk. Este é o modo ideal para começar quando o seu Centro de Ajuda ainda não tem traduções e está a avaliar a qualidade.
No modo Publish, as traduções ficam disponíveis assim que são escritas.
Já tem traduções publicadas? Use Publish
No modo Draft, uma tradução que a Lingo.dev escreve para um idioma que já está publicado passa a rascunho nesse idioma, e os leitores deixam de ver a versão publicada até alguém a voltar a publicar. Se o seu Centro de Ajuda já disponibiliza traduções, escolha Publish.
Pode alterar o modo mais tarde no separador Settings, juntamente com o seu motor e os idiomas de destino.
Definições#
O separador Definições mostra de que Centro de Ajuda esta ligação lê, quanto conteúdo tem a sincronização ativa e permite-lhe alterar o nome, os idiomas de destino, o motor e o modo. Cada alteração é guardada à medida que a faz.
Se um idioma que escolheu deixar de estar ativado no Zendesk, o separador indica-o. As sincronizações ignoram esse idioma e a alteração seguinte à lista remove-o.
Desligar a ligação#
Disconnect no fundo do separador Settings faz com que a Lingo.dev deixe de ler do Centro de Ajuda e de escrever nele. 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 permanecem no Zendesk — pertencem ao seu Centro de Ajuda, não a nós.
A restabelecer ligação
Ao restabelecer a ligação, inicia-se um novo registo do que foi traduzido. A primeira sincronização após restabelecer a ligação mantém as traduções que já existem no Zendesk, incluindo as que a Lingo.dev escreveu anteriormente, e traduz apenas o que falta.
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; os pedidos seguintes entram na fila atrás dela |
| Idiomas de destino | Têm de estar ativados no seu Centro de Ajuda do Zendesk antes de a Lingo.dev os poder disponibilizar |
| Ligações | Vários Centros de Ajuda por organização, cada um ligado uma única vez |
Resolução de problemas#
A página Connect indica que o Zendesk não está no seu plano. O Zendesk está disponível com Enterprise. Contacte-nos e tratamos disso; entretanto, tudo o que já está ligado continua a funcionar.
A página Connect indica que não pode ligar isto. A ligação requer uma permissão que a sua função não tem. Um administrador da organização pode ligar, ou atribuir-lhe essa permissão.
Falta um idioma de destino na lista. Ative-o primeiro no Zendesk em Knowledge -> Settings -> Language settings e depois volte a abrir o separador Settings na Lingo.dev. A lista é lida do Zendesk sempre que abre o separador.
Depois de clicar em Allow, a Lingo.dev pede-lhe para adicionar um idioma no Zendesk. O Centro de Ajuda está escrito numa única língua e não oferece nenhuma outra, por isso ainda não há nada para traduzir.
Uma sincronização termina como Up to date. Ou nada mudou desde a última execução, ou ainda não há nada com a sincronização ativada. Ative o conteúdo que quer incluir nos separadores Categories, Sections e Articles.
As traduções não aparecem no Centro de Ajuda. Verifique se a ligação está no modo Draft. Os rascunhos existem no Zendesk, mas continuam invisíveis para os leitores até serem publicados.