Conecte sua Central de Ajuda do Zendesk a um engine de localização. Escolha as categorias, seções e artigos que quer incluir, e a Lingo.dev traduz tudo para seus idiomas de destino e grava as traduções de volta no Zendesk.
Funciona com conteúdo do Zendesk Guide (Central de Ajuda): categorias, seções e artigos.
A integração com o Zendesk é habilitada por organização. Se ela não aparecer em Settings -> Integrations, fale com a gente e ativamos para você.
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.
Seus idiomas de destino precisam estar ativados no Zendesk. O Zendesk só aceita traduções para um idioma que a Central de Ajuda já reconhece. Ative esses idiomas 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 quais idiomas a sua Central de Ajuda aceita, abra
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsonenquanto estiver conectado como admin. Tudo o que aparecer nesse endpoint é o que você pode selecionar no Lingo.dev.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.
Os códigos de idioma precisam corresponder exatamente aos do Zendesk
O Zendesk usa códigos como en-us e de-de. Se o idioma de origem da sua Central de Ajuda estiver listado 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 essa divergência é o motivo mais comum para uma conexão falhar.
Conecte sua Central de Ajuda#
Abra a integração
Vá até Settings -> Integrations e clique em Connect em Zendesk.
Preencher o formulário
| Campo | O que preencher |
|---|---|
| Subdomínio | Apenas o identificador da sua URL do Zendesk. Para https://acme.zendesk.com, preencha com acme — sem https://, sem .zendesk.com |
| Engine | O engine de localização que vai traduzir esse conteúdo |
| Idioma de origem | O idioma em que seus artigos foram escritos, exatamente como aparece no Zendesk |
| Idiomas de destino | Os idiomas para os quais traduzir. Todos eles precisam estar habilitados no Zendesk primeiro |
| Salvar como rascunhos | Deixe ativado para gravar as traduções como rascunhos não publicados. Desative para publicar imediatamente |
Autorize no Zendesk
Você será redirecionado para o Zendesk. Clique em Allow. Depois, você volta para a página do Zendesk no Lingo.dev com a conexão ativa.
Escolha o que será traduzido#
A página do Zendesk tem duas abas: Content e Runs.
A aba Content lista tudo o que existe na sua Central de Ajuda — categorias, seções e artigos em uma única tabela. Use os filtros acima dela (All, Categories, Sections, Articles) para refinar a lista e as caixas de seleção para escolher o que quer incluir. O nome de cada linha tem link para o item correspondente no Zendesk, para você conferir exatamente o que está selecionando.
Selecionar uma categoria não seleciona o que está dentro dela
Categorias, seções e artigos são escolhidos separadamente. Se você quiser traduzir uma categoria inteira, selecione a categoria e também as seções e os artigos dela.
Salve antes de sincronizar. Uma nova conexão começa com um escopo vazio, e a sincronização usa o escopo salvo — não o que está marcado na tela naquele momento. Se você sincronizar antes de salvar, a execução volta sem nada para traduzir. Clique em Salvar e depois traduza.
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 novamente tudo o que está no escopo, do zero | Depois de alterar o glossário, a voz da marca ou as regras do seu engine, quando quiser regenerar traduções já existentes |
As duas opções ficam disponíveis em dois lugares: no cabeçalho da página, onde abrangem todo o escopo salvo, e acima da tabela de conteúdo, onde abrangem apenas as linhas selecionadas.
As execuções são manuais. Editar um artigo no Zendesk não inicia uma execução — é você quem decide quando traduzir.
Só uma execução pode ficar em andamento por vez. Enquanto uma execução estiver ativa, os dois botões ficam desabilitados.
Acompanhe uma execução#
A aba Runs lista todas as execuções com status, origem do acionamento, horário de início e duração. Se uma execução ainda estiver em andamento, você pode cancelá-la diretamente pela lista.
Abra uma execução para ver os detalhes: em que etapa ela está — buscando conteúdo do Zendesk, traduzindo, gravando de volta — além do progresso geral e do progresso por idioma de destino, para que você veja, por exemplo, que o alemão já terminou enquanto o japonês ainda está em andamento.
Uma execução que termina com nada para traduzir não é uma falha. Isso significa que tudo no escopo já corresponde às respectivas traduções, o que é o resultado normal de sincronizar duas vezes sem editar nada entre uma e outra.
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.
A quem as traduções são atribuídas
No Zendesk, toda tradução é criada pela conta que autorizou a conexão, não pela pessoa que clicou em Sincronizar. Se você preferir não deixar o nome de um membro da equipe em toda a Central de Ajuda, conecte usando uma conta de serviço compartilhada.
Rascunhos vs. publicados#
Com Salvar como rascunhos ativado, as traduções chegam ao Zendesk como rascunhos não publicados. Nada fica visível para seus clientes até que alguém faça a revisão e publique no Zendesk. Esse é o padrão mais seguro e a melhor opção enquanto você estiver avaliando a qualidade da tradução.
Desative essa opção e as traduções serão publicadas assim que forem gravadas.
Você pode alterar isso depois em Settings -> Integrations -> Zendesk, junto com seu engine e os idiomas de destino.
Desconexão#
Ao desconectar, você remove a conexão, o histórico de execuções e o registro por artigo do que já foi traduzido. As traduções que já foram gravadas continuam no Zendesk — elas pertencem à sua Central de Ajuda, não a nós.
Reconectar faz tudo recomeçar do zero
Como o estado de sincronização por artigo deixa de existir, a primeira sincronização após reconectar trata todo o seu escopo como novo e traduz tudo outra vez — com o custo que isso implica. Desconecte quando quiser parar, não para solucionar problemas.
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 |
| Idiomas de destino | Precisam estar habilitados na sua Central de Ajuda do Zendesk antes que uma execução possa gravar neles |
Solução de problemas#
A conexão falha logo depois que você clica em Allow. Quase sempre isso acontece por incompatibilidade de idioma: o idioma de origem que você selecionou não existe na Central de Ajuda. Abra https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, anote o código exato exibido ali e reconecte usando esse código.
Um idioma de destino não aparece no menu suspenso. Primeiro, ative-o no Zendesk em Knowledge -> Settings -> Language settings. Depois, reabra a configuração no Lingo.dev.
A sincronização diz que não há nada para traduzir. Ou o escopo salvo está vazio — selecione conteúdo na aba Conteúdo e clique em Salvar — ou tudo nele já está atualizado.
As traduções não aparecem na Central de Ajuda. Verifique se a conexão está no modo rascunho. Os rascunhos existem no Zendesk, mas continuam invisíveis para os clientes até serem publicados.
