Passar para o conteúdo principal

Importar artigos públicos do Zendesk

Como migrar seu conteúdo de uma knowledge base Zendesk em minutos.

Escrito por Beth-Ann Sher

Como funciona

Você pode importar facilmente seu conteúdo público de ajuda do Zendesk para o Intercom, sem necessidade de código. Isso permite que você faça do Intercom sua única fonte de verdade para artigos de suporte e os use para alimentar os recursos de IA do Intercom.

O importador do Zendesk é construído sobre um pipeline de serviço robusto e resiliente que reduz significativamente erros e melhora a velocidade e confiabilidade da integração do seu conteúdo.

Uma vez que seus artigos estejam no Intercom, você pode:

  • Usá-los para alimentar o Fin AI Agent e o Copilot com respostas precisas e automatizadas.

  • Torná-los acessíveis na Inbox para que colegas compartilhem em conversas.

  • Destacá-los no seu Help Center para que os clientes possam se autoatender.

Dica: O importador também extrai metadados valiosos da fonte do Zendesk, como etiquetas e categorias, e os aplica como tags aos seus artigos no Intercom. Isso ajuda a organizar o conteúdo e aplicar regras para uma resolução de IA mais eficaz.

Nota: Isso tentará migrar todos os seus artigos de ajuda publicados do Zendesk. Para adicionar artigos específicos, recomendamos copiá-los e adicioná-los ao Knowledge Hub no Intercom individualmente.


Escolhendo como conectar seus dados

Você tem duas opções para gerenciar seu conteúdo Zendesk no Intercom.

Importar conteúdo

Escolha esta opção se quiser fazer do Intercom sua nova única fonte de verdade.

  • Isso realiza uma migração única de todos os seus artigos publicados do Zendesk para o Intercom.

  • Uma vez importados, a conexão é encerrada. Alterações feitas no Zendesk não serão refletidas no Intercom.

  • Você pode então editar e gerenciar esses artigos diretamente dentro do Intercom.

Sincronizar conteúdo

Escolha esta opção para sincronizar uma versão continuamente atualizada e somente leitura do seu conteúdo. O Zendesk permanece sua fonte de verdade.

  • Isso é ideal para alimentar o Fin AI Agent com sua knowledge base existente sem migrar.

  • A sincronização é confiável e transparente, garantindo que o Fin sempre tenha o conteúdo mais recente.

  • Você continuará a editar e gerenciar seus artigos no Zendesk.


Antes de importar

Antes de começar, recomendamos ativar a indexação para motores de busca nas configurações do seu Help Center para evitar atrasos na aparição dos seus artigos nos resultados de busca. Você pode fazer isso indo em Configurações > Help Center e clicando em "configurar e estilizar":

Você encontrará a opção para ativar a busca indexada em Geral > Privacidade:


Conectando via token API

Use este método para importar seu conteúdo Zendesk usando um token API seguro.

Passo 1: Gere um token API do Zendesk

Primeiro, gere um token API no seu Zendesk Admin Center.

  1. No Zendesk, vá para o Admin Center.

  2. Navegue até Apps and integrations > APIs > Zendesk API.

  3. Clique na aba API token e clique em Add API token.

  4. Dê um nome descritivo ao token (ex.: "Intercom Integration") e copie-o. Copie e salve em local seguro. O Zendesk não mostrará novamente.

Passo 2: Conecte o Zendesk no Intercom

  1. No seu workspace do Intercom, vá para Knowledge > Sources.

  2. Em Public articles, encontre Zendesk e clique em Sync or Import.

  3. Digite os detalhes da sua conexão:

    • Digite o Subdomínio: Forneça seu subdomínio Zendesk (ex.: mydomain.zendesk.com).

    • Escolha a Autenticação: Selecione API Token para conectar.

    • Clique em Connect.

    • Você pode opcionalmente ativar "Sincronizar artigos para usuários autenticados" para incluir conteúdo visível apenas para usuários autenticados.

      Quando o processo de Connect terminar, você pode passar para o próximo passo.

  4. Após o Zendesk conectar ao Intercom, você pode usar a aba Metadata para pré-filtrar exatamente qual conteúdo do Zendesk deve ser trazido para o Intercom. Escolha entre campos principais ou tags personalizadas para estender seu filtro e segmentação. Clique em + Add Filter para restringir o conteúdo com base em critérios específicos como Categorias, Etiquetas ou Carimbos de data/hora. Se pular esta etapa, o importador trará todo o conteúdo elegível por padrão.

  5. Use a aba Target para decidir onde seu conteúdo importado será usado no Intercom.

    • Fin AI Agent: Ative para usar artigos Zendesk para respostas automatizadas ao cliente.

    • Copilot: Ative para fornecer respostas sugeridas aos seus colegas.

    • Help Center: Ative se quiser publicar o conteúdo Zendesk diretamente no seu Help Center do Intercom.

    • Controle de Público: Escolha quais públicos específicos (ex.: "Plano Enterprise" ou "Público do Reino Unido") podem ver este conteúdo.

  6. Faça uma verificação final da sua configuração antes de iniciar a importação.

    • Digite um nome personalizado para a importação para identificá-la em sua lista Knowledge (por exemplo, "Zendesk - Public Support").

    • Verifique o resumo para ver exatamente quantos artigos e campos estão sendo importados com base nos seus filtros de metadata.

    • Verifique novamente se suas configurações de Available in e Audience estão corretas.

  7. Clique em Sync and set live para iniciar a transformação do seu conteúdo Zendesk em artigos Intercom.


