Verbind je Outline-wiki (self-hosted of getoutline.com cloud) met ReplyRabbit zodat AI-concepten kunnen putten uit de knowledgebase van je team. Outline-pagina's blijven standaard intern: gebruikt om te helpen bij het schrijven van antwoorden maar nooit getoond of gelinkt aan klanten, tenzij je pagina's expliciet markeert als zichtbaar voor klanten.
Gebruik dit wanneer je team kennis in Outline bewaart in plaats van in de FreeScout Knowledge Base-module. Als je de FreeScout-module gebruikt, zie Hoe je je FreeScout Knowledge Base verbindt. Outline werkt goed samen met ReplyRabbit omdat:
Je beheert paginatoegang via Outline-machtigingen en ReplyRabbit leest alleen wat je servicegebruiker kan openen.
Pagina's blijven standaard buiten klantantwoorden, zodat je interne runbooks en leveranciersinformatie nooit in concepten lekken.
Eén synchronisatie per dag plus handmatig "Nu synchroniseren" houdt ReplyRabbit actueel zonder realtime webhooks.
Als je Outline achter een SSO-proxy staat (Cloudflare Access, Authentik, oauth2-proxy), moet je mogelijk je proxyinstellingen aanpassen of het interne adres van Outline gebruiken.
Installatiepad
Een servicegebruiker aanmaken
Maak in je identiteitsprovider (je SSO-systeem) een speciaal gebruikersaccount aan zoals replyrabbit@yourcompany.com. Dit account wordt de "ogen" van ReplyRabbit binnen Outline.
Meld je eenmalig aan bij Outline
Laat die servicegebruiker inloggen bij Outline via je normale SSO-flow. Het account moet in Outline bestaan voordat het een API-sleutel kan aanmaken.
Toegang verlenen in Outline
Deel alleen de Outline-collecties of pagina's die je wilt dat ReplyRabbit met die servicegebruiker gebruikt. Deel ze op dezelfde manier waarop je toegang verleent aan elk hulpmiddel zoals Onyx of interne wiki's. Maak de gebruiker geen beheerder; een gewoon lid met toegang tot specifieke collecties is voldoende.
Een API-sleutel aanmaken
Meld je aan bij Outline als die servicegebruiker. Open Instellingen en vervolgens API en toegang onder Account en klik Nieuwe API-sleutel. Older self-hosted versions call this page "API" or "API and Apps".The screenshots below show Outline's English interface; labels may be translated in your Outline workspace.Persoonlijke API-sleutels staan onder je eigen accountinstellingen, niet onder die van de werkruimte.Geef de sleutel een naam ReplyRabbit, typ read in Bereiken, en stel Vervaldatum naar "No expiration". De standaard van Outline is 30 dagen en synchronisatie stopt wanneer de sleutel verloopt. Klik Aanmaken en kopieer de sleutel.Het leesbereik dekt alles wat ReplyRabbit nodig heeft en blokkeert alle schrijfacties.
ReplyRabbit-instellingen openen
Ga in FreeScout naar de mailboxinstellingen en zoek "Documentatiebronnen" onder ReplyRabbit.
Outline-bron toevoegen
Klik op "Add Outline source". Plak je Outline-URL (bijvoorbeeld, https://wiki.company.com of je getoutline.com werkruimte-URL) en de API-sleutel die je zojuist hebt gekopieerd.
Kies wat te synchroniseren
Klik na het plakken van de URL en sleutel op "Test connection". Het toont bij welke Outline-gebruiker de sleutel hoort, zodat je kunt controleren of het de servicegebruiker is en niet de sleutel van een persoon. Kies daarna ofwel "Everything this key can read" (aanbevolen, komt overeen met de eigen rechten van Outline) of "Only specific collections or pages", en vink ze aan in de boom of plak een collectie- of paginalink.
Synchroniseren en testen
Sla je instellingen op. Bij het opslaan van een nieuwe bron, of het wijzigen van het adres, de sleutel of het bereik, start direct een synchronisatie. Daarna synchroniseert het dagelijks, en "Nu synchroniseren" op de bron start er een wanneer je maar wilt. Test daarna een concept om te bevestigen dat ReplyRabbit de inhoud kan gebruiken.
Privacy en beveiliging
Outline-pagina's zijn standaard intern. Paginatekst wordt opgeslagen in FreeScout en verzonden naar je AI-provider en embedding-provider (meestal dezelfde provider die je voor concepten gebruikt). Pagina's worden nooit woord voor woord geciteerd of gelinkt in klantantwoorden, tenzij je "Klanten kunnen deze pagina's zien" inschakelt voor bronnen waarvan elke geselecteerde pagina veilig te delen is.
Schakel "Klanten kunnen deze pagina's zien" alleen in als:
Elke geselecteerde pagina opent en wordt correct weergegeven zonder dat een login nodig is.
De inhoud is geschikt voor klanten (geen interne operationele details, leveranciersinformatie of instructies voor medewerkers).
Deel alleen wat nodig is. Als je de hele Outline-werkruimte met ReplyRabbit deelt, wordt alles wat de servicegebruiker kan lezen beschikbaar voor de AI en opgeslagen in FreeScout. Deel in plaats daarvan specifieke collecties of pagina's, op dezelfde manier waarop je toegang voor elk ander hulpmiddel zou beperken.
Omgaan met interne netwerkadressen
Als je Outline draait op een privé-IP-adres of interne hostnaam (zoals outline.internal.company.com), zet dan "Outline staat op ons interne netwerk" aan wanneer je de bron toevoegt. Hierdoor kan ReplyRabbit:
Bereik privé-IP-adressen (10.x.x.x, 192.168.x.x, 172.16.x.x tot 172.31.x.x)
Interne hostnames omzetten via de DNS van je netwerk
Gebruik HTTP (onversleuteld) alleen op privéadressen
Openbare adressen vereisen nog steeds HTTPS, zelfs met deze optie aan. Als je Outline HTTPS gebruikt met een certificaat van je eigen interne CA, moet de truststore van je FreeScout-server dat CA-certificaat bevatten.
Omgaan met SSO-proxy's
Outlines eigen aanmelding: Als je team bij Outline inlogt via Google, Microsoft, Slack, OIDC of e-maillinks die door Outline zelf worden beheerd, is er geen extra instelling nodig. De API-sleutel omzeilt de aanmeldingsflow.
SSO-proxy voor Outline: Als iets zoals Cloudflare Access, Authentik of oauth2-proxy voor Outline staat en verzoeken onderschept, kan ReplyRabbit de API niet bereiken. Je ziet dan een foutmelding: "Iets voor Outline vraagt om een aanmelding."
Los dit op door een van deze benaderingen te kiezen:
Proxy omzeilen voor /api/ alleen. Configureer je proxy zodat de FreeScout-server kan bereiken /api/* direct zonder de aanmeldingscontrole. De meeste proxies ondersteunen bypass-regels op basis van pad of IP. Raadpleeg de documentatie van je proxy voor de instelling.
Gebruik het interne adres van Outline. Als je Outline een privé-IP of interne hostnaam heeft die de proxy omzeilt, gebruik die dan in ReplyRabbit. Je moet "Outline staat op ons interne netwerk" inschakelen voor privéadressen.
Als je de proxy niet kunt omzeilen, neem dan contact op met je beheerder om een van deze opties voor de ReplyRabbit-server in te schakelen.
Probleemoplossing
"Outline beperkt het aantal verzoeken. Het wordt opnieuw geprobeerd bij de volgende geplande run." Outline vroeg ReplyRabbit om te vertragen. De synchronisatie heeft al zo lang gewacht als Outline vroeg en het opnieuw geprobeerd, en Outline was nog steeds bezet, dus het probeert het opnieuw bij de volgende dagelijkse synchronisatie. Pagina's die al geïndexeerd waren, blijven ondertussen beschikbaar. Om eerder opnieuw te proberen, klik je over een paar minuten opnieuw op "Nu synchroniseren".
"Deze Outline-versie is te oud. Werk Outline bij naar 0.87 of later en test de verbinding daarna opnieuw." Je zelfgehoste Outline mist een API-methode die ReplyRabbit nodig heeft. Upgrade het naar versie 0.87 of later en klik vervolgens opnieuw op "Test connection".
"Deze bron staat uit. Zet "Gebruik deze bron" aan, sla op en synchroniseer." De Outline-bron is uitgeschakeld. Vink "Deze bron gebruiken" aan, sla de instellingen op en klik dan op "Nu synchroniseren".
"Outline heeft die API-sleutel geweigerd." De API-sleutel is ongeldig of is ingetrokken. Genereer een nieuwe sleutel in Outline Settings > API met de read scope.
"Kon Outline niet bereiken. Controleer de URL en probeer het opnieuw." De URL is onjuist, of ReplyRabbit kan de server niet bereiken. Controleer:
De URL is correct (bijvoorbeeld, https://wiki.company.com, niet de startpagina of een specifieke pagina).
Als Outline op een privé-IP of interne hostnaam draait, schakel dan "Outline staat op ons interne netwerk" in.
Als Outline achter een SSO-proxy staat, raadpleeg dan het gedeelte "Omgaan met SSO-proxies" hierboven.
"Voer eerst de Outline API-sleutel in." Plak de API-sleutel in het veld voordat je test of synchroniseert.
"De Outline-kennisbron is een Team-functie." Je huidige plan bevat geen Outline-integratie. Upgrade naar het Team-plan om deze functie te gebruiken.
Minimale Outline-versie
Zelfgehoste Outline vereist versie 0.87 of later (getest op 1.0 tot 1.10). Oudere versies missen een deel van de API die ReplyRabbit gebruikt om paginabomen te lezen. Verbinding testen controleert op de ontbrekende paginaboom-API. Als er een oude versie wordt gemeld, werk Outline dan eerst bij.
De cloudversie op getoutline.com is altijd up-to-date en wordt ondersteund.
Later van bron wisselen
Overstappen naar een openbare documentatiesite: Als je later wilt overstappen naar een openbare website (in plaats van Outline intern te houden), voeg dan een documentatiebron van het type Website toe en schakel de Outline-bron uit of verwijder deze wanneer je klaar bent. Beide kunnen tijdens de overstap naast elkaar draaien. Het verwijderen van een Outline-bron verbergt de pagina's voor concepten en verwijdert ze uit de opslag van ReplyRabbit.
Downgraden van Team: Als je downgradet van het Team-plan, blijven je Outline-bronnen en API-instellingen in de database staan, maar de gesynchroniseerde pagina's worden verwijderd en zijn niet meer beschikbaar voor het ophalen van concepten. Je bronconfiguratie blijft behouden, dus wanneer je weer upgradet naar Team, kun je ze opnieuw synchroniseren zonder de URL en API-sleutel opnieuw in te voeren.