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 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. Primeiro, conecte e sincronize seu conteúdo Zendesk, depois acione a importação separadamente em Knowledge > Sources para convertê-lo em artigos nativos do Intercom.
Isso realiza uma migração única de todos os seus artigos publicados do Zendesk para o Intercom.
Depois de importados, a conexão é encerrada. Alterações feitas no Zendesk não serão refletidas no Intercom. Essa conversão é irreversível.
Você poderá editar e gerenciar esses artigos diretamente no Intercom.
Para importar, primeiro conecte e sincronize sua fonte Zendesk usando os passos abaixo. Quando a sincronização estiver completa, vá para Knowledge > Sources, clique em Manage na sua fonte Zendesk sincronizada, selecione Import content e confirme a importação.
Nota: A importação agora ocorre em duas etapas separadas. Primeiro, conecte e sincronize seu conteúdo Zendesk usando os passos abaixo. Quando a sincronização estiver completa, vá para Knowledge > Sources, clique em Manage na sua fonte Zendesk sincronizada, selecione Import content e confirme a importação para convertê-lo em artigos nativos do Intercom — esta etapa é manual e não será executada automaticamente após a sincronização. Depois de importar, a sincronização é excluída, qualquer filtro de sincronização do Zendesk é removido e seu conteúdo se torna artigos regulares editáveis no seu workspace. A importação é irreversível.
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á editando e gerenciando seus artigos no Zendesk.
Antes de importar
Antes de começar, recomendamos ativar a indexação de mecanismo 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 Settings > Help Center e clicando em "configure and style":
Você encontrará a opção para ativar a indexação de busca em General > Privacy:
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 Zendesk usando um token API seguro.
Passo 1: Gere um token API do Zendesk
Primeiro, gere um token API no seu Zendesk Admin Center.
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 seus dados de conexão:
Digite o Subdomain: 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.
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 Timestamps. 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 Zendesk para respostas automatizadas ao cliente.
Copilot: Ative para fornecer respostas sugeridas aos seus colegas.
Help Center: Ative esta opção se quiser publicar o conteúdo do Zendesk diretamente no seu Help Center do Intercom.
Audience Control: Escolha quais públicos específicos (por exemplo, "Enterprise plan" ou "UK audience") 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 - 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.
Clique em Sync and set live 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 subdomain do Zendesk (por exemplo,
mydomain.zendesk.com).Selecione OAuth como seu método de autenticação.
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 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 se 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 do 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 o conteúdo do Zendesk diretamente no seu Help Center do 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:
Digite um nome personalizado para a importação para identificá-la na sua lista de Knowledge (por exemplo, "Zendesk - Public Support").
Verifique o resumo para ver o número de artigos e campos que estão sendo importados.
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
Para começar a importar artigos públicos, vá para Knowledge Hub > Sources.
Em Public articles, encontre Zendesk e clique em Sync or Import.
Agora digite seu subdomínio Zendesk e escolha a opção “Import content” e depois clique em Import.
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 Admin 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 do 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, vamos rastrear seu site de documentos, importar todos os seus artigos publicados e colocá-los 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 terminar, então não precisa 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 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 conclusão da importação, 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 labels, categories e content tags, 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 category.
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", esse label 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 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 Zendesk.
Revisando redirecionamentos existentes
Após a conclusão da importação, você pode revisar os redirecionamentos gerados na seção Domains em Settings > Help Center > Configure and style:
A partir daqui, role para baixo até Domains e clique em "manage redirects":
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 criar os redirecionamentos 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, eles 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 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 category/collection 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 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 como dois artigos diferentes?
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: Português / Português Brasileiro, Alemão / Alemão (Formal), Chinês Tradicional / Simplificado.
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 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?
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.
Meus artigos ainda mostram o ícone do Zendesk mesmo sendo editáveis no Intercom — devo reconectar como sincronização para corrigir isso?
Meus artigos ainda mostram o ícone do Zendesk mesmo sendo editáveis no Intercom — devo reconectar como sincronização para corrigir isso?
Não, você não deve reconectar como sincronização para corrigir um ícone do Zendesk residual. Se seus artigos são editáveis no Intercom, eles foram importados (não sincronizados) e já são artigos nativos do Intercom — a conexão com o Zendesk foi removida, e o ícone é apenas um resquício cosmético da importação. Reconectar a fonte como sincronização tornaria esses artigos somente leitura novamente e os bloquearia de serem indexados por motores de busca, já que artigos sincronizados são excluídos da indexação para evitar penalidades por conteúdo duplicado com seu Help Center Zendesk. Se você quer que seus artigos nativos sejam indexados pelo Google, mantenha a importação — o ícone não afeta a funcionalidade ou SEO.
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 na 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.