Conectando via OAuth

Passo 1: Autenticar Zendesk

Para importar seu conteúdo, você primeiro precisa autenticar sua fonte Zendesk:

  1. Digite seu subdomain Zendesk (por exemplo, mydomain.zendesk.com).

  2. Selecione OAuth como seu método de autenticação.

  3. Clique em Connect.

Uma vez estabelecida a conexão, você pode opcionalmente ativar Sync articles for signed-in users para incluir conteúdo visível apenas para clientes autenticados. Clique em Next quando a conexão for bem-sucedida.

Seu subdomain é a parte do seu URL antes de .zendesk.com. Por exemplo, se seu URL for https://help.zendesk.com, seu subdomain é help.

Passo 2: Metadata

Após o Zendesk conectar ao Intercom, use a aba Metadata para pré-filtrar exatamente qual conteúdo deve ser trazido para o Intercom:

  • Escolha entre campos principais ou tags personalizadas para restringir sua importação.

  • Clique em + Add Filter para selecionar conteúdo com base em critérios específicos como Categories, Labels ou Timestamps.

Se você pular esta etapa, o importador trará todo o conteúdo elegível por padrão.

Passo 3: Target

Use a aba Target para decidir onde seu conteúdo importado será usado no Intercom:

  • Fin AI Agent: Ative esta opção para usar artigos Zendesk para respostas automatizadas ao cliente.

  • Copilot: Ative esta opção para fornecer respostas sugeridas aos seus colegas.

  • Help Center: Ative esta opção para publicar conteúdo Zendesk diretamente no seu Help Center Intercom.

  • Audience Control: Escolha quais públicos específicos (por exemplo, "Enterprise plan") podem ver este conteúdo.

Passo 4: Revisão

Faça uma verificação final antes de iniciar a importação:

  1. Digite um nome personalizado para a importação para identificá-la em sua lista Knowledge (por exemplo, "Zendesk - Public Support").

  2. Verifique o resumo para ver o número de artigos e campos sendo importados.

  3. Verifique novamente se suas configurações de Available in e Audience estão corretas.

Clique em Sync and set live para começar.


Importando com o importador legado

  1. Para começar a importar artigos públicos, vá para Knowledge Hub > Sources.

  2. Em Public articles, encontre Zendesk e clique em Sync or Import.

  3. Agora digite seu subdomain Zendesk e escolha a opção “Import content” e então clique em Import.

Nota:

  • O importador legado será descontinuado após 25 de abril. Após esta data:

    • As sincronizações manuais e automáticas serão interrompidas.

    • Você ainda pode executar uma importação única a qualquer momento, mas a sincronização não será retomada até que você migre para o novo importador.

    • Uma vez no novo importador (ou após editar uma fonte migrada), você terá acesso aos novos filtros e recursos de metadata.

  • Para iniciar uma importação de artigo do Zendesk usando o importador legado, você deve fazer login com acesso de Admin para autenticar.

  • Você precisará escolher o Help Center alvo no Intercom se estiver usando Multi Help Center.

  • Se você importar, seus artigos Zendesk serão convertidos em artigos públicos nativos que você pode gerenciar no Intercom.

  • Para importar artigos multilíngues do Zendesk, você precisará adicionar os idiomas adicionais nas configurações do seu Help Center, para que as traduções importadas fiquem visíveis.

  • O domínio personalizado do seu Intercom Help Center deve estar configurado antes da importação para que os redirecionamentos sejam gerados usando o domínio personalizado.

