Como exportar artigos do centro de ajuda do Intercom com a API: Um guia 2025

Então, passou inúmeras horas a construir uma base de conhecimento fantástica no Intercom, preenchendo-a com artigos genuinamente úteis que resolvem os problemas dos seus clientes. Agora precisa de extrair esse conteúdo e provavelmente já reparou que não há nenhum botão grande e brilhante de "exportar" em lado nenhum. Se está a arrancar os cabelos à procura dele, não está sozinho.

Quer esteja a migrar para uma nova plataforma, a criar uma cópia de segurança local para sua tranquilidade ou a querer fazer uma análise aprofundada do seu conteúdo, extrair os seus dados não deveria ser um projeto gigantesco. Este guia está aqui para o orientar nos passos técnicos para exportar os artigos do centro de ajuda do Intercom com a API.

Mas sejamos realistas, a via da API pode ser complicada e tem as suas próprias armadilhas. Por isso, também lhe vamos mostrar uma alternativa muito mais simples e automatizada que lhe permite conectar e gerir o seu conhecimento sem escrever uma única linha de código.

Antes de começar: O que vai precisar

Entrar no método da API requer um pouco de preparação. É uma tarefa técnica, por isso ter estas coisas prontas tornará todo o processo muito mais suave. Aqui está uma lista de verificação rápida:

• Acesso de administrador ao seu espaço de trabalho do Intercom: Vai mesmo precisar disto, pois terá de obter as permissões certas para criar credenciais de API.

• Um token de acesso de programador: Pense nisto como uma palavra-passe segura que permite que o seu script ou ferramenta comunique com o Intercom. Vamos abordar como criar um no primeiro passo.

• Uma ferramenta para fazer pedidos de API: Pode usar uma ferramenta de linha de comandos como o cURL se estiver à vontade nesse ambiente, ou uma aplicação mais amigável como o Postman.

• Um conhecimento básico de APIs: Será útil se souber o que são endpoints, pedidos GET e dados JSON, pois tornará os passos mais fáceis de seguir.

Um guia passo a passo para exportar artigos com a API do Intercom

Pronto para começar? Aqui está o processo completo para exportar os seus artigos usando a API REST do Intercom, dividido em quatro passos.

Passo 1: Obtenha o seu token de acesso de programador do Intercom

Para começar, precisa de uma forma de provar ao Intercom que tem permissão para aceder aos dados do seu espaço de trabalho. É aí que entra um token de acesso.

Obter um é bastante simples. Basta ir ao Hub do Programador nas suas definições do Intercom. A partir daí, pode criar uma nova aplicação para uso interno. Dê-lhe um nome de que se lembre (como "Exportador de Artigos"), e o Intercom irá gerar um token de acesso para si. Copie este token e guarde-o num local seguro; vai precisar dele para cada chamada de API.

Passo 2: Liste todos os artigos para obter os seus IDs

Aqui está uma pequena peculiaridade da API do Intercom: não pode simplesmente pedir todo o conteúdo dos seus artigos de uma só vez. Primeiro, tem de solicitar uma lista de todos os seus artigos para obter os seus IDs únicos. É como obter um catálogo de biblioteca antes de poder requisitar qualquer livro.

Para fazer isto, vai usar o endpoint "Listar todos os artigos". Quando enviar um pedido para este endpoint com o seu token de acesso, o Intercom enviará de volta um objeto JSON com uma lista dos seus artigos, cada um com o seu próprio "id".

Passo 3: Obtenha o conteúdo de cada artigo

Com a sua lista de IDs de artigos pronta, pode agora começar a extrair o conteúdo real. Isto envolve fazer um pedido separado para cada artigo, um por um.

Vai usar o endpoint "Obter um Artigo", certificando-se de incluir o "id" específico do artigo no URL do pedido. A resposta para cada pedido será um objeto JSON contendo tudo sobre o artigo: o seu título, autor, estado e, claro, o "body", que contém o conteúdo em formato HTML.

