Base de conhecimento pública

A Base de conhecimento pública (Public KB) é a parte da sua base de conhecimento acessível sem autenticação por meio de um link direto, um widget ou um iframe. Apenas os artigos que você marcou explicitamente como públicos chegam aqui.

Por quê:

• Autoatendimento do cliente — os clientes encontram respostas por conta própria, sem contatar o suporte
• SEO — os artigos públicos são indexados pelo Google e por outros mecanismos de busca
• Demonstração — clientes em potencial leem a documentação antes de comprar
• Parceiros — acesso à documentação técnica sem a necessidade de criar contas

#Como um artigo se torna público

A publicidade é ativada por duas configurações — uma no nível do artigo e outra no nível da organização. Até que ambas estejam em vigor, os visitantes anônimos não verão o artigo.

Não existe um TIPO de espaço "público". Os espaços são apenas Corporate / Private / Personal. Um artigo se torna visível não ao ser movido para um espaço especial, mas por meio da flag publish_state=public (em um espaço Corporate) em conjunto com o modo de acesso público da organização ativado.

#Estados de publish_state (ADR 0029)

O LiKE usa o campo publish_state (ele substitui o antigo campo visibility). Quatro estados:

Na interface, a cor do estado é mostrada por um indicador de ponto:

Os mesmos selos são visíveis na lista de artigos em Gestão de artigos.

#O espaço virtual __public__

Quando um usuário anônimo abre a Public KB por meio de um link direto ou de um widget, tecnicamente ele não está em nenhum dos seus espaços. Em vez disso, o LiKE usa um "espaço" virtual __public__ — um valor sentinela que:

• Não existe no banco de dados como um ArticleCollection.type='public' real
• Inclui todos os artigos com publish_state='public' dos espaços Corporate da organização
• É usado para filtragem na busca RAG do usuário anônimo
• É exibido no SpaceSwitcher como "🌐 Artigos públicos" (se o usuário também tiver espaços privados)

Se você for um membro autorizado, alterne para __public__ no SpaceSwitcher para ver exatamente o mesmo conjunto de artigos que um visitante anônimo vê — isso é útil para verificar "o que publiquei acidentalmente".

#Configuração (passo a passo)

#Passo 1 — Colocar os artigos em um espaço Corporate

Você só pode publicar externamente a partir de um espaço Corporate (em espaços Private e Personal a publicação fica bloqueada). Se os seus artigos estiverem em outro espaço, mova-os para um Corporate: um por um pelo menu de contexto do artigo → Mover, ou em massa (caixas de seleção → Mover). Na criação de um espaço, os tipos disponíveis são Corporate e Private; "Personal" é um espaço do sistema.

#Passo 2 — Tornar os artigos públicos

Mude os artigos que você precisa para publish_state = public (consulte Gestão de artigos):

• Em massa — selecione com as caixas de seleção → o botão de globo (🌐) na barra de ações → Public
• Um único artigo — o menu "⋮" → "Visibilidade: …" → Public; no modo "Árvore" — o menu de contexto → "Tornar público"
• No editor — o botão "Publicar" no cabeçalho

Depois disso, o indicador de status fica verde e um selo 🌐 Public aparece. Se o artigo contiver dados pessoais, um diálogo de confirmação é aberto — consulte "Verificação de dados pessoais antes da publicação" abaixo.

#Passo 3 — Ativar o modo público da organização

Configurações → Organização → Modo de acesso → escolha "Público".

• Público — os usuários anônimos veem, no endereço público, os artigos marcados como públicos; os espaços privados permanecem disponíveis apenas por convite.
• Corporativo — tudo fica disponível apenas para membros autenticados; usuários externos sem autenticação não veem nada, mesmo artigos marcados como públicos.

Sem o modo "Público" ativado, o endereço público fica fechado — este passo é obrigatório.

#Passo 4 — Endereço público e canais

Há três maneiras de abrir a base de conhecimento pública pronta:

• Portal público — a raiz do seu endereço https://<seu-slug>.lynkora.pro: busca, respostas de IA e leitura de artigos sem autenticação. Um artigo individual fica em /kb/<article-slug>.
• Widget JS — incorporado no seu site; o código do widget é obtido em Integrações → Canais (o card "Widget JS").
• iframe — incorporação da interface de busca completa em uma página.

Não há mais uma aba "Public KB" separada nas configurações (ADR 0029): a publicidade agora é definida pela flag do artigo + o modo da organização, em vez de uma lista de permissões de fontes. Os widgets são gerenciados em Integrações → Canais.

#Verificação de dados pessoais antes da publicação

Ao mudar um artigo para Público, o LiKE analisa-o automaticamente em busca de dados pessoais (PII). Se encontrar algum, a publicação é pausada e aparece um diálogo "Dados pessoais detetados" — antes de o artigo ficar acessível a todos sem autenticação.

