Integrazioni

Pannello di controllo → Integrazioni — colleghi fonti di contenuto e canali per accedere alla conoscenza.

#Fonti di contenuto

#Collegate (sempre attive)

#Connettori disponibili

#Collegare GitHub

#Passo 1 — Autorizzazione

1. In LiKE vada su Integrazioni → GitHub → "Collega"
2. Scelga un metodo di autorizzazione:

#Passo 2 — Scelta del contenuto

1. Dopo il collegamento, viene mostrato un albero del repository con cartelle e file
2. Selezioni i file o le cartelle specifici da importare (Selective Sync)
3. Formati supportati: .md, .mdx, pagine Wiki

#Passo 3 — Avvio della sincronizzazione

1. Faccia clic su "Sync"
2. L'avanzamento è mostrato in tempo reale
3. Al termine, gli articoli compaiono nell'elenco con un'etichetta GitHub

#Collegare GitLab

#Passo 1 — Autorizzazione

1. In LiKE vada su Integrazioni → GitLab → "Collega"
2. Scelga un metodo di autorizzazione:

#Passo 2 — Scelta del contenuto

1. Viene mostrato un albero del progetto con pagine Wiki e file Markdown
2. Selezioni le pagine specifiche da importare (Selective Sync)

#Passo 3 — Avvio della sincronizzazione

Come per GitHub — faccia clic su "Sync" e attenda il completamento.

#Collegare Gitea

Gitea è una piattaforma git self-hosted. Si collega tramite un Personal Access Token e un URL obbligatorio della Sua istanza (per impostazione predefinita non esiste una Gitea cloud).

#Passo 1 — Crei un token in Gitea

1. In Gitea apra Settings → Applications → Generate New Token
2. Conceda gli scope read:repository e read:user
3. Copi il token

#Passo 2 — Colleghi in LiKE

