Integrationen

Steuerungspanel → Integrationen — verbinden Sie Inhaltsquellen und Kanäle für den Zugriff auf Wissen.

#Inhaltsquellen

#Verbunden (immer aktiv)

#Verfügbare Konnektoren

#GitHub verbinden

#Schritt 1 — Autorisierung

1. Gehen Sie in LiKE zu Integrationen → GitHub → „Verbinden"
2. Wählen Sie eine Autorisierungsmethode:

#Schritt 2 — Inhalte auswählen

1. Nach dem Verbinden wird ein Repository-Baum mit Ordnern und Dateien angezeigt
2. Markieren Sie die konkreten Dateien oder Ordner, die importiert werden sollen (Selective Sync)
3. Unterstützte Formate: .md, .mdx, Wiki-Seiten

#Schritt 3 — Synchronisierung starten

1. Klicken Sie auf „Sync"
2. Der Fortschritt wird in Echtzeit angezeigt
3. Nach Abschluss erscheinen die Artikel in der Liste mit einem GitHub-Label

#GitLab verbinden

#Schritt 1 — Autorisierung

1. Gehen Sie in LiKE zu Integrationen → GitLab → „Verbinden"
2. Wählen Sie eine Autorisierungsmethode:

#Schritt 2 — Inhalte auswählen

1. Es wird ein Projekt-Baum mit Wiki-Seiten und Markdown-Dateien angezeigt
2. Markieren Sie die konkreten Seiten, die importiert werden sollen (Selective Sync)

#Schritt 3 — Synchronisierung starten

Wie bei GitHub — klicken Sie auf „Sync" und warten Sie den Abschluss ab.

#Gitea verbinden

Gitea ist eine selbst gehostete Git-Plattform. Sie wird über einen Personal Access Token und eine obligatorische URL Ihrer Instanz verbunden (es gibt standardmäßig kein Cloud-Gitea).

#Schritt 1 — Token in Gitea erstellen

1. Öffnen Sie in Gitea Settings → Applications → Generate New Token
2. Vergeben Sie die Scopes read:repository und read:user
3. Kopieren Sie den Token

#Schritt 2 — In LiKE verbinden

