Como funciona
Você pode conectar facilmente seu Zendesk Help Center público ao Intercom com nossa integração sem código. Isso permite sincronizar continuamente seu conteúdo do Zendesk, mantendo-o como sua fonte de verdade enquanto usa os artigos para alimentar os recursos de AI do Intercom.
Se quiser editar e gerenciar seus artigos diretamente no Intercom (tornando-o sua fonte de verdade), veja Import public articles from Zendesk em vez disso.
Depois que seus artigos forem sincronizados com o Intercom, você poderá:
Usá-los para alimentar o Fin AI Agent e o Copilot para respostas precisas e automatizadas.
Torná-los acessíveis na Inbox para que os colegas compartilhem nas conversas.
Destacá-los no seu Intercom Help Center para que os clientes possam se autoatender.
Nossa nova sincronização com Zendesk é construída sobre um pipeline de serviço robusto que melhora a velocidade e a confiabilidade da integração do seu conteúdo. Também extrai automaticamente metadados como etiquetas e categorias do Zendesk e os aplica como tags no Intercom, ajudando a organizar o conteúdo e aplicar regras para uma resolução de AI mais eficaz.
Conectando com o novo importador Zendesk
Este método usa uma chave API segura para autenticação e permite sincronizar seu conteúdo do Zendesk.
Passo 1: Gere um token API do Zendesk
Na sua conta 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 token.
Importante: O Zendesk mostrará este token apenas uma vez, então certifique-se de guardá-lo em um local seguro antes de continuar.
Passo 2: Conecte o Zendesk no Intercom
No seu workspace Intercom, vá para Knowledge > Sources.
Em "Public articles", encontre Zendesk e clique em Sync or Import.
Digite seu Zendesk subdomain (ex.:
your-company.zendesk.com).
Para "Authentication method", selecione API key.
No campo "Email address", insira o endereço de e-mail do seu administrador Zendesk.
No campo "API token", cole o token que você gerou no Zendesk.
(Opcional) Se você tiver artigos no Zendesk que são visíveis apenas para usuários logados, ative Sync articles for signed-in users.
Escolha o Target Help Center do Intercom onde deseja que o conteúdo apareça.
Selecione Sync content.
Clique em Sync para começar.
Quando a sincronização for concluída, você receberá um e-mail no endereço registrado no Intercom confirmando quantos artigos foram sincronizados.
Após sincronizar artigos públicos do Zendesk, o conteúdo aparecerá em uma lista simples dentro de uma pasta sincronizada que você pode visualizar na barra lateral esquerda em Knowledge > Content. (A estrutura de pastas existente do Zendesk atualmente não é suportada no Knowledge, mas estará disponível em breve).
Artigos Públicos sincronizados do Zendesk serão exibidos no Knowledge apenas para visualização e não podem ser editados. Todas as alterações devem ser feitas pelo Zendesk e serão automaticamente propagadas para o Intercom na próxima sincronização. No entanto, você pode configurar as configurações para artigos sincronizados, como habilitá-los para Fin ou gerenciar regras de público.
Nota:
Você precisará importar artigos do Zendesk se quiser disponibilizá-los no seu Intercom Help Center e editá-los no Intercom.
As re-sincronizações são executadas automaticamente a cada hora e propagam quaisquer alterações feitas nos artigos no Zendesk para o Intercom. Isso inclui novos artigos, alterações no conteúdo dos artigos e remoção de artigos.
Sincronizações que ocorrem automaticamente após a primeira sincronização não enviarão e-mail ao concluir.
Se você já tiver artigos publicados no Intercom, manteremos esses artigos existentes e você pode acabar com conteúdo duplicado. Você pode optar por excluir todos os artigos do Intercom antes de iniciar a primeira sincronização.
Você também precisará atualizar quaisquer Workflows que contenham artigos do Intercom com os novos artigos sincronizados para garantir que eles estejam vinculados ao conteúdo correto e atualizados com as alterações feitas no Zendesk.
Depois que a primeira sincronização começar, não é possível forçar a parada. Você pode remover a sincronização após a conclusão da sincronização inicial.
O que é 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.
O que acontece depois de conectar
Começaremos a rastrear seu site Zendesk e trazer seus artigos publicados para o Intercom. Esse processo pode levar de alguns minutos a mais de uma hora, dependendo do número de artigos. Enviaremos um e-mail quando estiver concluído, e a sincronização será executada a cada hora para puxar o conteúdo mais recente.
Você pode verificar o status a qualquer momento em Knowledge > Sources. Após a conclusão do processo, atualize a página Content no Knowledge para ver seus artigos.
Como os metadados do Zendesk são sincronizados
Para economizar seu tempo, a sincronização converte automaticamente a estrutura e os metadados da sua knowledge base Zendesk em um formato útil no Intercom.
As etiquetas, categorias e tags de conteúdo do Zendesk são todas sincronizadas e convertidas em tags de artigo no Intercom.
A estrutura dos seus artigos Zendesk (coleções e seções) será replicada no Intercom. Conteúdo não categorizado será colocado em uma coleção chamada "General".
Dica: Com essas tags aplicadas automaticamente, você pode filtrar conteúdo no Knowledge ou criar públicos específicos no Fin AI Agent para controlar quais artigos ele usa para certos clientes. Por exemplo, uma etiqueta Zendesk "EMEA-only" se torna uma tag no Intercom, que você pode usar para garantir que o Fin forneça apenas esses artigos para seu público europeu.
Gerencie sua conexão
Remover uma Sincronização
Se você quiser remover a sincronização com Zendesk (e os dados relacionados), pode fazer isso em Knowledge > Sources clicando em Manage > Remove this source em artigos públicos.
Você verá uma faixa de confirmação verde indicando que a remoção foi bem-sucedida e os artigos sincronizados serão excluídos do Knowledge no Intercom.
Importante: Remover a conexão excluirá todos os artigos sincronizados do Zendesk no Intercom. Isso também removerá seus dados dos seus relatórios de Artigos, o que pode causar uma diminuição nos números dos seus relatórios.
Considerações importantes
Zendesk continua sendo sua fonte de verdade: Você ainda manterá seu site do Help Center voltado para o cliente no Zendesk, e todas as edições devem ser feitas lá.
Somente leitura no Intercom: Os artigos sincronizados são apenas para visualização no Intercom. As alterações feitas no Zendesk serão atualizadas no Intercom durante a próxima sincronização horária.
Indexação de busca: Para evitar penalidades por conteúdo duplicado, impedimos que os motores de busca indexem seu Help Center do Intercom quando você tem uma sincronização ativa. Seu Help Center do Zendesk é considerado o principal para os motores de busca.
Vinculação: Se um cliente clicar no link "Open in Help Center" em um artigo no Messenger sincronizado, ele abrirá o artigo no seu Help Center do Zendesk.
O que é sincronizado: Processamos apenas artigos publicados do Zendesk que são públicos ou visíveis para users autenticados. Artigos internos ou privados da knowledge base não são suportados.
Conteúdo duplicado: Se você já tiver artigos publicados no Intercom quando iniciar a sincronização, pode acabar com conteúdo duplicado.
Workflows: Se você usar Workflows (anteriormente Custom Bots) que linkam para artigos do Intercom, precisará atualizá-los para apontar para os novos artigos sincronizados.
Suporte a idiomas: Não suportamos artigos em idiomas que atualmente não são suportados pelo Intercom. Se você tiver múltiplas variantes do inglês (como
en-useen-gb), elas serão mapeadas para o inglês geral do Intercom (en), o que pode resultar na criação de artigos separados para evitar perda de dados.Suporte a vídeo: Suportamos vídeos incorporados via
iframeusando o botão 'Add video' do Zendesk (por exemplo, YouTube, Vimeo, Loom). Incorporações personalizadas de vídeo em HTML, CSS ou JavaScript não são suportadas.
Nota: Quando Fin referencia um artigo do Zendesk, o link da fonte redirecionará os clientes para o Help Center do Zendesk.
Sincronizando com o importador legado do Zendesk
Importante: O importador legado do Zendesk será descontinuado em 25 de abril. Após essa data, as sincronizações automáticas (diárias) e manuais serão interrompidas. Para continuar sincronizando, você precisa migrar para o novo importador antes de 25 de abril.
Como migrar para o novo importador
Vá para Knowledge > Sources e abra sua fonte do Help Center do Zendesk que está usando a experiência antiga.
Clique em Manage (três pontos) > Migrate importer.
Siga as instruções para autenticar com Zendesk e completar a migração. Você será solicitado a entrar novamente no Zendesk — use uma conta de administrador do Zendesk (ou uma conta de agente com o mesmo acesso da sincronização original).
Após a migração, abra o novo importador e clique em Edit para configurar seus filtros de metadados e revisar suas audiências Fin, configurações do Copilot e tags.
Nota: Durante a migração, todas as configurações existentes dos seus artigos serão preservadas. Você não poderá usar os novos filtros de metadados até que a migração esteja completa e você tenha aberto o novo importador para clicar em Edit / Edit source.
Após 25 de abril
O importador anterior não funcionará mais — as sincronizações manuais e automáticas serão interrompidas.
Você ainda pode realizar a migração a qualquer momento após 25 de abril, mas a sincronização pelo importador antigo permanecerá parada até que você o faça.
Uma vez no novo importador (ou após editar uma fonte migrada), você terá acesso aos novos filtros e recursos de metadados.
Usando artigos sincronizados no Intercom
Após sincronizar seus artigos do Zendesk com o Intercom, você pode usá-los para alimentar os seguintes recursos (se estiverem incluídos no seu plano):
Navegando por artigos
Buscando artigos
Sugestões de artigos (Messenger Home)
Respostas de IA
Sugestões de artigos
Respostas de IA
Pesquisar e enviar artigos em conversas
Capacidade somente leitura
Usando artigos sincronizados via Public API
Artigos sincronizados e seu conteúdo poderão ser recuperados do Public API de forma semelhante aos artigos do Intercom. No entanto, você não poderá editar ou manipular artigos sincronizados via chamadas API.
Endpoints da API afetados:
Endpoints da API não afetados:
Relatórios sobre seus artigos sincronizados
Você pode acompanhar o desempenho dos seus artigos Zendesk sincronizados da mesma forma que acompanha seus artigos nativos do Intercom.
Todas as visualizações, reações e dados de pesquisa do seu conteúdo sincronizado aparecerão no seu principal relatório de Artigos. Isso permite ver quais artigos são mais usados, o que os clientes estão procurando e quais artigos podem precisar de melhorias no Zendesk.
Você pode encontrar o relatório em Relatórios > Todos os relatórios > Relatórios do Intercom. Para um guia detalhado sobre como usar este relatório, veja nosso artigo "Articles report".