1. In LiKE vada su Integrazioni → Gitea → "Collega"
2. Indichi la Base URL della Sua istanza (per esempio https://gitea.company.com) — questo campo è obbligatorio, senza di esso il collegamento non andrà a buon fine
3. Incolli il token
4. Scelga uno spazio/raccolta e una modalità (Sync — un mirror continuo / Import — una copia una tantum)

È supportato anche OAuth 2.0 se l'amministratore di Gitea ha configurato in anticipo un'applicazione OAuth. Il percorso principale è il token.

#Passo 3 — Scelta del contenuto e sincronizzazione

1. Viene mostrato un albero del repository con pagine Wiki e file Markdown (.md, .mdx)
2. Selezioni i nodi che Le servono (Selective Sync) e faccia clic su "Sync"
3. Per gli aggiornamenti automatici al push, configuri un webhook — il segreto viene generato nella scheda del connettore. Gli articoli da Gitea sono read-only (come con GitHub/GitLab)

#Selezione dei file e filtri di sincronizzazione (GitHub, GitLab, Gitea)

Per le fonti git (GitHub, GitLab e Gitea), la logica di scelta di cosa sincronizzare è più articolata di un semplice "repository on/off":

#Cosa viene sincronizzato

#Filtri di percorso (selective sync)

Può restringere esattamente cosa prendere dal repository:

#Rilevamento delle modifiche (recent changes)

LiKE non "scarica tutto" a ogni esecuzione. Viene usato il rilevamento delle modifiche:

• GitHub — tramite webhook (consigliato) o polling usando le intestazioni If-Modified-Since. Il webhook reagisce a un push istantaneamente, il polling — ogni 6/12/24/48 ore (dipende dalla sincronizzazione automatica).
• GitLab — allo stesso modo: webhook o polling per last_activity_at tramite la Projects API.
• Gitea — webhook (firma X-Gitea-Signature) o polling. Il trigger del push scatta solo quando cambiano i *.md/*.mdx.

Una volta rilevata una modifica, vengono sincronizzati solo i file interessati; il resto del corpus non viene ricalcolato. Questo risparmia molta quota della API di GitHub/GitLab e tempo di esecuzione.

#Branch e tag

#Cronologia e conflitti

• Cronologia di sincronizzazione — la scheda "Cronologia" nella scheda del connettore: data, stato (✅ ok / ⚠ avvisi / ❌ errore), numero di articoli aggiunti / aggiornati / eliminati, durata dell'esecuzione. Utile per il debug del "perché un articolo dal repository non è comparso".
• Conflitti di modifica — se un articolo dalla fonte è stato modificato in LiKE (per GitHub/GitLab questo non è consentito per impostazione predefinita — gli articoli sono read-only). Se la modalità è Import (una copia una tantum), gli articoli diventano modificabili e il collegamento alla fonte viene interrotto.

#Selective Sync per gli altri connettori

Notion, Confluence, Wiki.js — hanno la loro logica di selezione (un albero di pagine), ma il principio è lo stesso:

1. Al collegamento, viene mostrato l'albero dei contenuti della fonte
2. Caselle di spunta — segni i nodi che Le servono
3. Il resto non viene importato
4. A una nuova sincronizzazione, vengono aggiornati solo gli elementi selezionati

#Collegare Wiki.js

#Passo 1 — Ottenga un token API di Wiki.js

1. Apra il Suo Wiki.js → Administration → API Access
2. Abiliti la API (se è disabilitata)
3. Faccia clic su New API Key
4. Assegni un nome alla chiave (per esempio LiKE Integration)
5. Gruppo: Administrators (è richiesto l'accesso a tutte le pagine)
6. Scadenza: nessuna scadenza o 1 anno
7. Copi il token generato

#Passo 2 — Colleghi in LiKE

1. In LiKE vada su Integrazioni → Wiki.js → "Collega"
2. Inserisca l'URL del Suo Wiki.js (per esempio https://wiki.company.com)
3. Incolli il token API
4. Scelga una modalità:

5. Faccia clic su Salva

#Passo 3 — Configuri la sincronizzazione

#Collegare Confluence

Confluence si collega tramite OAuth 2.0 — autorizzazione sicura senza inserire password.

#Passo 1 — Faccia clic su "Collega Confluence"

1. In LiKE vada su Pannello di controllo → Integrazioni
2. Trovi la scheda Confluence → faccia clic su "Collega"
3. Si apre la finestra di autorizzazione di Atlassian

#Passo 2 — Autorizzi in Atlassian

1. Acceda al Suo account Atlassian (se non l'ha già fatto)
2. Atlassian mostra una richiesta: "LiKE richiede l'accesso al Suo Confluence"
3. Esamini i permessi — LiKE richiede l'accesso in read-only: il contenuto delle pagine e l'elenco degli spazi
4. Faccia clic su "Accept"

#Passo 3 — Torna in LiKE

Dopo la conferma viene automaticamente reindirizzato a Integrazioni. La scheda di Confluence mostra:

• Stato: Collegato
• Il nome del Suo sito Confluence
• Un pulsante "Sync"

#Passo 4 — Avvii la sincronizzazione

1. Faccia clic su "Sync" per il primo import
2. LiKE carica tutte le pagine dagli spazi Confluence accessibili
3. Gli articoli compaiono nel catalogo della conoscenza

#Passo 5 — Configuri la sincronizzazione automatica

Apra le impostazioni (l'icona dell'ingranaggio sulla scheda di Confluence):

Gli articoli da Confluence sono read-only. Per modificarli, cambi l'originale in Confluence, e LiKE si aggiornerà alla sincronizzazione successiva.

Quando scollega Confluence, può conservare una copia degli articoli in LiKE (diventano modificabili) o eliminarli.

#Collegare Notion

#Passo 1 — Crei un'integrazione in Notion

1. Apra Notion → faccia clic sul Suo avatar (angolo in alto a sinistra) → Settings
2. Nel menu a sinistra scelga My connections (o Integrations)
3. Faccia clic su Develop or manage integrations → New integration
4. Inserisca un nome (per esempio LiKE Import), scelga un workspace
5. Faccia clic su Submit → copi l'Internal Integration Secret (inizia con ntn_; per le integrazioni più vecchie — con secret_)

#Passo 2 — Dia all'integrazione l'accesso alle pagine

Per impostazione predefinita, l'integrazione non ha accesso ad alcuna pagina. Deve consentirlo esplicitamente:

1. In Notion, apra ogni pagina (o la pagina/database principale) che vuole importare
2. Faccia clic su ⋯ (tre puntini, angolo in alto a destra) → Connect to → scelga la Sua integrazione LiKE Import
3. Confermi l'accesso

#Passo 3 — Colleghi in LiKE

1. In LiKE → Pannello di controllo → Integrazioni → Notion → "Collega"
2. Incolli l'Integration Secret (copiato al passo 1)
3. Scelga uno spazio per l'import (esistente o ne crei uno nuovo)
4. Scelga una modalità:

5. Faccia clic su "Collega"
6. LiKE carica tutte le pagine a cui l'integrazione ha accesso

#Passo 4 — Configuri la sincronizzazione automatica

Apra le impostazioni (l'icona dell'ingranaggio sulla scheda di Notion):

Quando scollega Notion, può conservare una copia degli articoli in LiKE (diventano modificabili) o eliminarli.

#Collegare un sito di documentazione

Il connettore preleva gli articoli da un sito pubblico: ne legge la mappa (sitemap) e mantiene una copia in LiKE. Utile quando la documentazione è già pubblicata — su un dominio proprio, in Docusaurus, GitBook, Docsify e simili.

#Passo 1 — indirizzo del sito

Integrazioni → Sito di documentazione → Collega sito. Incolli l'indirizzo: va bene quello di qualsiasi pagina, il sito lo prendiamo per intero. La sitemap la cerchiamo noi: prima in robots.txt, poi in /sitemap.xml.

#Passo 2 — che cosa abbiamo trovato

Prema Verifica sito. La verifica non salva nulla: legge soltanto la sitemap e mostra quante pagine sono state trovate e quante verranno aggiunte con i filtri applicati. Se la sitemap manca, il collegamento non si stabilisce e lo diciamo chiaramente, invece di importare zero pagine in silenzio.

#Passo 3 — dove collocarlo

Scelga lo spazio e la raccolta: la raccolta si può creare direttamente nella procedura guidata. Dopo Collega, la scansione parte subito: l'avanzamento è visibile sulla scheda del connettore («Scansione del sito 22 di 92») e nell'indicatore delle attività in background.

#Che cosa viene preso e che cosa no

• viene preso il contenuto della pagina, senza menu, intestazione e piè di pagina del sito;
• Sezioni del sito limitano la scansione per percorso (/docs/, /guides/); se vuoto, prendiamo tutto il sito;
• le sezioni di servizio come ricerca e tag vengono saltate per impostazione predefinita;
• Pagine per esecuzione limita la singola passata: protezione dai siti molto grandi;
• le pagine vietate in robots.txt non vengono prelevate; il loro numero compare nel riepilogo dell'esecuzione.

#Aggiornamenti successivi

Con la sincronizzazione automatica attiva rileggiamo il sito secondo la pianificazione. Vengono reindicizzate solo le pagine modificate: il riepilogo lo dice così — «aggiunte», «aggiornate», «invariate». Le pagine invariate non consumano il limite di indicizzazione.

Rimuovere le pagine scomparse è disattivato per impostazione predefinita: se una pagina sparisce dal sito, l'articolo resta nella sua base. Lo attivi se la copia deve rispecchiare il sito in modo rigoroso.

#Quali siti sono adatti e quali no

È adatto un sito pubblico con sitemap: così sono fatti quasi tutti i generatori di documentazione. Il resto lo rifiutiamo al passo di verifica, non dopo il collegamento:

Anche a sito collegato alcune pagine possono restare fuori: quelle vietate in robots.txt, quelle che rispondono con errore, quelle oltre 10 MB o quelle che non restituiscono HTML. Tutte compaiono nel riepilogo dell'esecuzione con il motivo: «saltate» e «bloccate da robots.txt».

I file (PDF, ZIP, immagini) non vengono presi dal sito. Per loro esiste un percorso separato: l'import di file, con la propria elaborazione.

#Limiti

• un sito per organizzazione;
• il sito deve essere pubblico: le pagine protette da password non vengono lette;
• serve la sitemap: senza di essa il collegamento non avviene;
• rispettiamo robots.txt, inclusa la pausa tra le richieste che vi è indicata.

Disconnessione. La sincronizzazione si interrompe; gli articoli già importati può eliminarli o mantenerli come articoli ordinari — LiKE lo chiede al momento della disconnessione.

#Import di file

#Caricamento dei file

1. Pannello di controllo → Import
2. Trascini i file o faccia clic sulla zona di caricamento
3. Formati supportati: PDF, DOCX, TXT, MD, RTF, ZIP
4. L'AI genera automaticamente un titolo e uno slug per ogni file
5. Prima della pubblicazione può modificare il titolo o aprirlo nell'editor

#Archivi ZIP

Carichi un archivio ZIP con molti documenti — LiKE lo estrae ed elabora automaticamente ogni file. Comodo per migrare un'intera base di conoscenza.

File supportati all'interno di uno ZIP: PDF, DOCX, TXT, MD, RTF. Gli altri file (immagini, eseguibili) vengono ignorati.

#Import da link

Incolli un link a un documento — LiKE lo scarica e lo importa:

1. Pannello di controllo → Import → la sezione "Import da link"
2. Incolli un URL → faccia clic su "Aggiungi"
3. Può aggiungere fino a 10 link per volta
4. Faccia clic su "Import"

Fonti supportate:

• Google Docs — esportato automaticamente come DOCX
• Google Sheets — esportato come CSV
• Dropbox — un link diretto al file
• Qualsiasi URL diretto a un file PDF, DOCX, TXT, MD o RTF

#Visibilità predefinita

Per ogni fonte può configurare una visibilità predefinita:

• Bozza — gli articoli vengono creati nascosti
• Team — visibili agli utenti autorizzati
• Pubblico — visibili a tutti, inclusi gli utenti anonimi

Si configura in Integrazioni → scheda della fonte → Visibilità.

#Canali di accesso

I canali consentono ai Suoi dipendenti di cercare informazioni tramite strumenti familiari.

#Bot Slack

Funzionalità:

• /like come configuro l'SSO? → una risposta AI direttamente in Slack
• Menzionando @LiKE in qualsiasi canale → una risposta nel thread
• Link agli articoli sorgente (cliccabili)

#Bot Telegram

Funzionalità:

• Messaggi diretti al bot → una risposta AI
• In una chat di gruppo: /ask domanda → una risposta
• Supporto per 25+ lingue

#Widget JS (per il Suo sito web)

Un pulsante flottante di ricerca AI da incorporare in qualsiasi sito web. L'integrazione più diffusa — un utente vede un pulsante nell'angolo della pagina, ci fa clic e si apre una chat con l'AI e la ricerca nella Sua base di conoscenza.

#Installazione semplice

#Parametri di base

#Dual-auth: due modalità di autenticazione (ADR 0032)

In LiKE il widget può funzionare in una di due modalità — scelta alla creazione:

Per i dettagli sulla configurazione di ciascuna modalità e sull'integrazione con il Suo backend, veda API e widget.

#Scope: cosa può trovare il widget

Quando crea un widget, imposta uno scope — cosa esattamente cerca:

All'interno di un singolo widget può combinare più voci di scope (per esempio, due raccolte dallo stesso spazio).

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

All'interno di un'organizzazione può creare più widget indipendenti con scope e modalità diversi:

Ognuno ha la propria api-key e le proprie analitiche d'uso, e la chiave può essere revocata in modo indipendente. La gestione è in Integrazioni → Widget → "+ Crea".

#Gestione delle sessioni (modalità Session JWT)

In modalità Session JWT, ogni sessione utente ha un sessionId univoco. Un admin può visualizzare le sessioni attive di un widget specifico e revocare forzatamente un token (per esempio, se si sospetta una compromissione). L'elenco è in Integrazioni → Widget → [widget] → Sessioni.

#iframe / Direct Link

Incorpori l'intera interfaccia di ricerca LiKE in qualsiasi pagina:

1. Integrazioni → iframe → copi il codice
2. Incolli <iframe src="..."> nella Sua pagina
3. Oppure usi il link diretto per navigare (una pagina intera, non un incorporamento)

iframe e Direct Link supportano anch'essi il dual-auth — scelto alla creazione.

#REST API

Una API completa per l'integrazione programmatica (per esempio, una Sua UI o l'integrazione con altri sistemi):

1. Integrazioni → API Keys → "Crea chiave"
2. Indichi un nome (a cosa serve la chiave) e uno scope (uguale a quello di un widget — public_umbrella / space / collection)
3. Copi la chiave — viene mostrata una sola volta, dopo la riapertura sarà mascherata

Usi la chiave nell'intestazione X-API-Key o come Bearer token.

Endpoint principali:

Limiti: i rate limit dipendono dal piano e sono legati alla api-key. Il loro superamento restituisce HTTP 429 con un'intestazione Retry-After. I valori esatti per il Suo piano sono nella pagina Piani e nel pannello di amministrazione.

Documentazione API completa: API e widget.

#Lingue

LiKE supporta 25+ lingue per la ricerca AI e la ricerca cross-linguistica (l'interfaccia stessa è disponibile in 11 locale 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, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

Ricerca cross-linguistica: una domanda in una lingua → una risposta da articoli in un'altra.