1. Gehen Sie in LiKE zu Integrationen → Gitea → „Verbinden"
2. Geben Sie die Base URL Ihrer Instanz an (zum Beispiel https://gitea.company.com) — dieses Feld ist obligatorisch, ohne es kommt die Verbindung nicht zustande
3. Fügen Sie den Token ein
4. Wählen Sie einen Space/eine Collection und einen Modus (Sync — ein fortlaufender Spiegel / Import — eine einmalige Kopie)

OAuth 2.0 wird ebenfalls unterstützt, sofern der Gitea-Administrator im Voraus eine OAuth-Anwendung eingerichtet hat. Der primäre Weg ist der Token.

#Schritt 3 — Inhalte auswählen und synchronisieren

1. Es wird ein Repository-Baum mit Wiki-Seiten und Markdown-Dateien (.md, .mdx) angezeigt
2. Markieren Sie die benötigten Knoten (Selective Sync) und klicken Sie auf „Sync"
3. Für automatische Aktualisierungen bei Push richten Sie einen Webhook ein — das Secret wird in der Konnektor-Karte generiert. Artikel aus Gitea sind schreibgeschützt (wie bei GitHub/GitLab)

#Dateiauswahl und Sync-Filter (GitHub, GitLab, Gitea)

Für Git-Quellen (GitHub, GitLab und Gitea) ist die Logik der Auswahl, was synchronisiert wird, differenzierter als ein einfaches „Repository ein/aus":

#Was synchronisiert wird

#Pfadfilter (Selective Sync)

Sie können genau eingrenzen, was aus dem Repository übernommen wird:

#Änderungserkennung (letzte Änderungen)

LiKE „lädt nicht alles" bei jedem Durchlauf herunter. Es wird eine Änderungserkennung verwendet:

• GitHub — über Webhook (empfohlen) oder Polling mithilfe von If-Modified-Since-Headern. Der Webhook reagiert sofort auf einen Push, Polling — alle 6/12/24/48 Stunden (abhängig von der Auto-Sync).
• GitLab — ebenso: Webhook oder Polling nach last_activity_at über die Projects API.
• Gitea — Webhook (Signatur X-Gitea-Signature) oder Polling. Der Push-Trigger löst nur aus, wenn sich *.md/*.mdx ändert.

Sobald eine Änderung erkannt wird, werden nur die betroffenen Dateien synchronisiert; der übrige Korpus wird nicht neu berechnet. Das spart erheblich GitHub/GitLab-API-Kontingent und Ausführungszeit.

#Branch und Tags

#Historie und Konflikte

• Sync-Historie — der Tab „Historie" in der Konnektor-Karte: Datum, Status (✅ ok / ⚠ Warnungen / ❌ Fehler), die Anzahl hinzugefügter / aktualisierter / gelöschter Artikel, Laufdauer. Nützlich zur Fehlersuche „warum ein Artikel aus dem Repository nicht erschienen ist".
• Bearbeitungskonflikte — wenn ein Artikel aus der Quelle in LiKE bearbeitet wurde (für GitHub/GitLab ist dies standardmäßig nicht erlaubt — Artikel sind schreibgeschützt). Ist der Modus Import (eine einmalige Kopie), werden die Artikel bearbeitbar und die Verbindung zur Quelle wird getrennt.

#Selective Sync für andere Konnektoren

Notion, Confluence, Wiki.js — sie haben ihre eigene Auswahllogik (einen Seitenbaum), aber das Prinzip ist dasselbe:

1. Beim Verbinden wird der Inhaltsbaum der Quelle angezeigt
2. Kontrollkästchen — markieren Sie die benötigten Knoten
3. Der Rest wird nicht importiert
4. Bei einer erneuten Synchronisierung werden nur die ausgewählten Elemente aktualisiert

#Wiki.js verbinden

#Schritt 1 — Einen Wiki.js-API-Token erhalten

1. Öffnen Sie Ihr Wiki.js → Administration → API Access
2. Aktivieren Sie die API (falls sie deaktiviert ist)
3. Klicken Sie auf New API Key
4. Benennen Sie den Schlüssel (zum Beispiel LiKE Integration)
5. Gruppe: Administrators (Zugriff auf alle Seiten ist erforderlich)
6. Ablauf: kein Ablauf oder 1 Jahr
7. Kopieren Sie den generierten Token

#Schritt 2 — In LiKE verbinden

1. Gehen Sie in LiKE zu Integrationen → Wiki.js → „Verbinden"
2. Geben Sie die URL Ihres Wiki.js ein (zum Beispiel https://wiki.company.com)
3. Fügen Sie den API-Token ein
4. Wählen Sie einen Modus:

5. Klicken Sie auf Speichern

#Schritt 3 — Die Synchronisierung konfigurieren

#Confluence verbinden

Confluence wird über OAuth 2.0 verbunden — sichere Autorisierung ohne Eingabe von Passwörtern.

#Schritt 1 — Auf „Confluence verbinden" klicken

1. Gehen Sie in LiKE zu Steuerungspanel → Integrationen
2. Suchen Sie die Confluence-Karte → klicken Sie auf „Verbinden"
3. Das Atlassian-Autorisierungsfenster öffnet sich

#Schritt 2 — In Atlassian autorisieren

1. Melden Sie sich bei Ihrem Atlassian-Konto an (falls noch nicht geschehen)
2. Atlassian zeigt eine Anfrage: „LiKE fordert Zugriff auf Ihr Confluence an"
3. Prüfen Sie die Berechtigungen — LiKE fordert schreibgeschützten Zugriff an: Seiteninhalte und die Liste der Spaces
4. Klicken Sie auf „Accept"

#Schritt 3 — Sie kehren zu LiKE zurück

Nach der Bestätigung werden Sie automatisch zurück zu Integrationen geleitet. Die Confluence-Karte zeigt:

• Status: Verbunden
• Den Namen Ihrer Confluence-Site
• Eine Schaltfläche „Sync"

#Schritt 4 — Die Synchronisierung starten

1. Klicken Sie auf „Sync" für den ersten Import
2. LiKE lädt alle Seiten aus den zugänglichen Confluence-Spaces
3. Die Artikel erscheinen im Wissenskatalog

#Schritt 5 — Auto-Sync konfigurieren

Öffnen Sie die Einstellungen (das Zahnradsymbol auf der Confluence-Karte):

Artikel aus Confluence sind schreibgeschützt. Um sie zu bearbeiten, ändern Sie das Original in Confluence, und LiKE aktualisiert bei der nächsten Synchronisierung.

Beim Trennen von Confluence können Sie eine Kopie der Artikel in LiKE behalten (sie werden bearbeitbar) oder sie löschen.

#Notion verbinden

#Schritt 1 — Eine Integration in Notion erstellen

1. Öffnen Sie Notion → klicken Sie auf Ihren Avatar (oben links) → Settings
2. Wählen Sie im linken Menü My connections (oder Integrations)
3. Klicken Sie auf Develop or manage integrations → New integration
4. Geben Sie einen Namen ein (zum Beispiel LiKE Import), wählen Sie einen Workspace
5. Klicken Sie auf Submit → kopieren Sie das Internal Integration Secret (beginnt mit ntn_; bei älteren Integrationen — mit secret_)

#Schritt 2 — Der Integration Zugriff auf Seiten geben

Standardmäßig hat die Integration keinen Zugriff auf irgendwelche Seiten. Sie müssen dies ausdrücklich erlauben:

1. Öffnen Sie in Notion jede Seite (oder die übergeordnete Seite/Datenbank), die Sie importieren möchten
2. Klicken Sie auf ⋯ (drei Punkte, oben rechts) → Connect to → wählen Sie Ihre LiKE Import-Integration
3. Bestätigen Sie den Zugriff

#Schritt 3 — In LiKE verbinden

1. In LiKE → Steuerungspanel → Integrationen → Notion → „Verbinden"
2. Fügen Sie das Integration Secret ein (in Schritt 1 kopiert)
3. Wählen Sie einen Space für den Import (vorhandener oder neuen erstellen)
4. Wählen Sie einen Modus:

5. Klicken Sie auf „Verbinden"
6. LiKE lädt alle Seiten, auf die die Integration Zugriff hat

#Schritt 4 — Auto-Sync konfigurieren

Öffnen Sie die Einstellungen (das Zahnradsymbol auf der Notion-Karte):

Beim Trennen von Notion können Sie eine Kopie der Artikel in LiKE behalten (sie werden bearbeitbar) oder sie löschen.

#Dokumentationswebsite anbinden

Der Connector holt Artikel von einer öffentlichen Website: Er liest deren Sitemap und hält in LiKE eine Kopie aktuell. Sinnvoll, wenn Ihre Dokumentation bereits veröffentlicht ist — auf einer eigenen Domain, in Docusaurus, GitBook, Docsify und Ähnlichem.

#Schritt 1 — Adresse der Website

Integrationen → Dokumentationswebsite → Website verbinden. Fügen Sie die Adresse ein — eine beliebige Seite genügt, wir nehmen die gesamte Website. Die Sitemap suchen wir selbst: zuerst über robots.txt, dann über /sitemap.xml.

#Schritt 2 — was gefunden wurde

Klicken Sie auf Website prüfen. Die Prüfung speichert nichts: Sie liest nur die Sitemap und zeigt, wie viele Seiten gefunden wurden und wie viele nach den Filtern übernommen werden. Fehlt die Sitemap, kommt keine Verbindung zustande — und wir sagen das deutlich, statt stillschweigend nichts zu importieren.

#Schritt 3 — wohin damit

Wählen Sie Raum und Sammlung — die Sammlung lässt sich direkt im Assistenten anlegen. Nach Verbinden startet der Durchlauf sofort: Der Fortschritt ist auf der Connector-Karte zu sehen („Website wird durchlaufen: 22 von 92“) sowie in der Anzeige der Hintergrundaufgaben.

#Was übernommen wird und was nicht

• übernommen wird der Seiteninhalt — ohne Menü, Kopf- und Fußbereich der Website;
• Bereiche der Website begrenzen den Durchlauf über Pfade (/docs/, /guides/); leer lassen heißt: die ganze Website;
• Servicebereiche wie Suche und Tags werden standardmäßig übersprungen;
• Seiten pro Durchlauf begrenzt einen einzelnen Lauf — Schutz vor sehr großen Websites;
• in robots.txt gesperrte Seiten werden nicht abgerufen; ihre Zahl steht in der Zusammenfassung des Laufs.

#Wiederholte Aktualisierungen

Bei aktivierter automatischer Synchronisierung lesen wir die Website nach Zeitplan erneut. Neu indexiert werden nur geänderte Seiten — genau so steht es in der Zusammenfassung: „hinzugefügt“, „aktualisiert“, „unverändert“. Unveränderte Seiten verbrauchen kein Indexierungskontingent.

Verschwundene Seiten entfernen ist standardmäßig aus: Ist eine Seite von der Website verschwunden, bleibt der Artikel in Ihrer Basis. Schalten Sie es ein, wenn die Kopie die Website strikt abbilden soll.

#Welche Websites geeignet sind und welche nicht

Geeignet ist eine öffentliche Website mit Sitemap — so arbeiten die meisten Dokumentationsgeneratoren. Alles andere lehnen wir beim Prüfschritt ab, nicht erst nach dem Verbinden:

Auch nach erfolgreicher Verbindung können einzelne Seiten fehlen: in robots.txt gesperrte, solche mit Fehlerantwort, über 10 MB große oder solche, die kein HTML liefern. Sie alle stehen in der Zusammenfassung des Laufs mit Grund — „übersprungen“ und „durch robots.txt gesperrt“.

Dateien (PDF, ZIP, Bilder) werden von der Website nicht übernommen. Dafür gibt es einen eigenen Weg — den Dateiimport mit eigener Verarbeitung.

#Grenzen

• eine Website pro Organisation;
• die Website muss öffentlich sein — Seiten hinter einem Passwort werden nicht gelesen;
• eine Sitemap ist erforderlich: ohne sie kommt keine Verbindung zustande;
• wir beachten robots.txt, einschließlich der dort angegebenen Pause zwischen Anfragen.

Trennen. Die Synchronisierung endet; bereits importierte Artikel können Sie löschen oder als gewöhnliche behalten — LiKE fragt beim Trennen danach.

#Dateiimport

#Dateien hochladen

1. Steuerungspanel → Import
2. Ziehen Sie Dateien hinein oder klicken Sie auf die Upload-Zone
3. Unterstützte Formate: PDF, DOCX, TXT, MD, RTF, ZIP
4. Die KI generiert automatisch einen Titel und einen Slug für jede Datei
5. Vor der Veröffentlichung können Sie den Titel bearbeiten oder ihn im Editor öffnen

#ZIP-Archive

Laden Sie ein ZIP-Archiv mit vielen Dokumenten hoch — LiKE entpackt und verarbeitet automatisch jede Datei. Praktisch für die Migration einer ganzen Wissensdatenbank.

Unterstützte Dateien innerhalb eines ZIP: PDF, DOCX, TXT, MD, RTF. Andere Dateien (Bilder, ausführbare Dateien) werden übersprungen.

#Import per Link

Fügen Sie einen Link zu einem Dokument ein — LiKE lädt es herunter und importiert es:

1. Steuerungspanel → Import → der Bereich „Import per Link"
2. Fügen Sie eine URL ein → klicken Sie auf „Hinzufügen"
3. Sie können bis zu 10 Links gleichzeitig hinzufügen
4. Klicken Sie auf „Import"

Unterstützte Quellen:

• Google Docs — automatisch als DOCX exportiert
• Google Sheets — als CSV exportiert
• Dropbox — ein direkter Dateilink
• Beliebige direkte URL zu einer PDF-, DOCX-, TXT-, MD- oder RTF-Datei

#Standard-Sichtbarkeit

Für jede Quelle können Sie eine Standard-Sichtbarkeit konfigurieren:

• Draft — Artikel werden verborgen erstellt
• Team — sichtbar für autorisierte Nutzer
• Public — sichtbar für alle, einschließlich anonymer Nutzer

Konfiguriert unter Integrationen → Quellen-Karte → Sichtbarkeit.

#Zugriffskanäle

Kanäle ermöglichen es Ihren Mitarbeitern, über vertraute Werkzeuge nach Informationen zu suchen.

#Slack-Bot

Funktionen:

• /like wie richte ich SSO ein? → eine KI-Antwort direkt in Slack
• Erwähnung von @LiKE in einem beliebigen Kanal → eine Antwort im Thread
• Links zu den Quellartikeln (anklickbar)

#Telegram-Bot

Funktionen:

• Direktnachrichten an den Bot → eine KI-Antwort
• In einem Gruppenchat: /ask Frage → eine Antwort
• Unterstützung für 25+ Sprachen

#JS-Widget (für Ihre Website)

Eine schwebende KI-Suchschaltfläche zum Einbetten auf jeder Website. Die beliebteste Integration — ein Nutzer sieht eine Schaltfläche in der Ecke der Seite, klickt darauf, und ein Chat mit der KI und der Suche über Ihre Wissensdatenbank öffnet sich.

#Einfache Installation

#Grundlegende Parameter

#Dual-Auth: zwei Authentifizierungsmodi (ADR 0032)

In LiKE kann das Widget in einem von zwei Modi arbeiten — beim Erstellen ausgewählt:

Für Details zur Konfiguration jedes Modus und zur Integration mit Ihrem Backend siehe API & Widget.

#Scope: was das Widget finden kann

Beim Erstellen eines Widgets legen Sie einen Scope fest — was genau es durchsucht:

Innerhalb eines einzelnen Widgets können Sie mehrere Scope-Einträge kombinieren (zum Beispiel zwei Collections aus demselben Space).

#Multi-Widget pro Tenant (ADR 0029 Stage 4)

Innerhalb einer Organisation können Sie mehrere unabhängige Widgets mit verschiedenen Scopes und Modi erstellen:

Jedes hat seinen eigenen api-key und seine eigene Nutzungsanalyse, und der Schlüssel kann unabhängig widerrufen werden. Die Verwaltung befindet sich unter Integrationen → Widgets → „+ Erstellen".

#Session-Verwaltung (Session-JWT-Modus)

Im Session-JWT-Modus hat jede Nutzersitzung eine eindeutige sessionId. Ein Admin kann die aktiven Sitzungen eines bestimmten Widgets einsehen und einen Token zwangsweise widerrufen (zum Beispiel bei Verdacht auf Kompromittierung). Die Liste befindet sich unter Integrationen → Widgets → [Widget] → Sessions.

#iframe / Direct Link

Betten Sie die vollständige LiKE-Suchoberfläche auf jeder Seite ein:

1. Integrationen → iframe → kopieren Sie den Code
2. Fügen Sie <iframe src="..."> in Ihre Seite ein
3. Oder verwenden Sie den Direktlink zur Navigation (eine vollständige Seite, keine Einbettung)

iframe und Direct Link unterstützen ebenfalls Dual-Auth — beim Erstellen ausgewählt.

#REST API

Eine vollständige API für die programmatische Integration (zum Beispiel Ihre eigene UI oder die Integration mit anderen Systemen):

1. Integrationen → API Keys → „Schlüssel erstellen"
2. Geben Sie einen Namen an (wofür der Schlüssel ist) und einen Scope (wie bei einem Widget — public_umbrella / space / collection)
3. Kopieren Sie den Schlüssel — er wird nur einmal angezeigt, nach dem erneuten Öffnen ist er maskiert

Verwenden Sie den Schlüssel im Header X-API-Key oder als Bearer-Token.

Wichtigste Endpunkte:

Limits: Rate Limits hängen vom Plan ab und sind an den api-key gebunden. Ein Überschreiten gibt HTTP 429 mit einem Retry-After-Header zurück. Die genauen Werte für Ihren Plan finden Sie auf der Pläne-Seite und im Admin-Panel.

Vollständige API-Dokumentation: API & Widget.

#Sprachen

LiKE unterstützt 25+ Sprachen für die KI-Suche und sprachübergreifende Suche (die Oberfläche selbst ist in 11 UI-Locales verfügbar):

Русский, 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, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

Sprachübergreifende Suche: eine Frage in einer Sprache → eine Antwort aus Artikeln in einer anderen.