Eis um cenário que ocorre com mais frequência do que deveria: uma equipe migra para o Freshdesk, habilita o Freddy AI no primeiro dia e imediatamente percebe que o bot está dando respostas erradas, sem contexto ou distorcendo detalhes de políticas que mudaram há seis meses. A culpa recai sobre a plataforma. O Freddy é desativado. A equipe volta ao suporte manual.
O problema não é a plataforma, mas sim a base de conhecimento
Freshdeskaprende diretamente com seus artigos de soluções, perguntas e respostas personalizadas, arquivos carregados e URLs. Sua precisão é uma função direta da qualidade, estrutura e atualidade desse conteúdo. Migre uma base de conhecimento mal estruturada, desatualizada ou incompletamente traduzida para Freshdesk, e o Freddy começará com uma desvantagem da qual talvez nunca se recupere.
Este guia é para equipes que estão migrando para o Freshdesk — seja do Zendesk, Intercom, ServiceNowou outra plataforma — e que desejam que o Freddy AI forneça respostas precisas desde o primeiro dia de operação. Você encontrará o processo de migração passo a passo, a lista de verificação de limpeza pré-migração, as regras de estrutura de artigos nas quais o Freddy se baseia e a estrutura de validação pós-migração para confirmar a precisão antes da entrada em operação.
1. Por que a precisão da IA Freddy depende da sua base de conhecimento?
A IA da Freshdesk— Freddy — opera por meio do AI Agent Studio. Ao criar um agente de IA, você o conecta a fontes de conhecimento: artigos de soluções, arquivos carregados, URLs públicos e pares de perguntas e respostas personalizados. O agente de IA aprende com essas fontes para gerar respostas às dúvidas dos clientes.
Aqui não há caixa preta. O Freddy não lê seu histórico de tickets, suas conversas por e-mail ou seus documentos internos, a menos que você os indique explicitamente. A qualidade de suas respostas depende totalmente das informações que você fornece. Isso tem uma implicação crucial para equipes que estão migrando para o Freshdesk:
As equipes que habilitam o Freddy antes de concluir a limpeza da base de conhecimento normalmente veem dois modos de falha: (1) respostas alucinadas — o Freddy faz referência com confiança a políticas ou procedimentos que não existem mais na sua base de conhecimento atualizada, porque a versão antiga foi migrada, e (2) desvio de confiança zero — o Freddy diz "Não tenho informações sobre isso" para perguntas que sua base de conhecimento realmente cobre, porque os títulos dos artigos não correspondem à linguagem natural usada pelos clientes.
O que Freddy realmente lê da sua base de conhecimento
O Freddy's AI Agent Studio suporta quatro tipos de fontes de conhecimento:
- Artigos de solução — sua principal fonte. Freddy lê o título do artigo, o conteúdo do corpo e quaisquer tags anexadas. A estrutura do artigo e a hierarquia dos títulos afetam diretamente a forma como Freddy interpreta os limites do tópico.
- Perguntas e respostas personalizadas — pares de perguntas e respostas explícitos que você define. Essas são a fonte de maior confiabilidade: o Freddy as trata como substituições autorizadas.
- Arquivos — PDFs, documentos do Word. Úteis para documentos de políticas e especificações técnicas, mas menos estruturados do que artigos.
- URLs — páginas web públicas. Útil para documentação de produtos hospedada fora do Freshdesk.
Para uma base de conhecimento migrada, os artigos de solução são a fonte dominante. A qualidade dos artigos, a estrutura das categorias e a abrangência linguística que você migra determinam diretamente o que o Freddy pode ou não responder com precisão.
2. Migração da base de conhecimento preparada para IA — passo a passo
A migração de uma base de conhecimento para Freshdesk é um processo de seis etapas. As etapas 1 a 4 ocorrem antes da execução da migração. As etapas 5 e 6 ocorrem depois.
Esta seção aborda especificamente a migração da base de conhecimento — artigos, categorias, pastas e versões de idioma. Ela não abrange a migração de tickets, a migração de contatos ou a configuração de agentes. Se você estiver executando uma migração completa ou expressa juntamente com a migração da sua base de conhecimento, siga a sequência descrita no Guia de Migração Completa ou no Guia de Migração Expressa. Sua base de conhecimento deve ser migrada antes dos tickets e antes da ativação do Freddy AI.
Etapa 1 — Audite sua base de conhecimento existente
Antes de migrar qualquer coisa, faça um inventário completo da sua base de conhecimento atual. Você precisa saber:
- Número total de artigos por status (publicado, rascunho, arquivado)
- Estrutura de categorias e pastas — quantos níveis de profundidade?
- Versões em idiomas — quais artigos existem em quais idiomas
- Datas da última modificação — quantos artigos não foram atualizados em mais de 12 meses
- Dados de desempenho do artigo — visualizações, avaliações de utilidade e CSAT, quando disponíveis
Este inventário se torna sua lista de limpeza pré-migração. Todo artigo que não foi atualizado nos últimos 12 meses é um candidato à revisão antes da migração. Todo artigo com baixa classificação de utilidade é um candidato à reescrita ou remoção. Todo artigo que existe em inglês, mas não em outros idiomas suportados, representa uma lacuna que você precisa preencher para que o Freddy possa atender com precisão os clientes que não falam inglês.
Etapa 2 — Limpe antes de migrar
Esta é a etapa que a maioria das equipes ignora e a que causa a maioria dos problemas de precisão da IA após a migração. A limpeza da sua base de conhecimento antes da migração tem três componentes:
2a. Remova artigos desatualizados e de baixa qualidade
Qualquer artigo que não reflita mais seus produtos, políticas ou procedimentos atuais deve ser removido ou atualizado antes da migração. Migrar artigos desatualizados para Freshdesk significa que o Freddy aprenderá com informações incorretas. A correção após a migração é dispendiosa: você precisa identificar quais artigos o Freddy está utilizando, atualizá-los ou removê-los e aguardar que o Freddy reaprenda. Corrigir isso antes da migração leva apenas alguns minutos por artigo.
2b. Padronizar os títulos dos artigos para correspondência de intenções por IA
O Freddy relaciona as consultas dos clientes aos artigos, em parte, por meio da análise dos títulos. Títulos de artigos que usam jargões internos em vez de linguagem acessível ao cliente (como "Perguntas frequentes sobre migração de planos de assinatura" em vez de "Como faço para alterar meu plano?") fazem com que o Freddy não encontre correspondências em consultas em linguagem natural. Reescreva os títulos para que correspondam à forma como os clientes fazem perguntas, e não à forma como sua equipe descreve os recursos.
2c. Consolidar artigos duplicados e sobrepostos
Vários artigos que abordam o mesmo tópico com escopos ligeiramente diferentes confundem a classificação de intenção do Freddy. Combine-os em um único artigo de referência com um título claro, cabeçalhos estruturados e um primeiro parágrafo que responda diretamente à questão. O Freddy tem melhor desempenho com artigos específicos, atuais e autossuficientes.
Etapa 3 — Planeje a estrutura de categorias e pastas para Freddy
Freshdesk organiza o conteúdo da base de conhecimento em três níveis: categorias, pastas e artigos. O Freddy usa essa hierarquia para entender o escopo do tópico. Uma hierarquia bem projetada melhora a capacidade do Freddy de retornar respostas contextualmente relevantes. Uma hierarquia plana ou excessivamente complexa prejudica essa capacidade.
A estrutura recomendada para precisão da IA:
- Categorias: áreas temáticas amplas que correspondem aos principais casos de uso do seu produto (por exemplo, Faturamento, Gerenciamento de Contas, Solução de Problemas Técnicos, Primeiros Passos)
- Pastas: subtópicos específicos dentro de cada categoria (ex.: em Faturamento: Faturas, Alterações de Plano, Reembolsos, Métodos de Pagamento)
- Artigos: conteúdo de tópico único com resposta direta em cada pasta — um problema, um artigo
Evite: categorias que misturam tópicos não relacionados, pastas com mais de 15 artigos e artigos que abordam vários problemas não relacionados. Cada um desses itens indica ao Freddy que os limites dos tópicos não estão claros.
Evite: categorias que misturam tópicos não relacionados, pastas com mais de 15 artigos e artigos que abordam vários problemas não relacionados. Cada um desses itens indica ao Freddy que os limites dos tópicos não estão claros.
Etapa 5 — Execute a migração e verifique a estrutura
Quando sua base de conhecimento de origem estiver limpa e a Freshdesk estiver planejada, execute a migração. O conecta sua plataforma de origem, mapeia categorias e pastas para seus Freshdesk e transfere os artigos com seus metadados, anexos e traduções intactos.
Após a conclusão da migração, antes de ativar o Freddy, verifique:
- A contagem de artigos no Freshdesk corresponde à contagem na plataforma de origem (por versão de idioma)
- A estrutura de categorias e pastas foi recriada corretamente — verifique as pastas aninhadas
- Os links internos do artigo estão funcionando (atualize quaisquer URLs de plataforma de origem codificadas)
- As imagens e anexos incorporados são renderizados e baixados corretamente
- Os artigos em rascunho permanecem nesse estado (não são publicados acidentalmente para os clientes)
Etapa 6 — Habilite o Freddy AI e valide a precisão antes da entrada em operação
Habilite o Freddy somente após a conclusão da verificação da estrutura da base de conhecimento. No AI Agent Studio, conecte seus artigos da solução Freshdesk como a principal fonte de conhecimento. Não habilite o agente de IA para interações com clientes em tempo real ainda.
O teste de validação de 20 consultas
Antes da entrada em produção, execute 20 consultas no Freddy que representem as categorias de tickets com maior volume de solicitações. Use a linguagem natural que seus clientes realmente usam — não terminologia interna. Para cada consulta, verifique:
- O Freddy retornou um artigo relevante? (não um artigo genérico)
- A resposta está correta e atualizada (não baseada em um artigo desatualizado que deveria ter sido removido)?
- O nível de confiança é apropriado — não excessivamente confiante em casos extremos?
- Para consultas multilíngues: o Freddy retorna a versão correta do idioma?
Uma pontuação de 17 em 20 ou superior (85% de precisão) é o limite recomendado antes de habilitar o Freddy para clientes reais. Se a precisão for inferior a 85%, retorne à revisão da estrutura e do título do artigo na Etapa 2 antes de publicar.
3. Escrevendo artigos que Freddy pode usar — regras de estrutura
O processo de migração cuida da transferência. A estrutura do artigo determina o que o Freddy faz com o conteúdo após a transferência. Estas são as cinco regras de estrutura de artigo que têm o maior impacto na precisão do Freddy.
Regra 1: Responda à pergunta do primeiro parágrafo
O Freddy extrai respostas de artigos para gerar trechos em destaque. Artigos que começam com contexto ou informações básicas antes da resposta fazem com que o Freddy retorne trechos incompletos ou fora do tópico. Estruture cada artigo da seguinte forma: primeiro a resposta direta (40 a 60 palavras), depois a explicação e, por fim, detalhes adicionais. Esse formato também melhora a elegibilidade para aparecer nos resultados de busca do Google.
Regra 2: Um artigo, um tópico
Artigos que abordam múltiplos problemas obrigam o Freddy a escolher qual parte do conteúdo é relevante para uma determinada consulta. Muitas vezes, ele escolhe incorretamente. Divida qualquer artigo que aborde mais de um problema ou procedimento distinto em artigos separados. Os artigos resultantes serão mais curtos, mais claros e o Freddy os encontrará com mais precisão.
Regra 3: Use linguagem voltada para o cliente em títulos e cabeçalhos
O Freddy relaciona as consultas aos artigos usando a análise de títulos e cabeçalhos. "Redefinição de senha" corresponde a uma consulta sobre esquecimento de senha. "Fluxo de trabalho de recuperação de credenciais" não. Analise cada título e cabeçalho H2 dos artigos comparando-os com a forma como os clientes realmente formulam suas solicitações de suporte. Seu histórico de chamados é a melhor fonte para essa linguagem — pesquise os assuntos mais comuns dos seus chamados.
Regra 4: Inclua etapas explícitas para o conteúdo processual
Para artigos com instruções passo a passo, numere as etapas explicitamente. O Freddy reconhece sequências de etapas numeradas e pode referenciá-las em conversas com várias interações ("Na etapa 3, você precisará...") — uma funcionalidade que só opera se as etapas forem numeradas explicitamente, e não descritas em formato de parágrafo.
Regra 5: Marque os artigos com palavras-chave relacionadas ao tópico
Freshdesk permite adicionar tags aos artigos de soluções. Essas tags complementam a classificação de tópicos do Freddy. Use de 3 a 5 tags por artigo que reflitam o tópico, a área do produto e os termos de consulta mais comuns dos clientes. Não use tags de forma redundante — se a tag já estiver no título do artigo, ela não agrega valor.
4. Lista de verificação para limpeza da base de conhecimento antes da migração
Antes de iniciar a migração, execute esta lista de verificação em sua base de conhecimento. Todos os itens não concluídos antes da migração devem ser finalizados no Freshdesk após a migração — o que é mais lento, mais arriscado e significa que o Freddy ficará inativo até que a tarefa seja concluída.
- Remova ou arquive artigos que não foram atualizados nos últimos 12 meses e que não refletem mais o produto ou a política atual
- Reescreva os títulos dos artigos para usar a linguagem do cliente (combine com os títulos dos seus 20 tickets mais frequentes)
- Consolidar artigos duplicados sobre o mesmo tema em um único artigo de referência
- Verifique se todas as versões de idioma estão presentes para os artigos em seu idioma principal — traduza as lacunas antes de migrar
- Padronize os nomes das categorias para que correspondam às principais áreas temáticas do seu produto (3 a 5 categorias no máximo para a maioria das equipes)
- Confirme que não há mais de 15 artigos por pasta (divida pastas muito grandes antes da migração)
- Remova os links incorporados para a base de conhecimento da plataforma de origem — eles deixarão de funcionar após a migração
- Exporte os dados de visualizações e utilidade dos artigos — use-os para priorizar a limpeza dos artigos com maior tráfego
- Marque artigos realmente desatualizados como "arquivados" na fonte em vez de excluí-los — a ferramenta Help Desk Migration migra apenas artigos publicados e em rascunho por padrão
- Execute um teste com 20 consultas na sua base de conhecimento de origem para estabelecer uma pontuação de precisão inicial antes da migração
5. Quando os serviços profissionais são a melhor opção
A maioria das equipes consegue executar uma migração de base de conhecimento por conta própria usando o assistente Help Desk Migration . Três cenários indicam que os serviços profissionais proporcionarão melhores resultados:
bases de conhecimento grandes ou complexas
Se sua base de conhecimento contém mais de 500 artigos em vários idiomas, os serviços profissionais gerenciam a limpeza, o planejamento da estrutura e o sequenciamento da migração de ponta a ponta. Isso é particularmente valioso quando a plataforma de origem possui uma estrutura de categorias não padronizada que precisa ser reestruturada para a hierarquia de três níveis do Freshdeskantes da migração.
Migração em conjunto com a migração de tickets e contatos
Se você estiver executando uma migração completa ou expressa — movendo tickets, contatos, empresas e artigos da base de conhecimento simultaneamente — os serviços profissionais coordenam a sequência. Os artigos da base de conhecimento devem ser migrados e verificados antes da ativação do Freddy e antes do início da migração de tickets. Acertar a sequência requer um planejamento que é difícil de gerenciar em paralelo com uma operação de suporte ao vivo.
Configuração e treinamento do Freddy além da configuração básica
A configuração do Freddy com pares de perguntas e respostas personalizados, múltiplos tipos de fontes de conhecimento, automações de fluxo de trabalho e implantação de canais (WhatsApp, chat online, Facebook) é um serviço profissional, não uma configuração de autoatendimento. Se os requisitos do seu agente de IA forem além da simples conexão de artigos de soluções à configuração padrão do Freddy, nossa equipe de serviços profissionais define o escopo e implementa a configuração completa.
Comece com uma !
Antes de se comprometer com uma migração completa da base de conhecimento, execute uma demonstração gratuita. A demonstração migra 20 artigos e 20 tickets (se aplicável) para sua Freshdesk , mostrando exatamente como a estrutura de categorias é transferida, como os artigos multilíngues são mapeados e se algum problema de campo ou formatação precisa ser resolvido antes da migração completa. A maioria das equipes identifica pelo menos um problema estrutural na demonstração, o que economiza um tempo significativo após a migração.
Conclusão: Qualidade da base de conhecimento em primeiro lugar, precisão do Freddy em segundo
A IA do Freddy não melhora sua base de conhecimento. Sua base de conhecimento é que melhora a IA do Freddy. A sequência é importante: auditar, limpar, estruturar, migrar, verificar e validar — nessa ordem. Equipes que habilitam o Freddy em uma base de conhecimento migrada, mas não limpa, passam semanas depurando a precisão da IA, que nunca deveria ter sido comprometida.
A boa notícia: o processo de limpeza pré-migração descrito neste guia tem dupla função. Artigos reestruturados para a precisão do Freddy também têm melhor classificação na busca do Google. Títulos reescritos para corresponder à linguagem do cliente melhoram tanto a correspondência de intenção do Freddy quanto as taxas de cliques na busca orgânica. Você não está fazendo trabalho extra — está fazendo o trabalho uma única vez, corretamente.
Se você está migrando para o Freshdesk e deseja que sua base de conhecimento e a IA do Freddy estejam configuradas corretamente desde o primeiro dia, comece com uma migração de demonstração gratuita. Leva cinco minutos e mostra exatamente como a estrutura dos seus artigos é transferida para o Freshdesk antes de você se comprometer com a migração completa.
Próximos passos
Faça sua — veja como seus artigos da Base de Conhecimento são transferidos para Freshdesk antes de se comprometer: help-desk-migration.com/demo.
Converse com nossa equipe de serviços profissionais sobre migração da Base de Conhecimento e configuração do Freshdesk.
Leia o guia de migração com foco em IA — para equipes que estão migrando para um helpdesk e precisam de toda a estrutura de qualidade de dados.
Perguntas frequentes
Para a maioria das bases de conhecimento com menos de 500 artigos, a migração é concluída em poucas horas. Bases de conhecimento maiores, com várias versões em idiomas diferentes e estruturas de pastas complexas, podem levar de 6 a 12 horas. Faça primeiro uma migração de demonstração gratuita — ela é concluída em menos de 5 minutos e fornece uma estimativa precisa para a quantidade e estrutura de artigos específicas da sua base.
O Freddy não é ativado automaticamente após a migração. Depois que seus artigos da Base de Conhecimento estiverem no Freshdesk, você deverá conectá-los como uma fonte de conhecimento no AI Agent Studio, configurar seu agente de IA e executar o teste de validação de 20 consultas antes de ativar o Freddy para os clientes em produção. Reserve de 2 a 4 horas para a configuração do Freddy após a conclusão da migração da Base de Conhecimento.
Sim — Help Desk Migration preserva a formatação do artigo, incluindo títulos, listas numeradas, marcadores, tabelas e imagens embutidas. As imagens incorporadas são transferidas com o artigo. Os links internos que fazem referência aos URLs da Base de Conhecimento da sua plataforma de origem precisarão ser atualizados para os novos URLs Freshdesk após a migração. Execute a verificação de links internos na Etapa 5 deste guia imediatamente após a migração.
Help Desk Migration oferece suporte à migração da base de conhecimento de mais de 90 plataformas, incluindo Zendesk, Intercom, ServiceNow, Jira Service Management, HubSpote outras. Solicite uma demonstração gratuita para confirmar se a sua plataforma específica (fonte:Freshdesk é compatível e para visualizar como a estrutura dos seus artigos será mapeada antes de optar pela migração completa.
Os artigos em rascunho são migrados como rascunhos — eles não são publicados automaticamente no Freshdesk. Os artigos publicados são migrados como publicados. Os artigos arquivados não são migrados por padrão. Revise sua lista de artigos em rascunho antes da migração: os rascunhos desatualizados devem ser removidos da fonte em vez de migrados, pois contam para o total de artigos e podem aparecer na lista de fontes de conhecimento do AI Agent Studio.
Help Desk Migration migra todas as versões de idioma simultaneamente em uma única execução. Você não precisa de etapas de migração separadas para cada idioma. Antes de migrar, verifique na sua plataforma de origem se as versões traduzidas dos artigos estão com status de publicadas ou rascunho — versões de idioma com status "tradução pendente" podem não ser exportadas via API e devem ser concluídas antes do início da migração.
Uma migração de base de conhecimento bem estruturada e limpa melhora a precisão do Freddy. Uma migração mal estruturada ou não limpa a degrada. O processo de seis etapas neste guia — auditoria, limpeza, estruturação, migração, verificação e validação — foi projetado especificamente para garantir que a precisão do Freddy melhore durante a migração, e não após semanas de limpeza pós-migração.
Artigos de solução são o termo usado pela Freshdeskpara artigos publicados na base de conhecimento, visíveis para clientes e agentes. As fontes de conhecimento do Freddy são os tipos de conteúdo dos quais a IA do Freddy aprende — incluindo artigos de solução, mas também perguntas e respostas personalizadas, arquivos e URLs. Ao ativar a IA do Freddy, você conecta seus artigos de solução como uma de suas fontes de conhecimento. As regras de qualidade e estrutura de artigos neste guia se aplicam especificamente a artigos de solução.
