Integrazioni

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

#Fonti di contenuto

#Collegate (sempre attive)

#Connettori disponibili

Il numero di fonti collegate è limitato dal piano. Quando il limite è raggiunto, il pulsante «Collegati» delle fonti non è attivo: scolleghi una fonte o passi a un piano superiore. I bot Slack e Telegram non rientrano in questo limite.

#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 dove mettere gli articoli (uno Spazio e una cartella al suo interno — oppure ne crei di nuovi) 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 — Colleghi il Suo sito Confluence

1. Serve Confluence Cloud — un indirizzo come la-tua-azienda.atlassian.net. Confluence Server e Data Center non sono supportati
2. Clicca «Connetti» e accedi al tuo account Atlassian
3. Nella finestra di accesso seleziona il tuo sito Confluence e clicca «Accept». LiKE vedrà solo ciò che è accessibile a te
4. Vedi «Access denied»? Verifica su start.atlassian.com che il tuo account abbia un sito Confluence. Se il sito c'è, chiedi all'amministratore Atlassian di consentire il collegamento delle app: admin.atlassian.com → Apps → il tuo sito → Connected apps → Settings → disattiva «Block user apps»

Esamini i permessi — LiKE richiede l'accesso in read-only: il contenuto delle pagine e l'elenco degli spazi

#Passo 2 — Dove mettere gli articoli e cosa prendere

Apra "Configura" sulla scheda di Confluence:

Clicchi su «Sincronizza».

#Come funziona la selezione

Finché nulla è selezionato, non c'è niente da sincronizzare: la scheda lo segnala. Uno spazio deselezionato viene rimosso da LiKE insieme alla sua cartella.

#Cosa non trasferiamo

• Spazi personali — non compaiono nell'albero: sono note personali dei dipendenti e il loro nome è quello di una persona.
• Menzioni di persone — una menzione con etichetta mantiene il testo dell'etichetta, una menzione senza etichetta viene rimossa; gli assegnatari delle attività non vengono trasferiti. LiKE non conserva identificativi né profili degli utenti Atlassian.

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 dove mettere gli articoli: uno Spazio e una cartella al suo interno — oppure crei qui stesso una nuova cartella o un nuovo spazio
4. Scelga una modalità:

5. Al passo "Seleziona contenuto" selezioni che cosa prendere: cataloghi interi o singole pagine. Un catalogo è una pagina radice o un database a cui ha dato accesso al passo 2. Finché non è selezionato nulla, la procedura guidata non La lascia proseguire
6. Faccia clic su "Collegati e Sincronizza" — gli articoli di ogni catalogo vanno nella loro cartella, all'interno della cartella scelta al passo 3

#Come funziona la selezione

Le pagine senza testo — ad esempio i record di un database con sole proprietà — non diventano articoli. La scheda di Notion mostra quante ne sono state saltate: "pagine vuote saltate: N".

#Passo 4 — Impostazioni

Apra "Configura" sulla scheda di Notion:

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

#Connettore web

Il connettore web collega le pagine del Suo sito web a LiKE in un paio di minuti. Incolli l'indirizzo: LiKE trova le pagine tramite la sitemap o percorrendo i link, ne preleva il testo e mantiene la copia aggiornata. La ricerca AI di LiKE funziona subito su queste pagine e, se serve, sul sito si può inserire un widget di ricerca — per i clienti o per i dipendenti.

Utile quando la Sua documentazione o il Suo centro assistenza è già pubblicato — su un dominio proprio, in Docusaurus, GitBook, Docsify e simili. Il sito deve essere pubblico. Ogni organizzazione collega un solo sito.

#Passo 1 — indirizzo e modo di trovare le pagine

Integrazioni → Connettore web → Collega. Incolli l'indirizzo: va bene quello di qualsiasi pagina, il sito lo prendiamo per intero.

Come trovare le pagine:

• Dalla sitemap — impostazione predefinita. La mappa la cerchiamo noi: prima in robots.txt, poi in /sitemap.xml;
• Nessuna sitemap — segui i link — seguiamo i link a partire dalla pagina principale entro questo sito; imposti la Profondità della scansione. Le pagine che il sito disegna tramite script non vengono viste da questa scansione.

Prema Controlla il sito. Se la mappa non viene trovata, la procedura guidata propone di attivare la scansione tramite link e di controllare di nuovo.

#Passo 2 — che cosa importeremo

La verifica non salva nulla: mostra quante pagine sono state trovate e quante verranno aggiunte. Se il volume non rientra nel piano, la procedura guidata lo dice subito, non dopo la scansione.

• Versione linguistica — compare se il sito offre le pagine in più lingue. Scelga quale importare; numeri e cartelle vengono ricalcolati di conseguenza.
• Che cosa importeremo — l'elenco delle cartelle che si otterranno nella base, con il numero di pagine di ciascuna. Spuntata — la importiamo; una cartella tolta si può rimettere. Il contatore Selezionate considera solo quelle spuntate.
• Gli archivi di tag e categorie — liste di link ad articoli che verranno comunque importati — non vengono importati per impostazione predefinita; li spunti se servono.
• Se il sito è organizzato per anni, ogni anno diventa una cartella a sé. Quando gli anni sono tre o più, sono spuntati i due anni più recenti del sito; gli altri si possono spuntare a mano.
• La pagina principale del sito diventa un articolo a sé nella cartella «Home».
• Pagine per scansione — è una nostra impostazione, non la dimensione del sito: il resto verrà importato nelle esecuzioni successive.

L'appartenenza di una pagina a una cartella si vede solo dalla pagina stessa, quindi vengono controllate più pagine di quante ne verranno aggiunte; la procedura guidata mostra entrambi i numeri.

Suggerimento: che cosa prendere (solo con la scansione tramite link). Il pulsante Chiedi al modello propone quali gruppi di indirizzi prendere e quali no, con le motivazioni. È una proposta, non una decisione: spunti ciò con cui è d'accordo. Il consumo viene conteggiato come per le operazioni IA dell'editor; la risposta viene memorizzata e ricalcolata solo con il pulsante Ricalcola.

#Passo 3 — come salvare e dove collocare

Come salvare le pagine:

• Interne: le vede solo il team — impostazione predefinita;
• Pubbliche: le vedono tutti.

Se la cartella scelta è già aperta a tutti, la procedura guidata La avvisa e propone Pubbliche: le pagine in tale cartella sono accessibili a tutti. Perché le veda solo il Suo team, scelga Interne: resteranno nascoste anche in una cartella aperta. In una cartella chiusa le pagine interne ne seguono l’accesso: se in seguito rende pubblica la cartella, si apriranno con essa, dopo la verifica dei dati personali.

Per l'accesso pubblico servono entrambe le spunte: che Lei ha i diritti sul sito e sul suo contenuto, e che i dati personali presenti sul sito sono pubblicati lecitamente e Lei ha il diritto di renderli disponibili nella ricerca e nelle risposte dell'assistente. Senza di esse il pulsante Collega non è attivo. Il consenso viene registrato — chi, quando e quale testo ha confermato — e vale per tutti gli articoli di questo sito: alla loro pubblicazione non occorre confermare i dati personali articolo per articolo. Non si applica agli articoli scritti nell'editor. Per revocare il consenso, scolleghi il sito e lo ricolleghi scegliendo «Interne».

Dove metterlo: scelga lo Spazio e una cartella al suo interno. Nessuna cartella adatta — Crea raccolta all’interno; nessuno spazio adatto — Crea nuovo spazio: vengono creati al collegamento. Lo spazio stesso non può essere la destinazione, e la cartella deve essere vuota: nella cartella di una fonte scrive solo il connettore stesso.