Agora, aguarde a conclusão da importação. Durante esse tempo, vamos rastrear seu site de documentos, importar todos os seus artigos publicados e colocá-los em coleções do Help Center que correspondam à estrutura da sua knowledge base existente. Isso pode levar de alguns minutos a uma hora ou mais. Enviaremos um e-mail quando estiver concluído, então não há necessidade de esperar 😄

Após a migração ser concluída, atualize a página Content em Knowledge para ver seus artigos importados em pastas na barra lateral esquerda.

Aprenda como gerenciar artigos públicos a partir do Knowledge e habilitá-los para Fin AI Agent e Copilot.

Importante: Se você ainda não fez isso, será necessário ativar seu Help Center ou seus artigos não serão publicados e não poderão ser habilitados para Fin ou Copilot.

Após 25 de abril

Quando o importador legado for descontinuado, aqui está o que muda:

  • As sincronizações manuais e automáticas serão interrompidas.

  • Você ainda pode executar uma importação única a qualquer momento, mas a sincronização não será retomada até que você migre para o novo importador.

  • Depois que você estiver no novo importador (ou após editar uma fonte migrada), terá acesso aos novos filtros e recursos de metadados.


Após a conexão

Começaremos a rastrear seu site Zendesk, importando seus artigos publicados e estruturando-os em coleções que correspondem à sua knowledge base existente. Quaisquer etiquetas ou categorias do Zendesk serão adicionadas como tags aos artigos no Intercom.

Esse processo pode levar de alguns minutos até uma hora. Enviaremos um e-mail quando estiver concluído. Você pode verificar o status a qualquer momento em Knowledge > Sources.

Após a migração, atualize a página Content em Knowledge para ver seus artigos importados.


Como os metadados do Zendesk são importados

Para economizar seu tempo, o importador traz automaticamente a estrutura da sua knowledge base do Zendesk para o Intercom.

Metadados do Zendesk como etiquetas, categorias e tags de conteúdo são todos importados e convertidos em tags nos seus artigos do Intercom.

Esses metadados são essenciais para tornar seu conteúdo útil. Com essas tags aplicadas automaticamente, você pode:

  • Filtrar seu conteúdo na seção Knowledge para ver artigos por uma determinada categoria.

  • Excluir conteúdo irrelevante do Fin AI Agent.

  • Direcionar respostas para o público certo criando públicos específicos do Fin AI Agent com base nas tags dos artigos.

Por exemplo, se você tem conteúdo no Zendesk rotulado como "EMEA-only", essa etiqueta se tornará uma tag no Intercom. Você pode então criar um público para seus clientes europeus no Fin AI Agent e configurá-lo para usar apenas artigos com a tag "EMEA-only".


Redirecionamentos de artigos Zendesk

Os redirecionamentos de artigos são gerados automaticamente durante o processo de importação — e com o novo pipeline de importação, eles são mais confiáveis do que nunca. Embora os URLs dos artigos do Zendesk e do Intercom estejam em formatos diferentes, os redirecionamentos garantem que quaisquer links existentes não quebrem após a migração, preservando sua pontuação de SEO.

Os redirecionamentos são implementados na forma de redirecionamentos permanentes (respostas HTTP 301).

Como funciona a correspondência de redirecionamento

Os redirecionamentos são correspondidos pelo ID numérico estável do artigo embutido no URL do Zendesk — não pelo slug, que pode mudar. Isso significa que todas as variantes de URL para o mesmo artigo mapeiam para um único registro de redirecionamento e o mesmo artigo do Intercom.

Visitante chega em (URL original do Zendesk)

Redireciona para

/hc/en-us/articles/12345678-how-to-reset-password

Artigo do Intercom

/hc/en-us/articles/12345678-reset-your-password

Mesmo artigo do Intercom

/hc/en-us/articles/12345678

Mesmo artigo do Intercom

Nota: Os redirecionamentos são criados automaticamente durante a importação e nunca bloquearão a importação se algo der errado.

Suporte multilíngue

Ao importar coleções e artigos em vários idiomas, cada variante de idioma terá seu próprio redirecionamento associado ao URL original do artigo Zendesk.

Revisando redirecionamentos existentes

Após a importação ser concluída, você pode revisar os redirecionamentos gerados através da seção Domains em Settings > Help Center > Configure and style:

A partir daqui, role para baixo até Domains e clique em "gerenciar redirecionamentos":

O painel exibe o URL original e o artigo/coleção para o qual ele redireciona.

