Central de Ajuda do Zendesk
Conecte sua Central de Ajuda do Zendesk a um engine de localização. Ative a sincronização para as categorias, seções e artigos que você quer incluir, e o Lingo.dev traduz tudo para os idiomas da sua Central de Ajuda e envia as traduções de volta ao Zendesk.
Funciona com conteúdo do Zendesk Guide (Central de Ajuda): categorias, seções e artigos.
O Zendesk está disponível com o plano Enterprise. Se a página de conexão mostrar Zendesk não está no seu plano, fale com a gente e a gente resolve isso.
Antes de começar#
Você vai precisar de três coisas:
Acesso de administrador ao Zendesk. A conexão usa OAuth, e a conta que autoriza precisa ter permissão para gerenciar o conteúdo da Central de Ajuda. Cada tradução que o Lingo.dev grava fica atribuída a essa conta no Zendesk, então conecte com uma conta de serviço compartilhada se você preferir não deixar o nome de uma pessoa da equipe em toda a Central de Ajuda.
Seus idiomas de destino habilitados no Zendesk. O Lingo.dev oferece exatamente os idiomas que sua Central de Ajuda tem habilitados — e nenhum outro. Ative-os no Zendesk em Knowledge -> Settings -> Language settings.
Os idiomas adicionados em Admin Center -> Account -> Appearance -> Localization ficam em uma lista separada e NÃO ativam um idioma da Central de Ajuda.
Para ver exatamente o que sua Central de Ajuda aceita, abra
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsonenquanto estiver em uma sessão de administrador. Tudo o que esse endpoint listar é o que o Lingo.dev vai oferecer.Um engine de localização. É o glossário, a voz da marca e as regras dele que vão orientar as traduções da sua Central de Ajuda.
O idioma de origem não é algo que você escolhe: o Lingo.dev lê o idioma padrão da sua Central de Ajuda no Zendesk a cada execução.
A Central de ajuda já está traduzida?
A primeira sincronização mantém as traduções que já estão no Zendesk. Para cada item e idioma, se o Zendesk já tiver uma tradução completa, o Lingo.dev a mantém como está e traduz apenas o que falta. Para substituir uma tradução existente, use Traduzir novamente.
Conecte sua Central de Ajuda#
Abra a integração
Vá até Studio -> All integrations e clique em Connect no card do Zendesk.
Preencher o formulário
| Campo | O que preencher |
|---|---|
| Nome | Como chamar esta conexão para você diferenciar suas Centrais de ajuda |
| Central de Ajuda | Apenas o subdomínio da sua URL do Zendesk. Para https://acme.zendesk.com, informe acme — o formulário mostra .zendesk.com depois |
| Engine | O engine de localização cujos glossário, regras e voz da marca essas traduções seguem |
| Modo | Draft grava as traduções como rascunhos não publicados; Publish as coloca no ar assim que são gravadas. Veja a diferença entre Draft e Publish abaixo |
Clique em Continue to Zendesk.
Autorize no Zendesk
O Zendesk vai pedir que você conceda acesso ao Lingo.dev. Clique em Allow. Nada é criado até você fazer isso: se clicar em Deny, você volta ao formulário sem nenhuma conexão criada.
Escolha os idiomas
De volta ao Lingo.dev, você verá os idiomas habilitados na sua Central de Ajuda, menos o idioma padrão. Todos vêm pré-selecionados. Desmarque os que você não quiser e clique em Save and open.
Se a Central de Ajuda tiver apenas um idioma, o Lingo.dev vai pedir que você adicione outro no Zendesk primeiro.
Escolha o que será traduzido#
A página da conexão tem cinco abas: Categorias, Seções, Artigos, Workflow runs e Configurações.
As três primeiras listam o conteúdo daquele tipo, uma linha por item, com um campo de busca por nome e ID. O nome de cada linha tem link para esse item no Zendesk, para você conferir exatamente o que está selecionando. Cada linha tem um botão de Sync: ative-o e, a partir daí, esse item passa a fazer parte da conexão. A mudança é salva no momento em que você ativa o botão; não existe botão de salvar. O botão no cabeçalho da tabela ativa ou desativa o Sync para tudo da lista.
As caixas de seleção servem para execuções avulsas. Marque as linhas e dois botões vão aparecer: Queue sync (N) e Queue retranslation (N). Eles executam apenas essas linhas, sem mudar o que está com o Sync ativado.
Nada acontece em cascata
Ativar uma categoria traduz o nome e a descrição dela, não as seções e os artigos dentro dela. Para cobrir uma categoria inteira, ative também os artigos dela na aba Artigos. O botão do cabeçalho ativa tudo o que está listado, e você pode desmarcar o que não quiser.
O que é traduzido#
| Item | Campos traduzidos |
|---|---|
| Categoria | Título, descrição |
| Seção | Título, descrição |
| Artigo | Título, corpo |
O corpo dos artigos é traduzido como HTML, então formatação, links e mídias incorporadas se mantêm intactos no processo.
Sincronizar e retraduzir#
Dois botões, dois tipos de tarefa:
| Botão | O que faz | Quando usar |
|---|---|---|
| Sync | Traduz apenas o que mudou desde a última execução | Atualizações de rotina. É a opção que você vai usar na maior parte do tempo |
| Retranslate | Traduz tudo de novo, tenha mudado ou não | Depois de alterar o glossário, a voz da marca ou as regras do seu engine, quando quiser regenerar traduções já existentes |
Os dois ficam no cabeçalho da página, onde valem para tudo que está com a sincronização ativada, e também aparecem acima da tabela quando você marca linhas, onde valem só para essas linhas. Retraduzir pelo cabeçalho pede confirmação primeiro, 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 — é você quem decide quando traduzir.
Só é executada uma tarefa por vez em cada conexão. Se você pedir outra enquanto uma estiver em andamento, ela entra na fila atrás da atual; se a fila estiver cheia, tente de novo quando uma execução terminar.
Acompanhe uma execução#
A aba Workflow runs lista cada execução: quando começou, o que a disparou, quais idiomas ela cobriu, quanto tempo levou e qual foi o status. Uma execução ainda em andamento 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. Isso significa que nada mudou desde a última execução, o que é o resultado normal de sincronizar duas vezes sem editar nada no intervalo.
Onde as traduções ficam#
Cada tradução é vinculada ao mesmo artigo, seção ou categoria como uma versão por localidade — o próprio modelo de tradução do Zendesk. Seus leitores só precisam trocar o idioma na Central de Ajuda para acessá-la; 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 seus leitores até que alguém revise e publique no Zendesk. Este é o melhor modo para começar quando sua Central de Ajuda ainda não tem traduções e você está avaliando a qualidade.
No modo Publish, as traduções entram no ar assim que são gravadas.
Já existem traduções publicadas? Use Publish
No modo Draft, uma tradução que o Lingo.dev grava para um idioma que já está publicado vira um rascunho nesse idioma, e os leitores perdem a versão ao vivo até que alguém a publique de novo. Se a sua Central de Ajuda já oferece traduções, escolha Publish.
Você pode mudar o modo depois, na aba Configurações, junto com o engine e os idiomas de destino.
Configurações#
A guia Configurações mostra de qual Central de ajuda a conexão lê, quanto conteúdo o Sync tem e permite alterar o nome, os idiomas de destino, o engine e o modo. Cada alteração é salva assim que você a faz.
Se um idioma que você escolheu não estiver mais habilitado no Zendesk, a aba vai informar isso. As sincronizações pulam esse idioma, e a próxima mudança na lista vai removê-lo.
Desconexão#
Disconnect, na parte de baixo da aba Configurações, faz o Lingo.dev parar de ler da Central de Ajuda e de gravar nela. Isso remove a conexão, o histórico de execuções e o registro por artigo do que já foi traduzido. As traduções já gravadas continuam no Zendesk — elas pertencem à sua Central de Ajuda, não a nós.
Reconexão
Ao reconectar, começa um novo registro do que foi traduzido. A primeira sincronização após a reconexão mantém as traduções que já estão no Zendesk, inclusive as que o Lingo.dev escreveu antes, e traduz apenas o que falta.
Limites#
| Limite | Detalhe |
|---|---|
| Tipos de conteúdo | Categorias, seções e artigos. Tickets, macros, temas e posts da comunidade não estão incluídos. |
| Blocos de conteúdo | Artigos criados com blocos de conteúdo do Zendesk não são traduzidos |
| Acionadores | Somente manual — sem webhook, sem sincronização automática quando um artigo é alterado |
| Execuções simultâneas | Uma por conexão; novas solicitações entram na fila atrás dela |
| Idiomas de destino | Precisam estar habilitados na sua Central de Ajuda do Zendesk antes de o Lingo.dev poder oferecê-los |
| Conexões | Várias Centrais de ajuda por organização, cada uma conectada uma vez |
Solução de problemas#
A página de conexão mostra que o Zendesk não está no seu plano. O Zendesk está disponível com Enterprise. Fale com a gente e a gente resolve isso; enquanto isso, tudo o que já estiver conectado continua funcionando.
A página de conexão mostra que você não pode conectar isto. A conexão exige uma permissão que sua função não tem. Uma pessoa administradora da organização pode conectar ou conceder essa permissão a você.
Um idioma de destino não aparece na lista. Ative-o primeiro no Zendesk em Knowledge -> Settings -> Language settings e depois reabra a aba Configurações no Lingo.dev. A lista é lida do Zendesk todas as vezes.
Depois de clicar em Allow, o Lingo.dev pede para você adicionar um idioma no Zendesk. A Central de Ajuda está em um único idioma e não oferece nenhum outro ainda, então ainda não existe um idioma de destino 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 você quer incluir nas abas Categorias, Seções e Artigos.
As traduções não aparecem na Central de Ajuda. Verifique se a conexão está no modo Draft. Os rascunhos existem no Zendesk, mas continuam invisíveis para os leitores até serem publicados.