Dopo Collega, la scansione parte subito: l'avanzamento è visibile sulla scheda del connettore («Sincronizziamo 22 di 92 selezionate») 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;
• le cartelle si spuntano nella procedura guidata e in seguito nelle impostazioni del connettore (Configura → Cartelle del sito);
• le sezioni di servizio come ricerca e tag vengono saltate per impostazione predefinita;
• Pagine per scansione 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;
• nella risposta dell'assistente e nell'intestazione dell'articolo c'è il link Apri sul sito, che porta alla pagina originale.

#Aggiornamenti successivi

Con Aggiorna automaticamente attivo 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.

Eliminare gli articoli spariti nella fonte è disattivato per impostazione predefinita: se una pagina sparisce dal sito, l'articolo resta nella base con la nota «sparita nella fonte». Lo attivi se la copia deve rispecchiare il sito in modo rigoroso.

Il cambio di versione linguistica dopo il collegamento (Configura → Versione linguistica) modifica la composizione della fonte. Gli articoli della versione precedente non vengono più aggiornati dal sito, quindi LiKE chiederà che cosa farne: Elimina o Conserva come miei (diventeranno modificabili). Senza una risposta l'impostazione non viene salvata.

#Quali siti sono adatti e quali no

È adatto un sito pubblico — con sitemap, come nella maggior parte dei generatori di documentazione, oppure senza, con la scansione tramite link. 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;
• la sitemap non è obbligatoria: senza di essa funziona il percorso dei link, che però vede solo ciò a cui il sito rimanda;
• 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.

#Dopo il collegamento: ricerca AI e un widget sul Suo sito

1. Al termine della scansione, le pagine del sito partecipano alla ricerca AI di LiKE alla pari degli articoli scritti nell'editor, e la risposta rimanda alla pagina originale — Apri sul sito.
2. Per cercare direttamente sul Suo sito, crei un widget: Integrazioni → Canali → JS Widget → Gestisci widget → Crea widget. In Indirizzo del sito dove sarà il widget, inserisca l'indirizzo di questo sito.
3. Scelga il tipo di widget:
   • Pubblico — cerca solo negli articoli pubblici ed è aperto a tutti i visitatori. Adatto ai clienti; a questo scopo salvi le pagine del sito come Pubbliche (passo 3).
   • Aziendale — cerca negli spazi selezionati, articoli interni compresi, e richiede l'accesso. Adatto ai dipendenti.
4. Aggiunga un ambito di ricerca e abiliti il widget. Per il tipo Pubblico — Tutti gli articoli pubblici o la cartella (collezione) in cui il connettore ha inserito le pagine: un widget pubblico non può coprire un intero spazio. Per il tipo Aziendale — lo spazio o la cartella con le pagine del sito.
5. Copi il Codice di incorporamento e lo incolli nel Suo sito. Dove farlo in WordPress, Tilda, Wix, Webflow, Squarespace, Shopify, Framer, Google Tag Manager e Docusaurus — veda API e widget, sezione Dove incollare il codice nei costruttori di siti.

#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

Il bot risponde alle domande del Suo team direttamente in Telegram, attingendo alla Vostra base di conoscenza.

#Passaggio 1. Creare il bot in Telegram

I bot non si creano su un sito, ma dentro Telegram stesso, tramite il bot di servizio @BotFather. Cerchi BotFather in Telegram e scelga quello con la spunta blu: i nomi simili sono molti e solo la spunta indica quello autentico. Apra la chat, prema Avvia e invii come normale messaggio:

/newbot

BotFather porrà due domande:

1. Nome visibile — lo vedono i partecipanti alla chat; ammette qualsiasi lingua e spazi, per esempio Assistente Lynkora.
2. Indirizzo — serve a trovare il bot nella ricerca. Solo lettere latine, cifre e trattini bassi, e deve terminare con bot, per esempio lynkora_help_bot.

Riceverà un token, una stringa del tipo 8123456789:AAEhBOwe…. Serve al passaggio successivo. Se il bot esiste già e il token è andato perso: comando /mytoken.