Importante:

  • Os redirecionamentos serão exibidos apenas para o domínio personalizado escolhido. Por exemplo, se você estiver importando artigos de um Help Center Zendesk em https://support.examply.com, os redirecionamentos aparecerão na seção de domain somente se você tiver selecionado support.examply.com como seu domínio personalizado e estiver usando o protocolo de segurança HTTPS.

  • Se você não estiver pronto para alterar seu CNAME para apontar para o Intercom para seu domínio personalizado, ainda pode ter os redirecionamentos criados ao importar do Zendesk adicionando seu domínio personalizado no seu Help Center Intercom e selecionando a opção de usar o protocolo de segurança HTTPS.

  • Com o Multi Help Center, os redirecionamentos não estão conectados a um Help Center específico. Em vez disso, eles estão vinculados a um domain. Isso significa que os redirecionamentos aparecerão em qualquer Help Center que esteja usando o mesmo domain onde os artigos Zendesk estavam localizados.

  • Os redirecionamentos estarão disponíveis para todos os artigos importados do Zendesk após 22 de setembro de 2022.


Conteúdo não categorizado

Se você tiver algum conteúdo não categorizado em seu site, o Articles criará automaticamente uma coleção ‘Geral’ para você. As coleções ajudam seus users a navegar e encontrar facilmente o que precisam, então considere reorganizar esses artigos por tópico antes de publicá-los.


Conteúdo que ainda não suportamos

Converteremos seu conteúdo para um formato que suportamos (por exemplo, copiando imagens). No entanto, ainda não suportamos a seguinte formatação:

Importar a partir da URL da categoria/coleção também não é suportado. Você precisará importar sua knowledge base a partir da URL principal.


Artigos com formatação não suportada

Se houver algum problema ao importar seu conteúdo, adicionaremos um rótulo Review ao artigo para que você possa corrigi-lo antes de publicá-lo. Basta abrir o artigo que precisa revisar e ler a recomendação que adicionamos. A recomendação funciona como um espaço reservado, então você precisará deletá-la e inserir o conteúdo que recomendamos antes de publicar o artigo.


FAQs

Qual é o meu subdomínio Zendesk?

Este é o domain da sua conta Zendesk (não a URL do seu Help Center). Seu subdomain Zendesk é seu identificador único e há algumas maneiras de encontrá-lo que você pode ver aqui.

Meu Help Center tem artigos em 2 idiomas, mas só estou vendo um após a importação?

O Intercom importará todos os idiomas suportados, mas não ativaremos esse idioma para o Help Center. Você terá que adicionar o idioma nas configurações do Help Center, e depois disso a tradução ficará visível.

Tenho um artigo localizado em EN-US e EN-GB e ele foi importado como dois artigos diferentes?

O Intercom suporta apenas uma lista curta de versões localizadas de idiomas: Portuguese / Brazilian Portuguese, German / German (Formal), Chinese Traditional / Simplified.

Para todas as outras versões localizadas, mapeamos para o idioma mais próximo suportado no Intercom (ex: EN-GB, EN-US, EN-AU todos mapeiam para EN). Em caso de conflito, criamos um artigo diferente para cada versão localizada para evitar perda de dados.

Tenho artigos em irlandês, mas eles não foram importados, o que aconteceu?

Importamos apenas artigos em um dos idiomas suportados pelo Intercom Messenger.

O e-mail diz que importou “X” artigos, mas eu só vejo “Y” no meu Help Center?

O total listado no e-mail inclui todos os diferentes idiomas em que o artigo existe. Um artigo com traduções em inglês, francês e português contará como 3 artigos no e-mail.

Qual é a diferença entre "Sincronizar conteúdo" e "Importar conteúdo" do Zendesk?

A principal diferença entre sincronizar conteúdo e importar conteúdo do Zendesk é onde você planeja editar seus artigos no futuro.

  • Escolha sincronizar conteúdo se quiser manter o Zendesk como seu editor principal. Isso cria uma versão somente leitura dos seus artigos no Intercom que permanece atualizada com sua knowledge base Zendesk.

  • Escolha importar conteúdo se quiser migrar totalmente para o Intercom. Isso cria uma cópia editável dos seus artigos no Intercom, que se torna sua nova fonte única da verdade.

Se eu excluir um artigo no Zendesk, ele também será removido do Intercom?

Sim, se você excluir um artigo no Zendesk enquanto tiver uma sincronização ativa configurada, ele também será removido do Intercom. Isso acontece automaticamente durante a próxima sincronização para garantir que ambas as knowledge bases permaneçam consistentes.

É seguro usar uma chave API do Zendesk para autenticação?

Sim, é seguro usar uma chave API do Zendesk para autenticação. Este é um método padrão e seguro para conectar aplicações que concede ao Intercom permissões específicas para acessar seus artigos sem expor sua senha de administrador ou outras informações sensíveis da conta.

Respondeu à sua pergunta?