Intégrations

Panneau de contrôle → Intégrations — connectez des sources de contenu et des canaux d'accès à la connaissance.

#Sources de contenu

#Connectées (toujours actives)

#Connecteurs disponibles

#Connecter GitHub

#Étape 1 — Autorisation

1. Dans LiKE, allez dans Intégrations → GitHub → « Connecter »
2. Choisissez une méthode d'autorisation :

#Étape 2 — Choisir le contenu

1. Après la connexion, une arborescence du dépôt avec les dossiers et fichiers est affichée
2. Cochez les fichiers ou dossiers spécifiques à importer (Selective Sync)
3. Formats pris en charge : .md, .mdx, pages Wiki

#Étape 3 — Lancer la synchronisation

1. Cliquez sur « Sync »
2. La progression est affichée en temps réel
3. Une fois terminé, les articles apparaissent dans la liste avec une étiquette GitHub

#Connecter GitLab

#Étape 1 — Autorisation

1. Dans LiKE, allez dans Intégrations → GitLab → « Connecter »
2. Choisissez une méthode d'autorisation :

#Étape 2 — Choisir le contenu

1. Une arborescence du projet avec les pages Wiki et les fichiers Markdown est affichée
2. Cochez les pages spécifiques à importer (Selective Sync)

#Étape 3 — Lancer la synchronisation

Comme pour GitHub — cliquez sur « Sync » et attendez la fin.

#Connecter Gitea

Gitea est une plateforme git auto-hébergée. Elle se connecte via un Personal Access Token et une URL obligatoire de votre instance (il n'y a pas de Gitea cloud par défaut).

#Étape 1 — Créer un token dans Gitea

1. Dans Gitea, ouvrez Settings → Applications → Generate New Token
2. Accordez les scopes read:repository et read:user
3. Copiez le token

#Étape 2 — Connecter dans LiKE

1. Dans LiKE, allez dans Intégrations → Gitea → « Connecter »
2. Indiquez la Base URL de votre instance (par exemple https://gitea.company.com) — ce champ est obligatoire, sans lui la connexion n'aboutira pas
3. Collez le token
4. Choisissez un espace/collection et un mode (Sync — un miroir continu / Import — une copie ponctuelle)

OAuth 2.0 est également pris en charge si l'administrateur Gitea a configuré au préalable une application OAuth. La voie principale est le token.

#Étape 3 — Choisir le contenu et synchroniser

1. Une arborescence du dépôt avec les pages Wiki et les fichiers Markdown (.md, .mdx) est affichée
2. Cochez les nœuds dont vous avez besoin (Selective Sync) et cliquez sur « Sync »
3. Pour les mises à jour automatiques au push, configurez un webhook — le secret est généré dans la carte du connecteur. Les articles de Gitea sont en lecture seule (comme pour GitHub/GitLab)

#Sélection de fichiers et filtres de synchronisation (GitHub, GitLab, Gitea)

Pour les sources git (GitHub, GitLab et Gitea), la logique du choix de ce qu'il faut synchroniser est plus fine qu'un simple « dépôt on/off » :

#Ce qui est synchronisé

#Filtres de chemin (selective sync)

Vous pouvez préciser exactement ce qu'il faut prendre dans le dépôt :

#Détection des changements (recent changes)

LiKE ne « télécharge pas tout » à chaque exécution. La détection des changements est utilisée :

• GitHub — via webhook (recommandé) ou polling à l'aide des en-têtes If-Modified-Since. Le webhook réagit à un push instantanément, le polling — toutes les 6/12/24/48 heures (selon l'auto-synchronisation).
• GitLab — de même : webhook ou polling par last_activity_at via la Projects API.
• Gitea — webhook (signature X-Gitea-Signature) ou polling. Le déclencheur push ne s'active que lorsque des *.md/*.mdx changent.

Une fois un changement détecté, seuls les fichiers concernés sont synchronisés ; le reste du corpus n'est pas recalculé. Cela économise beaucoup de quota d'API GitHub/GitLab et de temps d'exécution.

#Branche et tags

#Historique et conflits

• Historique de synchronisation — l'onglet « History » dans la carte du connecteur : date, statut (✅ ok / ⚠ avertissements / ❌ erreur), le nombre d'articles ajoutés / mis à jour / supprimés, la durée d'exécution. Utile pour déboguer « pourquoi un article du dépôt n'est pas apparu ».
• Conflits d'édition — si un article de la source a été modifié dans LiKE (pour GitHub/GitLab, ce n'est pas autorisé par défaut — les articles sont en lecture seule). Si le mode est Import (une copie ponctuelle), les articles deviennent modifiables et le lien avec la source est rompu.