#Passaggio 2. Collegare il bot a LiKE

Apra Integrazioni → Telegram, incolli il token nel campo Bot Token e prema Collega. Servono i diritti di proprietario o amministratore.

Se il token viene rifiutato, verifichi di aver copiato l'intera stringa, cifre prima dei due punti comprese, senza spazi ai lati. Il token di un altro bot non è valido.

A collegamento avvenuto la scheda mostra l'indirizzo del bot e la dicitura Attivo.

#Passaggio 3. Scegliere la fonte delle risposte

Prema Configura e indichi lo spazio da cui il bot trae le risposte; è possibile restringere a singole raccolte. Senza questa impostazione il bot risponderà di non sapere, qualunque sia la domanda.

Nella stessa schermata si decide se fornire solo articoli pubblici oppure anche interni. Gli interni richiedono che l'autore della domanda sia identificato: veda il passaggio seguente.

#Passaggio 4. Stabilire dove opera il bot

In chat privata — una conversazione a due con il bot. Perché sappia chi scrive, la chat va collegata all'account: nella pagina iniziale del portale prema «Chiedi in chat», poi «Ottieni codice di collegamento» e invii il codice al bot in un unico messaggio. Il codice è monouso e vale 10 minuti. Dopo il collegamento il bot risponde secondo i diritti di quella persona, articoli interni inclusi. Ciascuno collega la propria chat.

In un gruppo — il bot risponde a tutti, ma solo con articoli pubblici: in una chat condivisa non è possibile stabilire chi stia chiedendo.

Perché funzioni nel gruppo:

1. Disattivi l'occultamento dei messaggi: invii /setprivacy a BotFather, scelga il bot e prema Disable. Per impostazione predefinita Telegram nasconde ai bot i messaggi dei gruppi, perciò il bot non vede le domande.
2. Rimuova il bot dal gruppo e lo aggiunga di nuovo: altrimenti l'impostazione non ha effetto, perché Telegram la applica all'ingresso del bot.
3. Aggiunga la chat del gruppo all'elenco delle chat consentite nelle impostazioni dell'integrazione.

#Passaggio 5. Verificare

Ponga una domanda su un tema presente nella base. La risposta arriva nella stessa chat con i collegamenti agli articoli di origine.

La lingua della risposta segue quella della domanda: se chiede in tedesco, riceve tedesco. L'impostazione «lingua dei messaggi di servizio» riguarda solo rifiuti e conferme di collegamento.

#Disconnessione ed eliminazione

Scollegare da LiKE: Integrazioni → Telegram → «Disconnetti». Il bot smette di rispondere e il collegamento viene rimosso; il bot resta in Telegram e può essere ricollegato.

Cambiare bot: scolleghi prima quello attuale, poi colleghi il nuovo. In ordine inverso il vecchio resta puntato su LiKE e invia messaggi che nessuno elaborerà.

Eliminare del tutto il bot: /deletebot in BotFather. L'operazione è irreversibile: l'indirizzo si libera e il bot non è recuperabile.

#Se il bot non risponde

#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

Quando il volume di risposte AI è esaurito. Il widget pubblico non viene mostrato affatto sulla pagina — né il pulsante né un messaggio sul limite; il tasto di scelta rapida non funziona. Quando il volume torna disponibile, il widget ricompare al successivo caricamento della pagina.

#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 → Canali → JS Widget → "Gestisci widget".

#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 → Public API → "Crea chiave"
2. Indichi un nome e i domini consentiti
3. Copi la chiave — viene mostrata una sola volta, dopo la riapertura sarà mascherata

Usi la chiave nell'intestazione X-API-Key. Tramite la chiave vengono restituiti solo gli articoli pubblici.

Endpoint principali:

Limiti: le richieste sono limitate per ciascuna chiave; il superamento restituisce HTTP 429 con un'intestazione Retry-After.

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 12 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.