Painel de controle → Integrações — conecte fontes de conteúdo e canais de acesso ao conhecimento.


#Fontes de conteúdo

#Conectadas (sempre ativas)

Fonte Descrição
LiKE Editor Editor de IA integrado para criar artigos
Importação de arquivos Envie PDF, DOCX, TXT, MD, RTF, ZIP
Importação por link Google Docs, Dropbox, links diretos de arquivos

#Conectores disponíveis

Fonte Descrição Modo
Wiki.js Importar ou sincronizar artigos Sincronização / Importação
Confluence Importar do Atlassian Confluence Cloud (OAuth) Sincronização / Importação
Notion Importar páginas e bancos de dados Sincronização / Importação
GitHub Sincronizar arquivos Wiki e Markdown de repositórios Sincronização / Importação
GitLab Sincronizar arquivos Wiki e Markdown de projetos Sincronização / Importação
Gitea Sincronizar arquivos Wiki e Markdown de um Gitea auto-hospedado Sincronização / Importação
Conector web Páginas do seu site público: através do sitemap ou percorrendo ligações Sync

O número de fontes conectadas é limitado pelo plano. Quando o limite está ocupado, o botão "Conectar" das fontes fica inativo — desconecte uma ou mude para um plano superior. Os bots do Slack e do Telegram não contam para esse limite.


#Conectando o GitHub

#Passo 1 — Autorização

  1. No LiKE, vá para Integrações → GitHub → "Conectar"
  2. Escolha um método de autorização:
Método Descrição
Personal Access Token (PAT) Crie um token em GitHub → Settings → Developer settings → Personal access tokens. Fine-grained (recomendado): Repository access + Permissions → Contents: Read-only (Metadata: Read é adicionado automaticamente); para repositórios de organização, o token deve ser aprovado pelo owner da organização. Classic: escopo repo. Enterprise: especifique o Base URL https://HOST/api/v3
OAuth Autorização via GitHub App — clique em "Authorize" e confirme o acesso

#Passo 2 — Escolhendo o conteúdo

  1. Após conectar, é mostrada uma árvore do repositório com pastas e arquivos
  2. Marque os arquivos ou pastas específicos a importar (Selective Sync)
  3. Formatos suportados: .md, .mdx, páginas Wiki

#Passo 3 — Executando a sincronização

  1. Clique em "Sync"
  2. O progresso é mostrado em tempo real
  3. Ao concluir, os artigos aparecem na lista com um rótulo GitHub

#Conectando o GitLab

#Passo 1 — Autorização

  1. No LiKE, vá para Integrações → GitLab → "Conectar"
  2. Escolha um método de autorização:
Método Descrição
Personal Access Token (PAT) Crie um token em GitLab → Preferences → Access Tokens. Escopos: api e read_user; a função do token deve ser no mínimo Reporter (Guest não consegue ver o código). Funciona para GitLab.com e auto-hospedado (para auto-hospedado, especifique o Base URL da instância)
OAuth Autorização via GitLab Application — clique em "Authorize"

#Passo 2 — Escolhendo o conteúdo

  1. É mostrada uma árvore do projeto com páginas Wiki e arquivos Markdown
  2. Marque as páginas específicas a importar (Selective Sync)

#Passo 3 — Executando a sincronização

Igual ao GitHub — clique em "Sync" e aguarde a conclusão.


#Conectando o Gitea

O Gitea é uma plataforma git auto-hospedada. Ele se conecta por meio de um Personal Access Token e uma URL obrigatória da sua instância (não há um Gitea em nuvem por padrão).

#Passo 1 — Crie um token no Gitea

  1. No Gitea, abra Settings → Applications → Generate New Token
  2. Conceda os escopos read:repository e read:user
  3. Copie o token

