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.
Depois que seus artigos estiverem 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 os 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 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.
Nota: A importação funciona em duas etapas — o Intercom primeiro sincroniza seu conteúdo do Zendesk, depois o converte em artigos nativos. Quando a importação estiver completa, a sincronização é automaticamente excluída. Qualquer filtro de sincronização do Zendesk é removido, e seu conteúdo se torna artigos regulares editáveis no seu workspace.
Sincronizar conteúdo
Escolha esta opção para sincronizar uma versão atualizada continuamente e somente leitura do seu conteúdo. O Zendesk continua sendo 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:
Nota: O conteúdo é importado no idioma configurado no Zendesk. Para inglês, apenas EN-US, EN-UK e EN-CA são suportados — não há opção genérica EN. Artigos importados também não serão colocados automaticamente em uma coleção; você precisará organizá-los manualmente após a importação.
Conectando via token API
Use este método para importar seu conteúdo do Zendesk usando um token API seguro.
Passo 1: Gere um token API do Zendesk
Primeiro, gere um token API no seu Admin Center do Zendesk.
No Zendesk, vá para o Admin Center.
Navegue até Apps and integrations > APIs > Zendesk API.
Clique na aba API token e clique em Add API token.
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
Em Public articles, encontre Zendesk e clique em Sync or Import.
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.
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.
Use a aba Target para decidir onde seu conteúdo importado será usado no Intercom.
Fin AI Agent: Ative para usar artigos do Zendesk para respostas automatizadas ao cliente.
Copilot: Ative para fornecer respostas sugeridas aos seus colegas.
Help Center: Ative se quiser publicar o conteúdo do Zendesk diretamente no seu Help Center do Intercom.
Controle de Público: Escolha quais públicos específicos (por exemplo, "Plano Enterprise" ou "Público do Reino Unido") podem ver este conteúdo.
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 na sua lista de Knowledge (por exemplo, "Zendesk - Suporte Público").
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 Disponível em e Audience estão corretas.
Clique em Sincronizar e publicar para começar a transformação do seu conteúdo Zendesk em artigos do Intercom.
Conectando via OAuth
Passo 1: Autenticar Zendesk
Para importar seu conteúdo, você precisa primeiro autenticar sua fonte Zendesk:
Digite seu subdomínio Zendesk (por exemplo,
mydomain.zendesk.com).Selecione OAuth como seu método de autenticação.
Clique em Conectar.
Uma vez estabelecida a conexão, você pode opcionalmente ativar Sincronizar artigos para usuários autenticados para incluir conteúdo visível apenas para clientes autenticados. Clique em Próximo quando a conexão for bem-sucedida.
Seu subdomínio é a parte da sua URL antes de .zendesk.com. Por exemplo, se sua URL for https://help.zendesk.com, seu subdomínio é 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 + Adicionar Filtro para selecionar conteúdo com base em critérios específicos como Categorias, Etiquetas ou Carimbos de data/hora.
Se você pular esta etapa, o importador trará todo o conteúdo elegível por padrão.
Passo 3: Destino
Use a aba Destino 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 do Intercom.
Controle de Público: Escolha quais públicos específicos (por exemplo, "Plano Enterprise") podem ver este conteúdo.
Passo 4: Revisão
Faça uma verificação final antes de iniciar a importação:
Digite um nome personalizado para a importação para identificá-la na sua lista de Knowledge (por exemplo, "Zendesk - Suporte Público").
Verifique o resumo para ver o número de artigos e campos que estão sendo importados.
Verifique novamente se suas configurações de Disponível em e Audience estão corretas.
Clique em Sincronizar e publicar para começar.
Importando com o importador legado
Para começar a importar artigos públicos, vá para Knowledge Hub > Sources.
Em Artigos públicos, encontre Zendesk e clique em Sincronizar ou Importar.
Agora digite seu subdomínio Zendesk e escolha a opção “Importar conteúdo” e clique em Importar.
Nota:
O importador legado será descontinuado após 25 de abril. Após essa 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.
Depois que você estiver no novo importador (ou após editar uma fonte migrada), terá acesso aos novos filtros e recursos de metadata.
Para iniciar uma importação de artigos do Zendesk usando o importador legado, você deve fazer login com acesso de Administrador para autenticar.
Você precisará escolher o Help Center de destino 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 Help Center Intercom 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, faremos a varredura do seu site de documentos, importaremos todos os seus artigos publicados e os colocaremos em coleções do Help Center que correspondem à 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, para que você não precise esperar 😄
Após a migração ser concluída, atualize a página de Conteúdo 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 ainda não fez, você precisará 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. Os artigos importados não serão colocados automaticamente em uma coleção — use as tags importadas para filtrar e organizar seu conteúdo.
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 importação ser concluída, vá para Knowledge > All Content para encontrar seus artigos importados. Eles aparecerão como artigos individuais — não dentro de uma coleção. Use as tags importadas do Zendesk para filtrar e organizar.
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.
Encaminhar 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 do 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 redirecionamentos
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 correspondem a um único registro de redirecionamento e ao 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 do 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 Configurações > Help Center > Configurar e estilizar:
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 domínio somente se você tiver selecionadosupport.examply.comcomo 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.
Após a importação, você pode excluir ou editar os redirecionamentos criados automaticamente e criar os seus manualmente.
Com o Multi Help Center, os redirecionamentos não estão conectados a um Help Center específico. Em vez disso, estão vinculados a um domínio. Isso significa que os redirecionamentos aparecerão em qualquer Help Center que use o mesmo domínio onde os artigos do 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 os seguintes formatos:
Importar a partir de URLs de categoria/coleção também não é suportado. Você precisará importar sua knowledge base a partir do URL principal.
Artigos com formatação não suportada
Se houver algum problema ao importar seu conteúdo, adicionaremos um rótulo Revisar 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.
Perguntas Frequentes
Qual é o meu subdomínio Zendesk?
Qual é o meu subdomínio Zendesk?
Este é o domain da sua conta Zendesk (não a URL do seu Help Center). Seu subdomínio 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ó vejo um após a importação?
Meu Help Center tem artigos em 2 idiomas, mas só vejo 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 em dois artigos diferentes?
Tenho um artigo localizado em EN-US e EN-GB e ele foi importado em 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 o inglês especificamente, o Intercom suporta EN-US, EN-UK e EN-CA — não há uma opção genérica EN. Em caso de conflito de localidade, um artigo separado é criado para cada variante para evitar perda de dados.
Tenho artigos em irlandês, mas eles não foram importados, o que aconteceu?
Tenho artigos em irlandês, mas eles não foram importados, o que aconteceu?
Nós 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 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 English, French e Portuguese contará como 3 artigos no e-mail.
Qual é a diferença entre "Sincronizar conteúdo" e "Importar conteúdo" do Zendesk?
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 de verdade.
Se eu excluir um artigo no Zendesk, ele também será removido do Intercom?
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?
É 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.