#Selective Sync pour les autres connecteurs

Notion, Confluence, Wiki.js — ils ont leur propre logique de sélection (une arborescence de pages), mais le principe est le même :

1. À la connexion, l'arborescence de contenu de la source est affichée
2. Cases à cocher — marquez les nœuds dont vous avez besoin
3. Le reste n'est pas importé
4. À une nouvelle synchronisation, seuls les éléments sélectionnés sont mis à jour

#Connecter Wiki.js

#Étape 1 — Obtenir un token API Wiki.js

1. Ouvrez votre Wiki.js → Administration → API Access
2. Activez l'API (si elle est désactivée)
3. Cliquez sur New API Key
4. Nommez la clé (par exemple LiKE Integration)
5. Groupe : Administrators (l'accès à toutes les pages est requis)
6. Expiration : sans expiration ou 1 an
7. Copiez le token généré

#Étape 2 — Connecter dans LiKE

1. Dans LiKE, allez dans Intégrations → Wiki.js → « Connecter »
2. Saisissez l'URL de votre Wiki.js (par exemple https://wiki.company.com)
3. Collez le token API
4. Choisissez un mode :

5. Cliquez sur Save

#Étape 3 — Configurer la synchronisation

#Connecter Confluence

Confluence se connecte via OAuth 2.0 — une autorisation sécurisée sans saisir de mots de passe.

#Étape 1 — Cliquer sur « Connecter Confluence »

1. Dans LiKE, allez dans Panneau de contrôle → Intégrations
2. Trouvez la carte Confluence → cliquez sur « Connecter »
3. La fenêtre d'autorisation Atlassian s'ouvre

#Étape 2 — Autoriser dans Atlassian

1. Connectez-vous à votre compte Atlassian (si ce n'est pas déjà fait)
2. Atlassian affiche une demande : « LiKE demande l'accès à votre Confluence »
3. Vérifiez les autorisations — LiKE demande un accès en lecture seule : le contenu des pages et la liste des espaces
4. Cliquez sur « Accept »

#Étape 3 — Vous revenez dans LiKE

Après confirmation, vous êtes automatiquement redirigé vers Intégrations. La carte Confluence affiche :

• Statut : Connecté
• Le nom de votre site Confluence
• Un bouton « Sync »

#Étape 4 — Lancer la synchronisation

1. Cliquez sur « Sync » pour le premier import
2. LiKE charge toutes les pages des espaces Confluence accessibles
3. Les articles apparaissent dans le catalogue de connaissances

#Étape 5 — Configurer l'auto-synchronisation

Ouvrez les paramètres (l'icône d'engrenage sur la carte Confluence) :

Les articles de Confluence sont en lecture seule. Pour modifier, changez l'original dans Confluence, et LiKE se mettra à jour à la prochaine synchronisation.

Lors de la déconnexion de Confluence, vous pouvez conserver une copie des articles dans LiKE (ils deviennent modifiables) ou les supprimer.

#Connecter Notion

#Étape 1 — Créer une intégration dans Notion

1. Ouvrez Notion → cliquez sur votre avatar (coin supérieur gauche) → Settings
2. Dans le menu de gauche, choisissez My connections (ou Integrations)
3. Cliquez sur Develop or manage integrations → New integration
4. Saisissez un nom (par exemple LiKE Import), choisissez un workspace
5. Cliquez sur Submit → copiez l'Internal Integration Secret (commence par ntn_ ; pour les intégrations plus anciennes — par secret_)

#Étape 2 — Donner à l'intégration l'accès aux pages

Par défaut, l'intégration n'a accès à aucune page. Vous devez l'autoriser explicitement :

1. Dans Notion, ouvrez chaque page (ou la page/base de données parente) que vous voulez importer
2. Cliquez sur ⋯ (trois points, coin supérieur droit) → Connect to → choisissez votre intégration LiKE Import
3. Confirmez l'accès

#Étape 3 — Connecter dans LiKE

1. Dans LiKE → Panneau de contrôle → Intégrations → Notion → « Connecter »
2. Collez l'Integration Secret (copié à l'étape 1)
3. Choisissez un espace pour l'import (existant ou créez-en un nouveau)
4. Choisissez un mode :

5. Cliquez sur « Connecter »
6. LiKE charge toutes les pages auxquelles l'intégration a accès

#Étape 4 — Configurer l'auto-synchronisation

Ouvrez les paramètres (l'icône d'engrenage sur la carte Notion) :

Lors de la déconnexion de Notion, vous pouvez conserver une copie des articles dans LiKE (ils deviennent modifiables) ou les supprimer.

#Connecter un site de documentation

Le connecteur récupère les articles d'un site public : il lit son plan (sitemap) et maintient une copie dans LiKE. Utile quand la documentation est déjà publiée — sur votre domaine, dans Docusaurus, GitBook, Docsify et similaires.

#Étape 1 — adresse du site

Intégrations → Site de documentation → Connecter le site. Collez l'adresse : celle de n'importe quelle page suffit, nous prenons le site entier. Le sitemap, nous le cherchons nous-mêmes : d'abord via robots.txt, puis via /sitemap.xml.

#Étape 2 — ce que nous avons trouvé

Cliquez sur Vérifier le site. La vérification n'enregistre rien : elle lit seulement le sitemap et montre combien de pages ont été trouvées et combien seront ajoutées une fois les filtres appliqués. S'il n'y a pas de sitemap, la connexion ne se fait pas et nous le disons franchement, au lieu d'importer zéro page en silence.

#Étape 3 — où le placer

Choisissez l'espace et la collection — la collection peut être créée directement dans l'assistant. Après Connecter, le parcours démarre aussitôt : la progression est visible sur la carte du connecteur (« Parcours du site 22 sur 92 ») et dans l'indicateur des tâches en arrière-plan.

#Ce qui est repris et ce qui ne l'est pas

• on reprend le contenu de la page, sans le menu, l'en-tête ni le pied de page du site ;
• Sections du site limitent le parcours par chemin (/docs/, /guides/) ; laissé vide, nous prenons le site entier ;
• les sections techniques comme la recherche et les tags sont ignorées par défaut ;
• Pages par passage limite un seul passage : protection contre les sites très volumineux ;
• les pages interdites dans robots.txt ne sont pas récupérées ; leur nombre figure dans le bilan du passage.

#Mises à jour suivantes

Avec la synchronisation automatique activée, nous relisons le site selon la planification. Seules les pages modifiées sont réindexées — le bilan le dit ainsi : « ajoutées », « mises à jour », « inchangées ». Les pages inchangées ne consomment pas le quota d'indexation.

Retirer les pages disparues est désactivé par défaut : si une page disparaît du site, l'article reste dans votre base. Activez-le si la copie doit refléter le site strictement.

#Quels sites conviennent et lesquels non

Convient un site public doté d'un sitemap — c'est ainsi que fonctionnent la plupart des générateurs de documentation. Le reste, nous le refusons à l'étape de vérification, et non après la connexion :

Même une fois le site connecté, certaines pages peuvent rester de côté : interdites dans robots.txt, répondant par une erreur, dépassant 10 Mo ou ne renvoyant pas de HTML. Toutes figurent dans le bilan du passage avec le motif — « ignorées » et « interdites par robots.txt ».

Les fichiers (PDF, ZIP, images) ne sont pas récupérés depuis le site. Il existe pour eux une voie distincte : l'import de fichiers, avec son propre traitement.

#Limites

• un site par organisation ;
• le site doit être public : les pages protégées par mot de passe ne sont pas lues ;
• un sitemap est nécessaire : sans lui, la connexion n'aura pas lieu ;
• nous respectons robots.txt, y compris le délai entre requêtes qu'il indique.

Déconnexion. La synchronisation s'arrête ; les articles déjà importés peuvent être supprimés ou conservés comme des articles ordinaires — LiKE le demande au moment de la déconnexion.

#Import de fichiers

#Importer des fichiers

1. Panneau de contrôle → Import
2. Glissez les fichiers ou cliquez sur la zone d'import
3. Formats pris en charge : PDF, DOCX, TXT, MD, RTF, ZIP
4. L'IA génère automatiquement un titre et un slug pour chaque fichier
5. Avant la publication, vous pouvez modifier le titre ou l'ouvrir dans l'éditeur

#Archives ZIP

Importez une archive ZIP contenant de nombreux documents — LiKE décompresse et traite automatiquement chaque fichier. Pratique pour migrer toute une base de connaissances.

Fichiers pris en charge dans un ZIP : PDF, DOCX, TXT, MD, RTF. Les autres fichiers (images, exécutables) sont ignorés.

#Import par lien

Collez un lien vers un document — LiKE le télécharge et l'importe :

1. Panneau de contrôle → Import → la section « Import par lien »
2. Collez une URL → cliquez sur « Ajouter »
3. Vous pouvez ajouter jusqu'à 10 liens à la fois
4. Cliquez sur « Importer »

Sources prises en charge :

• Google Docs — exporté automatiquement en DOCX
• Google Sheets — exporté en CSV
• Dropbox — un lien direct vers un fichier
• Toute URL directe vers un fichier PDF, DOCX, TXT, MD ou RTF

#Visibilité par défaut

Pour chaque source, vous pouvez configurer une visibilité par défaut :

• Brouillon — les articles sont créés masqués
• Équipe — visibles pour les utilisateurs autorisés
• Public — visibles pour tout le monde, y compris les utilisateurs anonymes

Configurée dans Intégrations → carte de la source → Visibilité.

#Canaux d'accès

Les canaux permettent à vos employés de rechercher des informations via des outils familiers.

#Bot Slack

Fonctionnalités :

• /like comment configurer le SSO ? → une réponse IA directement dans Slack
• Mentionner @LiKE dans n'importe quel canal → une réponse dans le fil
• Liens vers les articles sources (cliquables)

#Bot Telegram

Fonctionnalités :

• Messages directs au bot → une réponse IA
• Dans un chat de groupe : /ask question → une réponse
• Prise en charge de 25+ langues

#Widget JS (pour votre site web)

Un bouton de recherche IA flottant à intégrer sur n'importe quel site web. L'intégration la plus populaire — l'utilisateur voit un bouton dans le coin de la page, clique dessus, et un chat avec l'IA et une recherche dans votre base de connaissances s'ouvre.

#Installation simple

#Paramètres de base

#Dual-auth : deux modes d'authentification (ADR 0032)

Dans LiKE, le widget peut fonctionner dans l'un des deux modes — choisi à la création :

Pour plus de détails sur la configuration de chaque mode et l'intégration avec votre backend, voir API et widget.

#Scope : ce que le widget peut trouver

Lors de la création d'un widget, vous définissez un scope — ce qu'il recherche exactement :

Au sein d'un même widget, vous pouvez combiner plusieurs entrées de scope (par exemple, deux collections du même espace).

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

Au sein d'une organisation, vous pouvez créer plusieurs widgets indépendants avec des scopes et des modes différents :

Chacun a sa propre api-key et ses propres analyses d'utilisation, et la clé peut être révoquée indépendamment. La gestion se fait dans Intégrations → Widgets → « + Créer ».

#Gestion des sessions (mode Session JWT)

En mode Session JWT, chaque session utilisateur a un sessionId unique. Un administrateur peut consulter les sessions actives d'un widget spécifique et révoquer de force un token (par exemple, si une compromission est suspectée). La liste se trouve dans Intégrations → Widgets → [widget] → Sessions.

#iframe / Direct Link

Intégrez l'interface de recherche LiKE complète sur n'importe quelle page :

1. Intégrations → iframe → copiez le code
2. Collez <iframe src="..."> dans votre page
3. Ou utilisez le lien direct pour naviguer (une page complète, pas une intégration)

iframe et Direct Link prennent également en charge le dual-auth — choisi à la création.

#REST API

Une API complète pour l'intégration programmatique (par exemple, votre propre UI ou l'intégration avec d'autres systèmes) :

1. Intégrations → API Keys → « Créer une clé »
2. Indiquez un nom (à quoi sert la clé) et un scope (comme pour un widget — public_umbrella / space / collection)
3. Copiez la clé — elle est affichée une seule fois, après réouverture elle sera masquée

Utilisez la clé dans l'en-tête X-API-Key ou comme Bearer token.

Principaux endpoints :

Limites : les rate limits dépendent du plan et sont liées à l'api-key. Les dépasser renvoie HTTP 429 avec un en-tête Retry-After. Les valeurs exactes pour votre plan sont sur la page Plans et dans le panneau d'administration.

Documentation complète de l'API : API et widget.

#Langues

LiKE prend en charge 25+ langues pour la recherche IA et la recherche interlangue (l'interface elle-même est disponible en 11 locales d'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, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

Recherche interlangue : une question dans une langue → une réponse à partir d'articles dans une autre.