#Passo 2 — Conecte no LiKE

  1. No LiKE, vá para Integrações → Gitea → "Conectar"
  2. Especifique o Base URL da sua instância (por exemplo https://gitea.company.com) — este campo é obrigatório; sem ele a conexão não é concluída
  3. Cole o token
  4. Escolha onde colocar os artigos (um Espaço e uma pasta dentro dele — ou crie novos) e um modo (Sync — um espelho contínuo / Import — uma cópia única)

O OAuth 2.0 também é suportado se o administrador do Gitea tiver configurado previamente um aplicativo OAuth. O caminho principal é o token.

#Passo 3 — Escolhendo o conteúdo e sincronizando

  1. É mostrada uma árvore do repositório com páginas Wiki e arquivos Markdown (.md, .mdx)
  2. Marque os nós de que você precisa (Selective Sync) e clique em "Sync"
  3. Para atualizações automáticas em cada push, configure um webhook — o segredo é gerado no cartão do conector. Os artigos do Gitea são somente leitura (como com GitHub/GitLab)

#Seleção de arquivos e filtros de sincronização (GitHub, GitLab, Gitea)

Para fontes git (GitHub, GitLab e Gitea), a lógica de escolher o que sincronizar é mais sutil do que um simples "repositório ligado/desligado":

#O que é sincronizado

Fonte dentro do repositório Incluída
Páginas Wiki (<repo>.wiki) Por padrão, todas as páginas Wiki do repositório selecionado
Arquivos Markdown na árvore principal (*.md, *.mdx) Por padrão, todos os arquivos Markdown, a menos que filtros estejam configurados
README.md Incluído como um artigo separado com o título = <repo-name> · README
Documentação em /docs/** Incluída se a pasta existir; o nome do artigo é extraído do título # ... ou do nome do arquivo
Arquivos que não sejam Markdown (.txt, .rst, .json, código) Não são sincronizados automaticamente — o LiKE não analisa formatos arbitrários

#Filtros de caminho (sincronização seletiva)

Você pode restringir exatamente o que extrair do repositório:

Filtros de caminho
+ docs/** + guides/*.md − internal/**
Apenas arquivos de docs/ e guides/, excluindo internal/
Prefixo Ação
+ path/pattern Include — incluir arquivos por padrão (sintaxe glob)
- path/pattern Exclude — excluir arquivos da sincronização
(vazio) Sem filtros: todo o Wiki + todos os .md/.mdx no repositório

#Detecção de alterações (mudanças recentes)

O LiKE não "baixa tudo" a cada execução. É usada a detecção de alterações:

  • GitHub — via webhook (recomendado) ou polling usando cabeçalhos If-Modified-Since. O webhook reage a um push instantaneamente; o polling — a cada 6/12/24/48 horas (depende da sincronização automática).
  • GitLab — da mesma forma: webhook ou polling por last_activity_at via a Projects API.
  • Gitea — webhook (assinatura X-Gitea-Signature) ou polling. O gatilho de push dispara apenas quando *.md/*.mdx muda.

Assim que uma alteração é detectada, apenas os arquivos afetados são sincronizados; o restante do corpus não é recalculado. Isso economiza bastante a cota da API do GitHub/GitLab e o tempo de execução.

#Branch e tags

Parâmetro Valor padrão
Branch A branch padrão do repositório (geralmente main / master)
Branch alternativa Pode ser especificada explicitamente (por exemplo, sincronizar com release/v2)
Sincronização por tag Opcional: sincronização por uma tag de versão (por exemplo, a documentação da versão v3.0)
Multi-branch Pro+: você pode sincronizar várias branches em paralelo como artigos diferentes

#Histórico e conflitos

  • Histórico de sincronização — a aba "History" no cartão do conector: data, status ( ok / avisos / erro), o número de artigos adicionados / atualizados / excluídos, a duração da execução. Útil para depurar "por que um artigo do repositório não apareceu".
  • Conflitos de edição — se um artigo da fonte foi editado no LiKE (para GitHub/GitLab isso não é permitido por padrão — os artigos são somente leitura). Se o modo for Import (uma cópia única), os artigos tornam-se editáveis e o vínculo com a fonte é rompido.

#Selective Sync para outros conectores

Notion, Confluence, Wiki.js — eles têm sua própria lógica de seleção (uma árvore de páginas), mas o princípio é o mesmo:

  1. Ao conectar, é mostrada a árvore de conteúdo da fonte
  2. Caixas de seleção — marque os nós de que precisa
  3. O restante não é importado
  4. Em uma nova sincronização, apenas os itens selecionados são atualizados

#Conectando o Wiki.js

#Passo 1 — Obtenha um token de API do Wiki.js

  1. Abra o seu Wiki.js → Administration → API Access
  2. Ative a API (se estiver desativada)
  3. Clique em New API Key
  4. Nomeie a chave (por exemplo LiKE Integration)
  5. Grupo: Administrators (é necessário acesso a todas as páginas)
  6. Expiração: sem expiração ou 1 ano
  7. Copie o token gerado

#Passo 2 — Conecte no LiKE

  1. No LiKE, vá para Integrações → Wiki.js → "Conectar"
  2. Insira a URL do seu Wiki.js (por exemplo https://wiki.company.com)
  3. Cole o token de API
  4. Escolha um modo:
Modo Descrição
Sync Um vínculo contínuo — as alterações no Wiki.js aparecem no LiKE automaticamente
Import Uma cópia única de todos os artigos
  1. Clique em Salvar

#Passo 3 — Configure a sincronização

Parâmetro Descrição
Sincronização automática Ativar/desativar atualizações automáticas
Intervalo A cada 6, 12, 24 ou 48 horas
Idioma Filtro pelo idioma do artigo (todos / específico)

#Conectando o Confluence

O Confluence se conecta por meio de OAuth 2.0 — autorização segura sem inserir senhas.

#Passo 1 — Ligue o seu site do Confluence

  1. É necessário o Confluence Cloud — um endereço como sua-empresa.atlassian.net. Confluence Server e Data Center não são suportados
  2. Clique em «Conectar» e entre na sua conta Atlassian
  3. Na janela de acesso, selecione o seu site do Confluence e clique em «Accept». O LiKE verá apenas o que está disponível para você
  4. Aparece «Access denied»? Verifique em start.atlassian.com se a sua conta tem um site do Confluence. Se tiver, peça ao administrador do Atlassian para permitir a conexão de apps: admin.atlassian.com → Apps → seu site → Connected apps → Settings → desativar «Block user apps»

Revise as permissões — o LiKE solicita somente leitura: o conteúdo das páginas e a lista de espaços

#Passo 2 — Onde colocar os artigos e o que trazer

Abra "Configurar" no cartão do Confluence:

Parâmetro Descrição
Espaço alvo para artigos Espaço e Onde colocar — a pasta dentro do espaço onde os artigos ficarão. Se não houver uma adequada — Criar coleção dentro ou Criar novo espaço. O próprio espaço não pode ser o destino
O que sincronizar A árvore do Confluence à direita: espaços e as suas páginas. É relida sempre que a abre
Agendamento A caixa "Ativado" — atualização automática conforme o intervalo
Intervalo de Sincronização A cada 1, 2, 4, 6, 12 ou 24 horas
Excluir artigos removidos da fonte Ativado — uma página excluída no Confluence também é excluída no LiKE, inclusive se já estiver marcada. Desativado — o artigo permanece com a marca "Removido da fonte", e a decisão é sua

Clique em «Sincronizar».

#Como funciona a seleção

O que está marcado O que a sincronização traz
Espaço inteiro Todas as suas páginas, incluindo as que surgirem mais tarde no Confluence. Os artigos do espaço ficam numa pasta própria
Páginas individuais Apenas as marcadas; as novas páginas do espaço não são trazidas

Enquanto nada estiver marcado, não há nada a sincronizar — o cartão indica-o. Um espaço desmarcado é removido do LiKE juntamente com a sua pasta.

#O que não transferimos

  • Espaços pessoais — não aparecem na árvore: são notas pessoais dos colaboradores e o seu nome é o de uma pessoa.
  • Menções de pessoas — uma menção com etiqueta mantém o texto da etiqueta, uma menção sem etiqueta é removida; os responsáveis das tarefas não são transferidos. O LiKE não guarda identificadores nem perfis de utilizadores da Atlassian.

Os artigos do Confluence são somente leitura. Para editar, altere o original no Confluence, e o LiKE atualizará na próxima sincronização.

Ao desconectar o Confluence, você pode manter uma cópia dos artigos no LiKE (eles se tornam editáveis) ou excluí-los.


#Conectando o Notion

#Passo 1 — Crie uma integração no Notion

  1. Abra o Notion → clique no seu avatar (canto superior esquerdo) → Settings
  2. No menu à esquerda, escolha My connections (ou Integrations)
  3. Clique em Develop or manage integrations → New integration
  4. Insira um nome (por exemplo LiKE Import), escolha um workspace
  5. Clique em Submit → copie o Internal Integration Secret (começa com ntn_; para integrações mais antigas — com secret_)

#Passo 2 — Dê à integração acesso às páginas

Por padrão, a integração não tem acesso a nenhuma página. Você precisa permitir isso explicitamente:

  1. No Notion, abra cada página (ou a página/banco de dados pai) que deseja importar
  2. Clique em ⋯ (três pontos, canto superior direito) → Connect to → escolha a sua integração LiKE Import
  3. Confirme o acesso
Dica: Dê acesso à página raiz — todas as páginas filhas automaticamente ficam disponíveis para a integração. Não é necessário conectar cada página separadamente.

#Passo 3 — Conecte no LiKE

  1. No LiKE → Painel de controle → Integrações → Notion → "Conectar"
  2. Cole o Integration Secret (copiado no passo 1)
  3. Escolha onde colocar os artigos: um Espaço e uma pasta dentro dele — ou crie aqui mesmo uma nova pasta ou um novo espaço
  4. Escolha um modo:
Modo Descrição
Sync Um vínculo contínuo — as alterações no Notion aparecem no LiKE automaticamente. Os artigos são somente leitura
Import Uma cópia única. Os artigos tornam-se editáveis no LiKE
  1. No passo "Selecionar conteúdo", marque o que trazer: catálogos inteiros ou páginas individuais. Um catálogo é uma página raiz ou um banco de dados ao qual você deu acesso no passo 2. Enquanto nada estiver marcado, o assistente não deixa avançar
  2. Clique em "Conectar & Sincronizar" — os artigos de cada catálogo ficam numa pasta própria dentro da pasta escolhida no passo 3

#Como funciona a seleção

O que está marcado O que a sincronização traz
Catálogo inteiro Todas as suas páginas — incluindo as que aparecerem no Notion mais tarde
Páginas individuais Apenas as marcadas; as novas páginas desse catálogo não são trazidas

Páginas sem texto — por exemplo, registros de banco de dados apenas com propriedades — não se tornam artigos. O cartão do Notion mostra quantas foram ignoradas: "páginas vazias ignoradas: N".

#Passo 4 — Configurações

Abra "Configurar" no cartão do Notion:

Parâmetro Descrição
Espaço alvo para artigos Espaço e Onde colocar — a pasta que contém as pastas dos catálogos. Pode escolher outra ou criar uma nova
O que sincronizar A árvore do Notion à direita. É relida a cada abertura — as novas páginas dos catálogos selecionados já vêm marcadas. As marcações podem ser alteradas a qualquer momento: um catálogo desmarcado é removido do LiKE junto com a sua pasta
Agendamento A caixa "Ativado" — atualização automática conforme o intervalo
Intervalo de Sincronização A cada 1, 2, 4, 6, 12 ou 24 horas
Excluir artigos removidos da fonte Ativado — uma página excluída no Notion também é excluída no LiKE, inclusive se já estiver marcada. Desativado — o artigo permanece com a marca "Removido da fonte", e a decisão é sua

Ao desconectar o Notion, você pode manter uma cópia dos artigos no LiKE (eles se tornam editáveis) ou excluí-los.


#Conector web

O conector web liga as páginas do seu site ao LiKE em poucos minutos. Cole o endereço — o LiKE encontra as páginas através do mapa do site (sitemap) ou percorrendo as ligações, recolhe o texto delas e mantém a cópia atualizada. A pesquisa por IA do LiKE funciona de imediato sobre estas páginas e, se necessário, pode colocar no site um widget de pesquisa — para clientes ou para funcionários.

Útil quando a sua documentação ou central de ajuda já está publicada — em domínio próprio, no Docusaurus, GitBook, Docsify e semelhantes. O site tem de ser público. Cada organização liga um único site.

#Passo 1 — endereço e forma de encontrar as páginas

Integrações → Conector web → Conectar. Cole o endereço: pode ser o de qualquer página, o site é recolhido por inteiro.

Como encontrar páginas:

  • Pelo sitemap — por predefinição. O sitemap procuramos nós: primeiro em robots.txt, depois em /sitemap.xml;
  • Sem sitemap — seguir links — seguimos as ligações a partir da página inicial dentro deste site; defina a Profundidade da varredura. As páginas que o site desenha por script não são vistas pelo percurso.

Carregue em Verificar o site. Se o sitemap não for encontrado, o assistente propõe ativar o percurso por ligações e verificar de novo.

#Passo 2 — o que vamos importar

A verificação não guarda nada: mostra quantas páginas foram encontradas e quantas serão adicionadas. Se o volume não couber no plano, o assistente di-lo logo, e não depois do percurso.

  • Versão de idioma — aparece se o site servir páginas em vários idiomas. Escolha qual importar; os números e as pastas são recalculados para ela.
  • O que vamos importar — a lista das pastas que vão surgir na base, com o número de páginas de cada uma. Marcada — importamos; uma pasta desmarcada pode ser reposta. O contador Selecionadas conta apenas as marcadas.
  • Os arquivos de etiquetas e categorias — listas de ligações para artigos que serão importados de qualquer forma — não são importados por predefinição; marque-os se forem necessários.
  • Se o site estiver organizado por anos, cada ano torna-se uma pasta própria. Quando há três anos ou mais, ficam marcados os dois anos mais recentes do site; os restantes podem ser marcados manualmente.
  • A página inicial do site torna-se um artigo separado na pasta «Página inicial».
  • Páginas por rastreio — uma definição nossa, não o tamanho do site: o resto é importado nas execuções seguintes.

A que pasta uma página pertence só se vê a partir da própria página, por isso são verificadas mais páginas do que as que serão adicionadas; o assistente mostra os dois números.

Sugestão: o que pegar (apenas com o percurso por ligações). O botão Perguntar ao modelo sugere que grupos de endereços importar e quais não, com os motivos. É uma sugestão, não uma decisão: marque aquilo com que concorda. O consumo é contabilizado como nas operações de IA do editor; a resposta fica memorizada e só é recalculada com o botão Recalcular.

#Passo 3 — como guardar e onde colocar

Como guardar as páginas:

  • Internas — só a equipa as vê — por predefinição;
  • Públicas — todos as veem.

Se a pasta escolhida já estiver aberta a todos, o assistente avisa e propõe Públicas: as páginas nessa pasta ficam acessíveis a todos. Para que só a sua equipa as veja, escolha Internas — assim ficam ocultas mesmo numa pasta aberta. Numa pasta fechada, as páginas internas seguem o acesso dela: se mais tarde tornar a pasta pública, abrem-se com ela — após a verificação de dados pessoais.

Para o acesso público são necessárias as duas confirmações: que tem os direitos sobre o site e o seu conteúdo, e que os dados pessoais no site foram publicados legalmente e que tem o direito de os tornar disponíveis na pesquisa e nas respostas do assistente. Sem elas, o botão Conectar fica inativo. O consentimento é registado — quem, quando e que texto confirmou — e aplica-se a todos os artigos deste site: ao publicá-los, não é preciso confirmar os dados pessoais artigo a artigo. Isto não se aplica aos artigos escritos no editor. Para revogar o consentimento, desligue o site e volte a ligá-lo escolhendo «Internas».

Onde colocar: escolha o Espaço e uma pasta dentro dele. Nenhuma pasta adequada — Criar coleção dentro; nenhum espaço adequado — Criar novo espaço: são criados ao ligar. O próprio espaço não pode ser o destino, e a pasta tem de estar vazia: na pasta de uma fonte só o próprio conector coloca conteúdo.

Depois de Conectar, o percurso começa de imediato: o progresso vê-se no cartão do conector («A sincronizar 22 de 92 selecionadas») e no indicador de tarefas em segundo plano.

#O que é recolhido e o que não é

  • é recolhido o conteúdo da página, sem menu, cabeçalho e rodapé do site;
  • as pastas são marcadas no assistente e, mais tarde, nas definições do conector (Configurar → Pastas do site);
  • secções de serviço, como pesquisa e etiquetas, são ignoradas por predefinição;
  • Páginas por rastreio limita uma única passagem: proteção contra sites muito grandes;
  • as páginas bloqueadas em robots.txt não são recolhidas; o seu número aparece no resumo da execução;
  • na resposta do assistente e no cabeçalho do artigo há a ligação Abrir no site — para a página de origem.

#Atualizações seguintes

Com Atualizar automaticamente ativo, relemos o site conforme o agendamento. Só as páginas alteradas são reindexadas — o resumo di-lo assim: «adicionadas», «atualizadas», «sem alterações». As páginas sem alterações não consomem o limite de indexação.

Eliminar artigos que desapareceram na origem está desativado por predefinição: se uma página desaparecer do site, o artigo permanece na sua base com a marca «desapareceu na origem». Ative-o quando a cópia tiver de refletir o site com rigor.

Mudar a versão de idioma depois de ligar (Configurar → Versão de idioma) altera a composição da fonte. Os artigos da versão anterior deixam de ser atualizados pelo site, por isso o LiKE pergunta o que fazer com eles: Eliminar ou Manter como meus (ficam editáveis). Sem resposta, a definição não é guardada.

#Que sites servem e quais não

Serve um site público — com sitemap, como na maioria dos geradores de documentação, ou sem ele, com o percurso por ligações. O resto recusamos no passo de verificação, e não depois de ligar:

O que impede O que vai ver
Não há sitemap — nem em robots.txt nem em /sitemap.xml O assistente propõe passar ao percurso por ligações
No endereço do sitemap não está XML — normalmente uma página de proteção contra robôs A ligação não será iniciada
Há sitemap, mas após os filtros não sobra nenhuma página A ligação não será iniciada
O robots.txt proíbe percorrer todo o site A ligação não será iniciada
O robots.txt está indisponível por erro do servidor A ligação não será iniciada: «sem resposta» não é o mesmo que «permitido»
O site está protegido por senha ou só é acessível a partir de uma rede interna As páginas não podem ser lidas
O conteúdo é desenhado por scripts já no navegador A página pode chegar quase vazia — lemos o HTML tal como o servidor o devolveu

Mesmo com o site ligado, algumas páginas podem ficar de fora: as bloqueadas no robots.txt, as que respondem com erro, as com mais de 10 MB ou as que não devolvem HTML. Todas aparecem no resumo da execução com o motivo — «ignoradas» e «bloqueadas pelo robots.txt».

Os ficheiros (PDF, ZIP, imagens) não são recolhidos do site. Para eles existe outro caminho: a importação de ficheiros, com o seu próprio processamento.

#Limites

  • um site por organização;
  • o site tem de ser público: páginas protegidas por senha não são lidas;
  • o sitemap não é obrigatório: sem ele funciona o percurso por ligações, que porém só vê aquilo para onde o site aponta;
  • respeitamos o robots.txt, incluindo a pausa entre pedidos que indique.

Desligar. A sincronização para e os artigos já importados podem ser eliminados ou mantidos como artigos normais — o LiKE pergunta isso ao desligar.


#Depois de ligar: pesquisa por IA e um widget no seu site

  1. Quando o percurso terminar, as páginas do site entram na pesquisa por IA do LiKE em pé de igualdade com os artigos escritos no editor, e a resposta aponta para a página de origem — Abrir no site.
  2. Para pesquisar diretamente no seu site, crie um widget: Integrações → Canais → JS Widget → Gerenciar widgets → Criar widget. Em Endereço do site onde o widget vai ficar, indique o endereço deste site.
  3. Escolha o tipo de widget:
    • Público — pesquisa apenas artigos públicos e está aberto a todos os visitantes. Adequado para clientes; para isso, guarde as páginas do site como Públicas (passo 3).
    • Corporativo — pesquisa nos espaços selecionados, incluindo artigos internos, e exige iniciar sessão. Adequado para funcionários.
  4. Adicione um escopo de pesquisa e ative o widget. Para o tipo Público — Todos os artigos públicos ou a pasta (coleção) onde o conector colocou as páginas: um widget público não pode abranger um espaço inteiro. Para o tipo Corporativo — o espaço ou a pasta com as páginas do site.
  5. Copie o Código de incorporação e cole-o no seu site. Onde fazê-lo no WordPress, Tilda, Wix, Webflow, Squarespace, Shopify, Framer, Google Tag Manager e Docusaurus — veja API e widget, secção Onde colar o código nos construtores de sites.

#Importação de arquivos

#Enviando arquivos

  1. Painel de controle → Importação
  2. Arraste os arquivos ou clique na zona de envio
  3. Formatos suportados: PDF, DOCX, TXT, MD, RTF, ZIP
  4. A IA gera automaticamente um título e um slug para cada arquivo
  5. Antes de publicar, você pode editar o título ou abri-lo no editor
Parâmetro Descrição
Tamanho máximo 20 MB por arquivo, arquivo ZIP — 24,8 MB (o máximo de um único envio)
Envio em lote Até 50 arquivos por vez; uma seleção grande é enviada em partes automaticamente
Idioma Detectado automaticamente

#Arquivos ZIP

Envie um arquivo ZIP com muitos documentos — o LiKE descompacta e processa automaticamente cada arquivo. Útil para migrar uma base de conhecimento inteira.

Arquivos suportados dentro de um ZIP: PDF, DOCX, TXT, MD, RTF. Outros arquivos (imagens, executáveis) são ignorados.

#Importação por link

Cole um link para um documento — o LiKE o baixa e importa:

  1. Painel de controle → Importação → a seção "Importação por link"
  2. Cole uma URL → clique em "Adicionar"
  3. Você pode adicionar até 10 links por vez
  4. Clique em "Importar"

Fontes suportadas:

  • Google Docs — exportado automaticamente como DOCX
  • Google Sheets — exportado como CSV
  • Dropbox — um link direto de arquivo
  • Qualquer URL direta para um arquivo PDF, DOCX, TXT, MD ou RTF

#Visibilidade padrão

Para cada fonte, você pode configurar uma visibilidade padrão:

  • Rascunho — os artigos são criados ocultos
  • Equipe — visíveis para usuários autorizados
  • Público — visíveis para todos, inclusive usuários anônimos

Configurada em Integrações → cartão da fonte → Visibilidade.


#Canais de acesso

Os canais permitem que seus funcionários pesquisem informações por meio de ferramentas familiares.

#Bot do Slack

Conectando o Slack:
1. Clique em "Conectar Slack" na seção Integrações
2. Autorize o aplicativo LiKE no seu workspace do Slack
3. Escolha um canal para notificações
4. Pronto — os funcionários usam /like pergunta ou @LiKE

Recursos:

  • /like como configuro o SSO? → uma resposta de IA direto no Slack
  • Mencionar @LiKE em qualquer canal → uma resposta na thread
  • Links para os artigos de origem (clicáveis)

#Bot do Telegram

O bot responde às perguntas da sua equipa diretamente no Telegram, com base na vossa base de conhecimento.

#Passo 1. Criar o bot no Telegram

Os bots não se criam num site, mas dentro do próprio Telegram, através do bot de serviço @BotFather. Procure BotFather no Telegram e escolha aquele que tem visto azul: há muitos nomes parecidos e só o visto identifica o verdadeiro. Abra a conversa, prima Iniciar e envie como mensagem normal:

/newbot

O BotFather fará duas perguntas:

  1. Nome visível — é o que os participantes veem; aceita qualquer idioma e espaços, por exemplo Assistente Lynkora.
  2. Endereço — é por ele que se encontra o bot. Apenas letras latinas, algarismos e sublinhados, e tem de terminar em bot, por exemplo lynkora_help_bot.

Receberá um token, uma cadeia do tipo 8123456789:AAEhBOwe…. Será necessário no passo seguinte. Se o bot já existia e o token se perdeu: comando /mytoken.

O token é a senha do bot. Não o reencaminhe nem o publique. Se se perdeu: /revoke no BotFather — o anterior deixa de funcionar e receberá um novo.

#Passo 2. Ligar o bot ao LiKE

Abra Integrações → Telegram, cole o token no campo Bot Token e prima Ligar. São necessários direitos de proprietário ou administrador.

Se o token for recusado, verifique se copiou a cadeia completa, incluindo os algarismos antes dos dois pontos, e sem espaços nas extremidades. O token de outro bot não serve.

Depois de ligado, o cartão mostra o endereço do bot e a marca Ativo.

#Passo 3. Escolher a fonte das respostas

Prima Configurar e indique o espaço de onde o bot retira as respostas; pode restringir a coleções específicas. Sem esta definição o bot responderá que não sabe, seja qual for a pergunta.

No mesmo ecrã define-se se entrega apenas artigos públicos ou também internos. Os internos exigem que se saiba quem pergunta: veja o passo seguinte.

#Passo 4. Decidir onde o bot funciona

Em conversa privada — um diálogo a sós com o bot. Para que saiba quem escreve, a conversa é associada à conta: na página inicial do portal prima «Perguntar no chat», depois «Obter código de ligação» e envie o código ao bot numa única mensagem. O código é de utilização única e válido por 10 minutos. Depois disso o bot responde segundo as permissões dessa pessoa, incluindo artigos internos. Cada pessoa associa a sua própria conversa.

Num grupo — o bot responde a todos, mas apenas com artigos públicos: numa conversa comum não é possível saber quem pergunta.

Para que funcione no grupo:

  1. Desative a ocultação de mensagens: envie /setprivacy ao BotFather, escolha o bot e prima Disable. Por predefinição o Telegram esconde dos bots as mensagens de grupo, pelo que o bot não vê as perguntas.
  2. Retire o bot do grupo e volte a adicioná-lo: caso contrário a definição não produz efeito, porque o Telegram aplica-a na entrada do bot.
  3. Adicione a conversa do grupo à lista de conversas permitidas nas definições da integração.

#Passo 5. Verificar

Faça uma pergunta sobre um tema presente na base. A resposta chega na mesma conversa, com ligações aos artigos de origem.

O idioma da resposta segue o da pergunta: se perguntar em alemão, responde em alemão. A definição «idioma das mensagens de serviço» abrange apenas recusas e confirmações de ligação.

#Desligar e eliminar

Desligar do LiKE: Integrações → Telegram → «Desligar». O bot deixa de responder e a ligação é removida; o bot permanece no Telegram e pode ser ligado de novo.

Trocar de bot: desligue primeiro o atual e só depois ligue o novo. Pela ordem inversa, o antigo continua apontado ao LiKE e envia mensagens que ninguém processará.

Eliminar o bot por completo: /deletebot no BotFather. A ação é irreversível: o endereço fica livre e o bot não pode ser recuperado.

#Se o bot não responde

O que acontece Causa O que fazer
Silencioso no grupo, responde em privado O Telegram esconde do bot as mensagens do grupo /setprivacy → Disable, depois retirar o bot do grupo e adicioná-lo de novo
Silencioso em todo o lado apesar de ligado Está a escrever a outro bot: nomes parecidos confundem-se Compare o endereço do bot na conversa com o do cartão
Responde que a conversa não está associada A conversa privada não está ligada a uma conta Obtenha o código no portal e envie-o ao bot
No grupo responde apenas com artigos públicos É intencional: numa conversa comum não se vê quem pergunta Para artigos internos escreva ao bot em privado
Deixou de responder após trocar de bot Ligaram o novo sem desligar o anterior Desligue a integração e volte a ligar o bot correto
Responde «não sei» a tudo Não há fonte de respostas selecionada Integrações → Telegram → «Configurar» → escolha um espaço

#Widget JS (para o seu site)

Um botão flutuante de pesquisa por IA para incorporar em qualquer site. A integração mais popular — o usuário vê um botão no canto da página, clica nele, e abre um chat com a IA e a pesquisa em toda a sua base de conhecimento.

#Instalação simples

Instale em 3 passos:
1. Integrações → Canais → cartão "JS Widget" → "Gerenciar widgets" → "Criar widget" → dê um nome, informe o endereço do site e salve
2. Copie o código de incorporação (uma tag `<script>` com uma api-key única)
3. Cole-o antes de </body> em qualquer página do seu site

Quando o volume de respostas de IA se esgota. O widget público simplesmente não aparece na página — nem o botão, nem uma mensagem sobre o limite; a tecla de atalho não funciona. Quando o volume volta a estar disponível, o widget aparece no próximo carregamento da página.

#Parâmetros básicos

Parâmetro Descrição
Nome O nome interno do widget (para o painel administrativo, não visível aos usuários)
Posição Canto inferior esquerdo ou inferior direito
Cor de destaque A cor do botão e dos destaques no chat (extraída da identidade visual por padrão)
Tecla de atalho Por exemplo Ctrl+K / ⌘K para abrir o chat pelo teclado
Botão no site Rinni (predefinido), o balão ou o seu próprio ícone — uma imagem PNG, JPEG ou WebP até 512 KB: é reconstruída no nosso servidor, ao botão chegam apenas os píxeis. Muda no site na hora; o código de incorporação continua o mesmo. Se a imagem não carregar, o site mostra o balão
Fundo do ícone Para o Rinni: sem fundo (predefinido) ou círculo branco — o Rinni fica inteiro lá dentro e não se perde num site carregado. O balão e o seu ícone já estão num círculo
Convite aos visitantes Balão (predefinido): após 3 segundos aparece ao lado do botão um convite a perguntar, que após 15 segundos se recolhe num ponto sobre o botão. Etiqueta: «Fazer uma pergunta» desliza ao lado do botão durante 9 segundos. Desativado — sem convite. Uma vez por visita; um balão fechado com a cruz não aparece durante 7 dias. Não aparece enquanto o widget está aberto, um campo do site tem o foco ou o separador está oculto Com um ícone com nome, o balão cumprimenta em seu nome: «Olá, eu sou Rinni!»; no telemóvel a segunda linha é «Pergunte-me!».
Lembrar Por sinais (predefinido): anéis à volta do botão quando o visitante procura uma resposta — 25 segundos sem atividade, deslocar a página para cima e para baixo, a terceira página da visita; caso contrário, a cada 60–90 segundos. Às vezes — só a cada 60–90 segundos. Nunca. No máximo 3 vezes por página, nenhum depois de abrir o widget. Com a definição do sistema «reduzir movimento» não há anéis nem saltos
Texto próprio do convite Um por idioma, até 140 caracteres. Um idioma sem texto próprio recebe o texto padrão no idioma do visitante
Nome do assistente Até 7 caracteres (letras, algarismos, espaço, hífen), um para todos os idiomas, com qualquer ícone: o assistente cumprimenta com «Olá, eu sou …!» no balão e apresenta-se na janela do widget. Vazio — o Rinni chama-se «Rinni»; o balão e o seu ícone ficam sem nome
No telemóvel e acima das barras do site No telemóvel o botão é mais pequeno e fica mais perto do canto; o balão mostra título e uma linha curta, aparece após 5 segundos e recolhe após 8. Em qualquer dispositivo: se houver uma barra do site fixada no fundo do ecrã sob o botão (aviso de cookies, menu inferior), o botão fica acima dela e o convite espera até a barra desaparecer
Idioma predefinido Aplica-se apenas quando o idioma do visitante é desconhecido: a escolha do visitante na janela do widget e os idiomas do navegador têm prioridade. O idioma da página do site não é considerado
Endereço do site Onde o widget funciona; vários separados por vírgulas. Sem endereço, não é possível ativar o widget
Rodapé "Powered by Lynkora" Pode ser ocultado nos planos com white-label

#Dual-auth: dois modos de autenticação (ADR 0032)

No LiKE, o widget pode funcionar em um de dois modos — escolhido na criação:

Modo 1 — Caminhos permitidos
Para sites públicos
Um widget em uma landing page, páginas de marketing ou uma central de suporte. A autenticação é anônima — qualquer visitante pode usá-lo.
Proteção:
  • Lista de permissões de URLs onde a api-key é válida
  • Escopo = __public__ ou coleções públicas específicas
  • Limite de taxa por api-key
Modo 2 — JWT de sessão
Para um site corporativo com autenticação
Um widget em uma intranet corporativa ou aplicativo SaaS. O widget aceita o JWT de sessão do usuário e vê exatamente aquilo a que ele tem acesso.
Caso de uso:
  • O portal interno da empresa
  • Um widget com reconhecimento de SSO no seu próprio produto
  • Vê os espaços do usuário

Para detalhes sobre a configuração de cada modo e a integração com o seu backend, consulte API e widget.

#Escopo: o que o widget pode encontrar

Ao criar um widget, você define um escopo — o que exatamente ele pesquisa:

Entradas de escopo
public_umbrella — todos os artigos públicos da organização (para um widget de caminhos permitidos)
space:<id> — um espaço específico (para um widget com JWT de sessão)
collection:<id> — uma coleção específica (um escopo restrito, por exemplo apenas o FAQ)

Dentro de um único widget, você pode combinar várias entradas de escopo (por exemplo, duas coleções do mesmo espaço).

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

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

Widget Escopo Onde incorporado
Marketing site widget public_umbrella (KB pública) Em yourcompany.com — anônimo
Support center widget collection:faq-coll Em support.yourcompany.com — apenas FAQ
Intranet widget space:eng-space (por JWT) Em intranet.yourcompany.com — corporativo, vê os espaços por permissões

Cada um tem sua própria api-key e sua análise de uso, e a chave pode ser revogada de forma independente. O gerenciamento está em Integrações → Canais → JS Widget → "Gerenciar widgets".

#Gerenciamento de sessões (modo JWT de sessão)

No modo JWT de sessão, cada sessão de usuário tem um sessionId único. Um admin pode visualizar as sessões ativas de um widget específico e revogar um token à força (por exemplo, se houver suspeita de comprometimento). A lista está em Integrações → Widgets → [widget] → Sessões.

#iframe / Link direto

Incorpore a interface de pesquisa completa do LiKE em qualquer página:

  1. Integrações → iframe → copie o código
  2. Cole <iframe src="..."> na sua página
  3. Ou use o link direto para navegar (uma página completa, não uma incorporação)

O iframe e o Link direto também suportam dual-auth — escolhido na criação.

#REST API

Uma API completa para integração programática (por exemplo, sua própria interface ou integração com outros sistemas):

  1. Integrações → Public API → "Criar chave"
  2. Especifique um nome e os domínios permitidos
  3. Copie a chave — ela é mostrada apenas uma vez; após reabrir, ficará mascarada

Use a chave no cabeçalho X-API-Key. A chave dá acesso apenas a artigos públicos.

Endpoints principais:

Endpoint O que faz
POST /api/public/search Pesquisa por IA na base de conhecimento (fluxo completo: retrieval + resposta + fontes)
GET /api/public/toc Índice dos artigos públicos
GET /api/public/articles Lista de artigos públicos
GET /api/public/articles/{id} Conteúdo do artigo

Limites: as solicitações são limitadas por chave; ao exceder o limite, é retornado HTTP 429 com um cabeçalho Retry-After.

Documentação completa da API: API e widget.


#Idiomas

O LiKE oferece suporte a 25+ idiomas para pesquisa por IA e pesquisa entre idiomas (a própria interface está disponível em 12 locais de UI):

Русский, English, Deutsch, Français, Español, Português, Italiano, Nederlands, Polski, Čeština, Svenska, Dansk, Suomi, Română, Magyar, Hrvatski, Türkçe, Afrikaans, Kiswahili, Bahasa Indonesia, Tiếng Việt, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

Pesquisa entre idiomas: uma pergunta em um idioma → uma resposta a partir de artigos em outro.