Esta é facilmente a parte mais repetitiva do processo. Se tiver 500 artigos, vai fazer 500 pedidos de API individuais.

Passo 4: Formate e guarde os seus dados exportados

À medida que obtém o conteúdo de cada artigo, cabe-lhe a si guardá-lo. O corpo do artigo é devolvido como HTML, por isso terá de guardar esses dados em ficheiros. Poderia guardá-los como ficheiros .html ou, se precisar de algo diferente, escrever um script para converter o HTML para outro formato como Markdown ou texto simples.

Para fazer isto para um centro de ajuda inteiro, quase de certeza que vai querer escrever um pequeno script que obtenha a lista completa de IDs (lidando com a paginação), percorra cada um deles, faça um pedido de API para obter o conteúdo, extraia o título e o corpo, e guarde tudo num ficheiro local.

E pronto. Exportou os seus artigos. Como pode ver, no entanto, não é exatamente um simples clique de botão.

Desafios comuns da exportação de artigos com a API

Embora o método da API cumpra a sua função, está longe de ser perfeito. Muitas equipas deparam-se com as mesmas frustrações que podem transformar esta tarefa num verdadeiro dreno de recursos.

• É um processo técnico e demorado. A menos que seja um engenheiro, todo este processo pode parecer intimidante. Requer conhecimentos técnicos, tempo para escrever e depurar scripts, e manutenção contínua se precisar de o fazer mais do que uma vez. Para pessoas não técnicas, é praticamente impossível, e para os programadores, é apenas mais uma tarefa que os afasta dos seus projetos principais.

• Artigos internos não podem ser exportados. Este é um grande problema. A API do Intercom atualmente não permite exportar artigos apenas para uso interno. Todo aquele conhecimento valioso que a sua equipa usa todos os dias fica preso, deixando-o com um trabalho manual de copiar e colar que anula todo o propósito de uma exportação automatizada.

• A formatação e o conteúdo podem ficar estranhos. O HTML exportado nem sempre é uma réplica perfeita. Como o Intercom menciona na sua própria documentação, qualquer redimensionamento de imagem personalizado que tenha feito será perdido, e elementos dinâmicos como caixas de destaque ou secções recolhíveis não são totalmente suportados. Os seus artigos lindamente formatados podem acabar por parecer um pouco danificados.

• É um instantâneo único. Talvez a maior desvantagem seja que a sua exportação fica desatualizada no segundo em que a termina. Quaisquer novos artigos, atualizações ou edições feitas no Intercom não estarão nos seus ficheiros exportados. Para manter tudo atualizado, tem de passar por todo o processo manual e técnico novamente.

A alternativa melhor: Unificar o seu conhecimento

Todas estas dores de cabeça levantam uma questão interessante: e se exportar for a solução errada para o problema? O verdadeiro objetivo não é apenas obter uma pasta de ficheiros HTML; é usar esse conhecimento noutro lugar.

E se não precisasse de exportar os seus artigos de todo? E se pudesse simplesmente conectar de forma segura a sua base de conhecimento do Intercom às outras ferramentas que usa e manter tudo em tempo real e sincronizado automaticamente?

É disso que se trata o eesel AI. Em vez de lutar com uma exportação única, o eesel AI oferece uma integração com o Intercom com um clique que lhe permite contornar todos estes problemas.

Veja como ajuda:

• Junte todo o seu conhecimento. Pode conectar o seu centro de ajuda do Intercom em minutos. Mas por que parar por aí? Também pode conectar outros locais onde a sua equipa armazena informação, como Confluence, Google Docs e até mesmo tickets de suporte passados. O seu conhecimento está sempre em tempo real e atualizado sem qualquer esforço manual.

• Comece em minutos, não em meses. Esqueça o processo de API de vários passos que precisa de um programador. Com o eesel AI, pode inscrever-se, conectar as suas fontes e começar a ver valor imediatamente, tudo por sua conta.