Quando é acionada: apenas na publicação (mudança para public, acesso anónimo). Não é executada para internal, draft ou inherit. Aplica-se a todos os caminhos de publicação: o botão "Publicar" no editor, "Tornar público" na lista/árvore, alterações de visibilidade em lote e a publicação de uma coleção/espaço.

O que é detetado (determinístico, baseado em padrões):

• Email
• Telefone
• Cartão de pagamento (checksum Luhn)
• IBAN (validado por checksum)
• Endereço IP
• Data de nascimento

Categorias especiais (saúde, biometria, etc., RGPD Art. 9) ainda não são detetadas automaticamente — o diálogo apenas mostra um aviso sobre a responsabilidade acrescida de as publicar.

O que o diálogo mostra:

• O título "Dados pessoais detetados" e uma lista dos tipos detetados com as respetivas contagens (agregadas em todos os artigos a publicar).
• Uma caixa de confirmação obrigatória: a ferramenta ajuda a detetar PII mas não garante a exaustividade; você, enquanto responsável pelo tratamento, continua responsável pela licitude da publicação e por dispor de uma base legal ou consentimento.
• Botões Cancelar e Publicar (Publicar só fica ativo depois de a caixa ser marcada).

Após a confirmação: o artigo é publicado e a confirmação é registada no registo de atividade (pii_public_ack) com os tipos de dados detetados — sem armazenar o próprio texto dos PII (privacy-by-design). A confirmação está associada à versão atual do artigo: se editar o texto posteriormente, terá de confirmar novamente.

Quem pode confirmar: as mesmas funções que podem publicar — Editor e superior no espaço do artigo (Owner e Admin sempre). Publicar todos os artigos de uma fonte em lote é apenas para Owner/Admin.

#Widgets para a Public KB (dual-auth, ADR 0032)

O LiKE suporta dois modos de autenticação para widgets — escolhidos ao criar um widget em Integrações → Widgets:

#Modo 1 — Caminhos permitidos (para sites públicos)

Um widget incorporado no site público da empresa (uma landing page, páginas de marketing, uma central de ajuda). Nenhuma autenticação é necessária — o widget está disponível para qualquer visitante.

Proteção contra abuso:

• Uma lista de URLs permitidas (allowed paths) — onde esta api-key é válida. Por exemplo, https://seusite.com/* e https://docs.seusite.com/*. Requisições de outros domínios são rejeitadas (CORS + verificação).
• Escopo public umbrella — o widget tem acesso apenas ao espaço __public__ + coleções específicas desse espaço, definidas na criação.
• Rate limit na api-key — proteção contra bots.

#Modo 2 — Session JWT (para um site corporativo com autenticação)

Um widget incorporado no portal interno da empresa, onde os usuários já possuem autenticação. O widget aceita um session JWT e vê exatamente o que aquele usuário vê.

Casos de uso:

• Um widget em uma intranet corporativa → cada colaborador vê seus próprios espaços
• Incorporação em uma aplicação SaaS (por exemplo, em um CRM) — o usuário vê a documentação para sua função

#Multi-widget por tenant (ADR 0029 Stage 4)

Dentro de uma organização, você pode criar vários widgets com escopos diferentes:

• Um — público, para o site de marketing (allowed paths)
• Outro — corporativo, para a intranet (session JWT)
• Um terceiro — para uma coleção específica (por exemplo, apenas o FAQ para a central de suporte)

Cada widget tem sua própria api-key, escopo e modo de autenticação. Consulte Integrações → Widgets e API e widget para mais detalhes.

#O que os visitantes anônimos veem

A busca anônima usa por padrão um cookie de client-fingerprint para um rate limiting básico, mas não vincula a requisição a uma conta de usuário.

#Ocultar coleções individuais

Em um espaço Corporate, nem todas as coleções precisam necessariamente ser visíveis para usuários anônimos. Você pode ocultar coleções específicas:

1. O menu de contexto da coleção → Propriedades
2. O campo publish_state da coleção:
   • inherit — herda do espaço (padrão)
   • internal — oculto de usuários anônimos, visível para a equipe
   • public — explicitamente público (apenas em um espaço Corporate, caso contrário, bloqueado)

Isso proporciona flexibilidade: por exemplo, em um espaço Corporate "Documentação", você pode manter rascunhos em uma coleção Internal Drafts com publish_state=internal — eles são invisíveis para o exterior, mas disponíveis para seus editores.

#Incorporação em um site

A Public KB pode ser integrada a um site de três maneiras:

Detalhes sobre cada um — API e widget e Integrações.

#White-label e um domínio personalizado

A base de conhecimento pública está disponível no endereço padrão slug.lynkora.pro. Recursos avançados do portal — white-label (sem o branding do LiKE) e a conexão de um domínio personalizado (Configurações → Domínio) — estão incluídos nos planos onde o white-label está habilitado. Não há um complemento pago separado para isso.

Quais recursos estão disponíveis em quais planos e por qual preço — consulte a página de Preços e o seu painel de administração.