Odoo Knowledge: crie um wiki interno e uma base de conhecimento

Este guia cobre a configuração completa e a otimização de um wiki interno usando o Odoo 19 Knowledge, desde a arquitetura do artigo até o conteúdo incorporado, controle de acesso, sistemas de modelos e integração com Helpdesk para conhecimento voltado ao cliente.

Principais conclusões

• Projetar uma hierarquia de artigos que organize o conhecimento institucional de forma lógica e intuitiva
• Use o editor baseado em blocos para criar artigos ricos com texto, imagens, tabelas, código e visualizações incorporadas
• Incorpore dados Odoo ao vivo (listas, gráficos, quadros kanban) diretamente em artigos de conhecimento
• Configurar o controle de acesso em nível de artigo, seção e espaço de trabalho
• Crie modelos de artigos para documentação padronizada (notas de reuniões, resumos de projetos, SOPs)
• Habilite a descoberta de conteúdo personalizado e favorito para cada usuário
• Compartilhe conhecimento externamente por meio de portal e links públicos com permissões granulares
• Integre o conhecimento com o Helpdesk para resolução assistida por agentes e por autoatendimento do cliente

---

Design de Arquitetura do Conhecimento

Planejamento de hierarquia de artigos

Antes de criar conteúdo, projete uma arquitetura de informação que será dimensionada à medida que sua base de conhecimento crescer. A hierarquia deve seguir a forma como as pessoas pensam sobre a informação e não como os departamentos são organizados.

Navegue até Conhecimento > Artigos e planeje suas seções de nível superior:

Estratégia de aninhamento

Odoo Knowledge suporta profundidade de aninhamento ilimitada. A melhor prática é de 3 a 4 níveis no máximo:

Level 1: Section (Company Handbook)
  Level 2: Category (HR Policies)
    Level 3: Article (Remote Work Policy)
      Level 4: Sub-article (Equipment Allowance)

O aninhamento mais profundo torna o conteúdo mais difícil de encontrar. Se você precisar de mais de 4 níveis, reconsidere sua hierarquia – divida em seções adicionais de Nível 1 em vez de enterrar o conteúdo mais profundamente.

Navegação e descoberta

Odoo Knowledge oferece vários caminhos de descoberta:

• Árvore da barra lateral: Navegação hierárquica mostrando todas as seções e artigos aos quais o usuário tem acesso
• Pesquisa: pesquisa de texto completo em todos os artigos acessíveis, incluindo conteúdo incorporado
• Favoritos: lista de favoritos pessoais para artigos frequentemente referenciados
• Recente: artigos visualizados recentemente para acesso rápido de retorno
• Compartilhado comigo: artigos compartilhados explicitamente por colegas

---

Recursos do editor de artigos

Edição baseada em bloco

Odoo 19 Knowledge usa um editor moderno baseado em blocos semelhante ao Notion ou Confluence. Cada bloco é um elemento de conteúdo independente que pode ser movido, copiado ou estilizado de forma independente.

Tipos de blocos disponíveis

Formatação avançada

Nos blocos de texto, aplique a formatação:

• Títulos: H1 a H4 para estrutura do documento
• Negrito, itálico, sublinhado, tachado: ênfase inline
• Código embutido: para termos técnicos e comandos
• Links: Internos (para outros artigos) e externos (para sites)
• Cores: destaque de texto e fundo
• Alinhamento: Esquerda, centro, direita e justificado

Comandos de barra

Digite / no editor para acessar comandos rápidos:

---

Conteúdo incorporado: dados Live Odoo em artigos

O poder da incorporação

O recurso de destaque do Odoo Knowledge é a capacidade de incorporar visualizações ao vivo do Odoo diretamente nos artigos. Isso transforma sua base de conhecimento de um repositório de documentos estáticos em um painel operacional dinâmico.

Incorporando visualizações Odoo

Use o comando /view ou o menu inserir para incorporar qualquer visualização do Odoo:

Configuração de visualização incorporada

Cada visualização incorporada suporta:

• Filtros: pré-filtre os dados mostrados (por exemplo, apenas tickets abertos, apenas tarefas da minha equipe)
• Tipo de visualização: Lista, Kanban, Gráfico ou Dinâmica
• Colunas: Selecione quais campos exibir
• Agrupamento: Agrupe por qualquer campo para exibição organizada
• Limite: Defina o número máximo de registros mostrados
• Interatividade: os usuários podem clicar no registro completo do Odoo na visualização incorporada

Atualizações em tempo real