• Ponha o seu conhecimento a trabalhar. Uma exportação estática tem usos limitados. Uma base de conhecimento viva e conectada, por outro lado, é uma vantagem séria. Uma vez conectado, o seu conhecimento do Intercom pode ajudar a alimentar um Copiloto de IA que redige respostas para os seus agentes, um Agente de IA autónomo que resolve tickets por conta própria, ou um bot interno de P&R no Slack. Isso é um resultado real, não apenas um despejo de dados.

O Copiloto de IA da eesel a redigir uma resposta, mostrando como o conhecimento unificado pode potenciar diretamente as ferramentas de suporte.

Dicas profissionais para a gestão do conhecimento no Intercom

Quando muda a sua forma de pensar para além das exportações manuais, abre caminho para melhores formas de gerir o seu conhecimento. Aqui ficam algumas dicas para o ajudar a construir uma estratégia mais eficaz.

1. Encontre e preencha lacunas de conhecimento automaticamente. Uma das partes mais difíceis de gerir um centro de ajuda é saber o que escrever a seguir. Em vez de adivinhar, deixe que as conversas com os seus clientes o guiem. Uma ferramenta de IA como o eesel AI pode analisar os seus tickets de suporte, identificar perguntas recorrentes que não são respondidas no seu centro de ajuda e gerar automaticamente rascunhos de artigos para preencher essas lacunas.

Um painel de controlo da eesel AI a mostrar como identifica lacunas de conhecimento a partir de conversas de suporte, evitando a necessidade de exportar manualmente artigos do centro de ajuda do Intercom com a API para análise.

2. Não deixe o conhecimento ficar preso em silos. A sabedoria coletiva da sua empresa não vive apenas no Intercom. Processos importantes estão documentados no Confluence, atualizações de produtos são partilhadas no Google Docs e soluções rápidas são trocadas no Slack. Uma estratégia de suporte melhor unifica todas estas fontes, dando à sua equipa e à sua IA um único lugar fiável para encontrar respostas.

3. Simule antes de automatizar. Se vai usar o seu conhecimento para potenciar a IA, precisa de confiar que funcionará corretamente. Procure ferramentas que lhe permitam testar sem riscos. Por exemplo, o modo de simulação do eesel AI permite-lhe executar a sua configuração de IA em milhares de tickets passados. Pode ver exatamente como teria respondido e obter previsões sólidas sobre as taxas de resolução, o que o ajuda a ganhar confiança antes de a ligar para clientes reais.

A funcionalidade de simulação na eesel AI, que permite às equipas testar a sua configuração de IA em tickets passados e ganhar confiança antes de a ativarem.

Ir além da necessidade de exportar artigos do centro de ajuda do Intercom com a API

Embora tecnicamente possa exportar artigos do centro de ajuda do Intercom com a API, é bastante claro que o processo é manual, tecnicamente exigente e tem algumas limitações significativas. Deixa o seu conhecimento interno para trás e dá-lhe um instantâneo estático do seu conteúdo que rapidamente se torna inútil.

Uma abordagem mais moderna e eficiente é parar de pensar em exportações únicas e começar a construir um sistema de conhecimento vivo e unificado. Em vez de extrair dados, deveria estar a conectar as suas ferramentas.

Ferramentas como o eesel AI são construídas para isto. Permitem que as equipas conectem as suas fontes de conhecimento em minutos e coloquem imediatamente essa informação a trabalhar, tudo sem ter de mexer em APIs ou escrever código. Está na hora de desbloquear o que a sua base de conhecimento pode realmente fazer.

Pronto para unificar o seu conhecimento?

Pare de gastar tempo em exportações manuais e scripts de API complexos. Conecte todas as suas fontes de conhecimento, incluindo o seu centro de ajuda do Intercom, em minutos com o eesel AI.

Comece o seu teste gratuito hoje e veja como é fácil potenciar o seu suporte com um conhecimento verdadeiramente unificado.