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
- No LiKE, vá para Integrações → GitHub → "Conectar"
- 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
- Após conectar, é mostrada uma árvore do repositório com pastas e arquivos
- Marque os arquivos ou pastas específicos a importar (Selective Sync)
- Formatos suportados:
.md,.mdx, páginas Wiki
#Passo 3 — Executando a sincronização
- Clique em "Sync"
- O progresso é mostrado em tempo real
- Ao concluir, os artigos aparecem na lista com um rótulo GitHub
#Conectando o GitLab
#Passo 1 — Autorização
- No LiKE, vá para Integrações → GitLab → "Conectar"
- 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
- É mostrada uma árvore do projeto com páginas Wiki e arquivos Markdown
- 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
- No Gitea, abra Settings → Applications → Generate New Token
- Conceda os escopos
read:repositoryeread:user - Copie o token
#Passo 2 — Conecte no LiKE
- No LiKE, vá para Integrações → Gitea → "Conectar"
- 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 - Cole o token
- 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
- É mostrada uma árvore do repositório com páginas Wiki e arquivos Markdown (
.md,.mdx) - Marque os nós de que você precisa (Selective Sync) e clique em "Sync"
- 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:
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_atvia a Projects API. - Gitea — webhook (assinatura
X-Gitea-Signature) ou polling. O gatilho de push dispara apenas quando*.md/*.mdxmuda.
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:
- Ao conectar, é mostrada a árvore de conteúdo da fonte
- Caixas de seleção — marque os nós de que precisa
- O restante não é importado
- 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
- Abra o seu Wiki.js → Administration → API Access
- Ative a API (se estiver desativada)
- Clique em New API Key
- Nomeie a chave (por exemplo
LiKE Integration) - Grupo: Administrators (é necessário acesso a todas as páginas)
- Expiração: sem expiração ou 1 ano
- Copie o token gerado
#Passo 2 — Conecte no LiKE
- No LiKE, vá para Integrações → Wiki.js → "Conectar"
- Insira a URL do seu Wiki.js (por exemplo
https://wiki.company.com) - Cole o token de API
- 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 |
- 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
- É necessário o Confluence Cloud — um endereço como sua-empresa.atlassian.net. Confluence Server e Data Center não são suportados
- Clique em «Conectar» e entre na sua conta Atlassian
- 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ê
- 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
- Abra o Notion → clique no seu avatar (canto superior esquerdo) → Settings
- No menu à esquerda, escolha My connections (ou Integrations)
- Clique em Develop or manage integrations → New integration
- Insira um nome (por exemplo
LiKE Import), escolha um workspace - Clique em Submit → copie o Internal Integration Secret (começa com
ntn_; para integrações mais antigas — comsecret_)
#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:
- No Notion, abra cada página (ou a página/banco de dados pai) que deseja importar
- Clique em ⋯ (três pontos, canto superior direito) → Connect to → escolha a sua integração
LiKE Import - Confirme o acesso
#Passo 3 — Conecte no LiKE
- No LiKE → Painel de controle → Integrações → Notion → "Conectar"
- Cole o Integration Secret (copiado no passo 1)
- 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
- 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 |
- 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
- 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.txtnã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
- 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.
- 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.
- 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.
- 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.
- 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
- Painel de controle → Importação
- Arraste os arquivos ou clique na zona de envio
- Formatos suportados: PDF, DOCX, TXT, MD, RTF, ZIP
- A IA gera automaticamente um título e um slug para cada arquivo
- 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:
- Painel de controle → Importação → a seção "Importação por link"
- Cole uma URL → clique em "Adicionar"
- Você pode adicionar até 10 links por vez
- 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
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
@LiKEem 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:
/newbotO BotFather fará duas perguntas:
- Nome visível — é o que os participantes veem; aceita qualquer idioma e espaços, por exemplo
Assistente Lynkora. - Endereço — é por ele que se encontra o bot. Apenas letras latinas, algarismos e sublinhados, e tem de terminar em
bot, por exemplolynkora_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.
/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:
- Desative a ocultação de mensagens: envie
/setprivacyao 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. - 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.
- 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
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:
- 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
- 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:
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:
- Integrações → iframe → copie o código
- Cole
<iframe src="...">na sua página - 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):
- Integrações → Public API → "Criar chave"
- Especifique um nome e os domínios permitidos
- 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.