As visualizações incorporadas mostram dados em tempo real. Quando uma oportunidade passa de estágio no CRM, a visualização do pipeline incorporada no artigo da reunião semanal é atualizada instantaneamente. Quando um ticket de suporte é resolvido, ele desaparece da lista de tickets abertos no seu runbook de suporte. Isso elimina o problema de informações obsoletas que assola os wikis tradicionais.

Exemplo: manual de vendas com dados em tempo real

Sales Playbook Article
├── Overview (text)
├── Current Pipeline (embedded CRM Kanban, filtered to this quarter)
├── Top Opportunities (embedded list, sorted by expected revenue, top 10)
├── Win Rate by Source (embedded graph, last 6 months)
├── Competitor Matrix (table, manually maintained)
├── Objection Handling Scripts (text with callouts)
└── Proposal Templates (file attachments)

Este único artigo substitui um e-mail semanal de relatório de pipeline, um documento separado de análise de concorrentes e uma coleção dispersa de scripts de vendas - tudo em um local ativo e sempre atualizado.

---

Controle de acesso

Níveis de permissão

Odoo Knowledge usa um modelo de permissão de três níveis:

Herança de permissão

As permissões são transmitidas em cascata dos artigos pai para filho por padrão:

• Se você tiver acesso de editor ao "Manual da empresa", terá acesso de editor a todos os subartigos
• Artigos filhos podem substituir as permissões dos pais para restringir ainda mais o acesso
• Você não pode conceder mais acesso no nível filho do que o fornecido pelo pai

Acesso no nível do espaço de trabalho

Configure o acesso no nível da seção para acesso organizacional amplo:

Compartilhando com usuários externos

Compartilhe artigos ou seções específicas por meio de:

• Acesso ao portal: clientes e fornecedores com contas no portal podem acessar artigos designados
• Link público: qualquer pessoa com o link pode visualizar (não é necessária uma conta Odoo)
• Convidar: Envie um convite para visualizar/editar artigos específicos para endereços de e-mail
• Incorporar: incorpore artigos em seu site usando o módulo Site

---

Modelos de artigos

Sistema de modelos

Os modelos padronizam como as equipes documentam conteúdo recorrente. Navegue até um artigo e clique em “Salvar como modelo” para torná-lo reutilizável.

Modelos recomendados

Variáveis de modelo

Os modelos podem incluir texto de espaço reservado que solicita ao autor que preencha informações específicas:

## Meeting Date: [Enter date]
## Attendees: [List all participants]
## Agenda
1. [First agenda item]
2. [Second agenda item]

## Discussion Notes
[Summarize key discussion points]

## Action Items
- [ ] [Action] — [Owner] — [Due date]

Quando um membro da equipe cria um novo artigo a partir de um modelo, ele vê esses espaços reservados como guias, garantindo uma documentação consistente e completa.

Categorias de modelos

Organize os modelos em categorias para facilitar a descoberta:

• Geral: notas de reuniões, atualizações de status, anúncios
• Projetos: Resumo do projeto, retrospectiva do sprint, encerramento do projeto
• RH: descrição do cargo, feedback da entrevista, avaliação de desempenho
• Técnico: decisão de arquitetura, runbook, documentação de API
• Vendas: esboço da proposta, análise competitiva, revisão do negócio

---

Favoritos e Personalização

Favoritos pessoais

Cada usuário pode adicionar artigos favoritos para acesso rápido. Os artigos favoritos aparecem na seção dedicada "Favoritos" da barra lateral do Knowledge. Isso cria uma “estante” personalizada com o conteúdo mais referenciado para cada indivíduo.

Casos de uso para favoritos:

• Artigos de integração favoritos dos novos funcionários durante o primeiro mês
• Os representantes de vendas preferem a matriz competitiva e o guia de preços
• Os agentes de suporte favoritam os 10 principais artigos de solução de problemas
• Os gerentes favoritam as notas de reunião e os painéis de sua equipe

Artigos recomendados

Configure recomendações de artigos com base na função do usuário ou departamento. Quando um funcionário do departamento de suporte abre o Knowledge, ele vê uma seção "Recomendado para suporte" com os artigos mais relevantes pré-selecionados pelo gerente do Knowledge.

Notas pessoais

Os usuários podem criar artigos privados visíveis apenas para eles. Isso é útil para anotações pessoais, rascunhos de ideias, marcadores e documentos de trabalho que não estão prontos para visibilidade da equipe. Artigos privados podem ser promovidos para artigos visíveis para a equipe quando estiverem prontos.

---

Integração com Helpdesk

Acesso ao conhecimento do agente

A integração do Conhecimento mais impactante é com o Helpdesk. Quando um agente de suporte abre um ticket, o painel Conhecimento aparece ao lado:

1. Sugestões automáticas: com base no assunto e na descrição do ticket, Odoo sugere artigos de conhecimento relevantes
2. Pesquisa manual: os agentes podem pesquisar na base de conhecimento sem sair da visualização do ticket
3. Inserir na resposta: clique em "Usar no ticket" para inserir o conteúdo do artigo (ou um link para o artigo) diretamente na resposta do ticket
4. Criar a partir do ticket: quando um agente resolve um problema novo, ele pode criar um novo artigo de conhecimento diretamente a partir da resolução do ticket

Autoatendimento do cliente

Compartilhe artigos de conhecimento de suporte com clientes por meio do portal:

1. Marque os artigos como "voltados para o cliente" na base de conhecimento
2. Configure o portal do cliente para exibir uma seção de conhecimento
3. Os clientes pesquisam e navegam pelos artigos disponíveis
4. Contagens de visualizações de artigos e feedback (útil/não útil) rastreiam a eficácia do artigo
5. Vincule artigos de conhecimento em respostas automatizadas de tickets e mensagens predefinidas

Deflexão de tickets

Implemente a deflexão de tickets baseada em conhecimento:

1. Quando um cliente começar a criar um ticket de suporte, pesquise artigos correspondentes na base de conhecimento
2. Exiba artigos relevantes antes que o cliente preencha o formulário de envio
3. Se o cliente encontrar a resposta, poderá fechar o formulário sem enviar
4. Rastreie a taxa de desvio para medir a eficácia da base de conhecimento

Isso reduz o volume de tickets para problemas comuns e melhora a experiência do cliente: os clientes obtêm respostas imediatas em vez de esperar por uma resposta de suporte.

Ciclo de Conhecimento

Construa um ciclo de melhoria contínua entre Suporte e Conhecimento:

Customer reports issue → Support agent resolves →
  Is this a new issue? →
    Yes → Agent creates knowledge article →
      Knowledge manager reviews and publishes →
        Future customers find it via self-service →
          Fewer tickets for this issue
    No → Agent links existing article in response →
      Track usage count →
        High-usage articles promoted in portal

---

Governança de conteúdo

Ciclos de propriedade e revisão

Cada artigo deve ter um proprietário designado responsável pela precisão e atualidade:

Detecção de conteúdo obsoleto

Configure ações automatizadas para detectar artigos obsoletos:

1. Artigos não atualizados em 6 meses recebem uma etiqueta "Revisão obrigatória"
2. O proprietário do artigo recebe uma notificação de atividade de revisão
3. Se não for revisado dentro de 30 dias, encaminhe para o gerente da seção
4. Se não for revisado dentro de 60 dias, adicione o banner "Potencialmente desatualizado" visível para todos os leitores

Padrões de Qualidade

Estabeleça padrões de qualidade de conteúdo para sua base de conhecimento:

• Completude: os artigos devem cobrir o tópico completamente ou ter links para recursos suplementares
• Precisão: as informações devem ser verificadas por um especialista no assunto antes da publicação
• Clareza: escreva para o público-alvo — evite jargões em artigos voltados para o cliente
• Consistência: siga modelos e convenções de nomenclatura
• Encontrabilidade: marcação adequada, títulos claros e posicionamento correto na hierarquia

---

Otimização de pesquisa

Tornando o conteúdo localizável

Uma base de conhecimento é tão boa quanto sua experiência de pesquisa. Otimize a localização do artigo:

Títulos: use títulos claros e descritivos que correspondam à forma como os usuários pensam sobre o tópico. "Como redefinir sua senha" é melhor do que "Procedimento de solução de problemas de autenticação 4.2".

Aliases e palavras-chave: adicione termos e acrônimos alternativos que os usuários possam pesquisar. Um artigo sobre “Folga” deve incluir palavras-chave como “férias”, “licença”, “PTO”, “feriado” e “ausência”.

Blocos de resumo: comece cada artigo com um breve resumo que captura as principais informações. Isso ajuda os usuários a determinar a relevância dos resultados da pesquisa sem abrir o artigo.

Links internos: vincule artigos relacionados entre si. Isso melhora a navegação e ajuda os usuários a descobrir conteúdo relevante que talvez não tenham pesquisado diretamente.

Análise de pesquisa

Monitore a análise de pesquisa para melhorar sua base de conhecimento:

• Termos mais pesquisados: certifique-se de que os principais termos de pesquisa tenham artigos correspondentes
• Pesquisas sem resultados: termos que não retornam resultados indicam lacunas de conteúdo
• Abandono de pesquisa: pesquisas em que o usuário não clicou em nenhum resultado sugerem títulos ou resumos de artigos de baixa qualidade
• Clique por artigo: quais artigos são encontrados e lidos com mais frequência

---

Perguntas frequentes

Como o Odoo Knowledge se compara ao Confluence ou Notion?

Odoo Knowledge oferece recursos comparáveis ​​de edição e colaboração com a vantagem exclusiva de dados ao vivo incorporados de seus aplicativos de negócios Odoo. Você não pode incorporar um pipeline de CRM ao vivo ou uma visualização de inventário no Confluence sem integrações complexas. Para organizações que já utilizam o Odoo, o Knowledge oferece integração contextual superior sem custo adicional por usuário. Confluence e Notion possuem recursos de colaboração mais avançados (comentários, menções, comparação de histórico de páginas), mas não possuem integração de dados de negócios.

Posso importar conteúdo wiki existente do Confluence ou do SharePoint?

Sim. Exporte conteúdo do seu wiki existente como HTML ou Markdown. Odoo oferece suporte à importação em massa de conteúdo de artigos, incluindo imagens e anexos. Para grandes migrações (milhares de artigos), use a API Odoo para criar artigos programaticamente com hierarquia, tags e permissões adequadas. ECOSIRE migrou bases de conhecimento do Confluence, SharePoint, Google Sites e Notion.

Existe limite para o número de artigos?

Sem limite técnico. Odoo Knowledge chega a dezenas de milhares de artigos. O desempenho depende da infraestrutura do seu servidor. O desempenho da pesquisa permanece rápido, independentemente da contagem de artigos, porque o Odoo indexa o conteúdo do artigo para pesquisa de texto completo.

Posso usar o Knowledge para documentação voltada ao cliente?

Sim. Compartilhe árvores de artigos específicas com usuários do portal. Os artigos voltados para o cliente podem ter um estilo visual e nível de acesso diferentes dos artigos internos. Muitos clientes ECOSIRE mantêm bases de conhecimento internas e externas no mesmo sistema, com controle de acesso determinando o que cada público vê.

Como incentivo os funcionários a contribuir para a base de conhecimento?

Comece com modelos que diminuam a barreira de entrada – é mais fácil preencher um modelo do que escrever do zero. Integre o conhecimento em fluxos de trabalho existentes (modelo de notas de reunião, modelo de revisão pós-incidente). Reconhecer colaboradores em reuniões de equipe. Estabeleça uma meta de um novo artigo por equipe por semana. Mais importante ainda, faça da base de conhecimento a única fonte da verdade – quando as pessoas encontrarem informações desatualizadas em e-mails ou bate-papos, redirecione-as para o Knowledge e atualize o artigo.

Posso rastrear quem lê quais artigos?

Sim. Odoo rastreia contagens de visualizações de artigos e visualizadores únicos. Os proprietários dos artigos podem ver quem leu o artigo e quando. Isso é útil para conformidade (confirmação do reconhecimento da política) e para medir a eficácia do conteúdo (quais artigos obtêm mais envolvimento).

Como lidar com informações conflitantes entre artigos?

Implemente uma política de fonte única de verdade: para qualquer tópico, um artigo é a fonte confiável. Outros artigos podem fazer referência ou linkar para ele, mas não devem duplicar as informações. Quando são descobertos conflitos, o proprietário do artigo é responsável por resolver a discrepância e atualizar todos os artigos referenciados. Use o padrão “Artigo Canônico” – marque um artigo como definitivo e outros como suplementares.

---

Construa sua base de conhecimento organizacional com ECOSIRE

O conhecimento que sai quando um funcionário sai – conhecimento do processo, contexto do cliente, conhecimento técnico, memória institucional – é insubstituível, a menos que tenha sido capturado. Uma base de conhecimento bem estruturada é a diferença entre um aumento de 3 meses para uma nova contratação e um aumento de 3 semanas.

A equipe de implementação Odoo da ECOSIRE construiu sistemas de gerenciamento de conhecimento para empresas de tecnologia, empresas de serviços profissionais, fabricantes e organizações de suporte ao cliente. Nossa implementação inclui design de arquitetura de informação, criação de modelos, migração de conteúdo, integração de Helpdesk, configuração de estrutura de governança e treinamento de equipe.

Entre em contato com a ECOSIRE para discutir sua estratégia de gerenciamento de conhecimento ou explore nossos serviços de suporte e manutenção Odoo para otimização contínua da base de conhecimento e governança de conteúdo.

Leitura relacionada:

• Configuração da base de conhecimento Odoo
• Guia do sistema de gerenciamento de documentos Odoo
• Guia do sistema de tickets do Odoo Helpdesk
• Serviços de implementação Odoo