Confluence

Overzicht

Samenwerkende werkruimte die teams koppelt aan de inhoud die ze nodig hebben. Via de integratie van Langdock kunt u Confluence rechtstreeks vanuit uw gesprekken openen en beheren.

Authenticatie: OAuth Categorie: Productiviteit & Samenwerking Beschikbaarheid: Alle workspace-abonnementen

Beschikbare acties

Zoeken

confluence.search

Zoekt naar pagina's door inhoud en titel te matchen met behulp van tekstquery's. Gebruik dit voor gedeeltelijke titelmatches, zoekwoorden of inhoudszoeken. Vereist bevestiging: Nee

Parameters:

  • query (TEKST, Optioneel): Tekst om naar te zoeken in paginatitels en inhoud. Doorzoekt zowel titels (met wildcardmatching voor gedeeltelijke overeenkomsten) als volledige paginainhoud. Gebruik voor elke gebruikerszoekopdracht, inclusief zoekwoorden, zinnen of gedeeltelijke titels. Laat leeg om recente pagina's te krijgen.

Uitvoer: Geeft een array met zoekresultaten terug met paginainformatie, waaronder:

  • id: Pagina-ID

  • titel: Paginatitel

  • uittreksel: Pagina-uittreksel met markeringen

  • url: Pagina-URL

  • ruimte: Ruimte-informatie

  • versie: Paginaversiedetails

  • laatstGewijzigd: Laatst gewijzigde datum


Zoeken (Native)

confluence.searchNative

Zoekt naar pagina's en inhoud binnen uw Confluence-werkruimte. Vereist bevestiging: Nee

Parameters:

  • query (TEKST, Optioneel): Een querystring om de bestandresultaten te filteren. Als er geen querystring wordt meegegeven, retourneert het de meest recente pagina's. Dit zoekt door de volledige tekst en de titels van de pagina's

Uitvoer: Geeft zoekresultaten terug die geoptimaliseerd zijn voor bestandszoekfunctionaliteit


Bestand downloaden

confluence.downloadFile

Downloadt een specifiek bestand uit uw Confluence-werkruimte. Vereist bevestiging: Nee

Parameters:

  • itemId (TEKST, Vereist): De unieke identifier van het bestand dat u vanuit Confluence wilt downloaden

Uitvoer: Geeft de bestandsinhoud terug als binaire gegevens


Pagina's ophalen

confluence.getPages

Haalt pagina's op met behulp van gestructureerde filters zoals space, status of sortering. Gebruik dit wanneer gebruikers pagina's uit specifieke ruimtes willen opsommen/bladeren, recente pagina's willen ophalen of willen filteren op criteria (bijv. 'haal alle pagina's van de Marketing-ruimte op', 'toon recente pagina's', 'lijst conceptpagina's'). Vereist bevestiging: Nee

Parameters:

  • spaceId (TEKST, Optioneel): Filter pagina's op specifieke space-ID. Als de gebruiker pagina's uit een space vraagt en alleen de naam van de space opgeeft, roep dan eerst de actie get_spaces aan om de space op te zoeken en de ID op naam of key te achterhalen, en gebruik die ID hier.

  • status (TEKST, Optioneel): Filter op paginastatus. Gebruik 'current' voor gepubliceerde pagina's, 'draft' voor conceptpagina's. Standaard is 'current' als niet gespecificeerd.

  • sorteren (TEKST, Optioneel): Sorteervolgorde voor resultaten. Gebruik 'created-date' voor nieuwste eerst, 'modified-date' voor recent bijgewerkt, 'title' voor alfabetisch.

  • limit (NUMMER, Optioneel): Aantal resultaten om terug te geven (1-250). Standaard is 25.

  • cursor (TEKST, Optioneel): Paginatie-cursor om de volgende set resultaten op te halen.

  • titel (TEKST, Optioneel): Filter op exacte paginatitel alleen (geen gedeeltelijke matching).

  • paginaIds (TEKST, Optioneel): Haal specifieke pagina's op via hun ID's.

Uitvoer: Geeft een array met pagina's terug met hun details, waaronder titel, inhoud, space en metadata


Map ophalen

confluence.getFolder

Haalt een specifieke Confluence-map op via zijn ID. Gebruik deze actie wanneer gebruikers om pagina's van een map vragen. Vereist bevestiging: Nee

Parameters:

  • folderId (TEKST, Vereist): De unieke id van de map waarvan u de inhoud wilt ophalen, te vinden door de confluence-zoekactie te gebruiken

Uitvoer: Geeft mapinhoud en metadata terug


Ruimtes ophalen

confluence.getSpaces

Lijst alle spaces in de Confluence-werkruimte. Gebruik deze actie wanneer de gebruiker vraagt naar beschikbare spaces, of wanneer u een space-ID op naam of key moet opzoeken voordat u andere acties aanroept. Vereist bevestiging: Nee

Parameters:

  • ids (TEKST, Optioneel): Filter resultaten tot spaces met deze ID's.

  • sleutels (TEKST, Optioneel): Filter resultaten tot spaces met deze keys.

  • type (TEKST, Optioneel): Filter op space-type (global, collaboration, knowledge_base, personal).

  • status (TEKST, Optioneel): Filter op space-status (current, archived).

  • labels (TEKST, Optioneel): Filter op space-labels.

  • favorietDoor (TEKST, Optioneel): Filter tot spaces die door een specifieke gebruiker zijn gemarkeerd als favoriet (op account-ID).

  • nietGefavorietDoor (TEKST, Optioneel): Filter tot spaces DIE NIET door een specifieke gebruiker als favoriet zijn gemarkeerd (op account-ID).

  • sorteren (TEKST, Optioneel): Sorteer het resultaat op een specifiek veld (id, key, name, enz.).

  • beschrijvingFormaat (TEKST, Optioneel): Formaat voor het beschrijvingsveld van de space (plain, view).

  • inclusiefIcoon (BOOLEAN, Optioneel): Stel in op true om het space-pictogram in de respons op te nemen.

  • cursor (TEKST, Optioneel): Paginatie-cursor om de volgende set resultaten op te halen.

  • limit (NUMMER, Optioneel): Maximum aantal spaces om terug te geven (1-250).

Uitvoer: Geeft een array met spaces terug met hun details, waaronder naam, key, beschrijving en metadata


Pagina aanmaken

confluence.createPage

Maakt een nieuwe pagina in een Confluence-space. Gebruik dit wanneer gebruikers nieuwe inhoud willen maken, een pagina willen toevoegen of informatie naar Confluence willen publiceren. Vereist bevestiging: Ja

Parameters:

  • spaceId (TEKST, Vereist): ID van de space waar de pagina wordt gemaakt. Vereist. Gebruik de actie get_spaces om de space-ID te vinden als slechts de naam van de space is opgegeven.

  • titel (TEKST, Optioneel): Titel van de pagina. Vereist voor gepubliceerde pagina's, optioneel voor concepten.

  • inhoudBody (MEERREGELIGE_TEKST, Optioneel): Inhoud van de pagina in Confluence-opslagformaat of HTML.

  • status (TEKST, Optioneel): Paginastatus: 'current' voor gepubliceerde pagina's, 'draft' voor conceptpagina's. Standaard is 'current'.

  • ouderId (TEKST, Optioneel): ID van de bovenliggende pagina waaronder deze pagina wordt gemaakt.

  • subtype (TEKST, Optioneel): Paginasubtype. Gebruik 'live' om een live document te maken dat realtime samenwerking ondersteunt.

  • privé (BOOLEAN, Optioneel): Stel in op true om een privépagina te maken die alleen de maker kan bekijken en bewerken.

  • rootNiveau (BOOLEAN, Optioneel): Stel in op true om de pagina op rootniveau van de space te maken.

  • ingesloten (BOOLEAN, Optioneel): Stel in op true om ingesloten inhoud te maken.

Uitvoer: Geeft de aangemaakte pagina terug met zijn ID en metadata


Pagina bijwerken

confluence.updatePage

Werk een bestaande Confluence-pagina bij via ID. Kan alleen de titel bijwerken (efficiënt) of volledige inhoud. Gebruik titleChangeOnly=true wanneer alleen de paginatitel/kop wordt gewijzigd voor token-efficiëntie. Gebruik titleChangeOnly=false voor inhoudswijzigingen. Vereist bevestiging: Ja

Parameters:

  • paginaId (TEKST, Vereist): ID van de pagina die moet worden bijgewerkt.

  • titel (TEKST, Vereist): Nieuwe titel voor de pagina.

  • alleenTitelWijziging (BOOLEAN, Optioneel): Stel in op true wanneer alleen de paginatitel wordt gewijzigd (efficiënt). Stel in op false bij het bijwerken van inhoud.

  • inhoudBody (MEERREGELIGE_TEKST, Optioneel): Nieuwe inhoud voor de pagina in Confluence-opslagformaat of HTML. Vereist wanneer titleChangeOnly=false.

  • versieNummer (NUMMER, Vereist): Huidig versienummer van de pagina. VEREIST door de Confluence-API wanneer titleChangeOnly=false.

  • status (TEKST, Optioneel): Paginastatus: 'current' voor gepubliceerd, 'draft' voor concept.

  • versieBericht (TEKST, Optioneel): Optioneel bericht waarin de aangebrachte wijzigingen bij deze update worden beschreven.

  • ouderId (TEKST, Optioneel): ID van de nieuwe bovenliggende pagina om deze pagina onder te verplaatsen binnen dezelfde space.

  • eigenaarId (TEKST, Optioneel): Account-ID van de nieuwe paginawaarnemer om eigendom over te dragen.

  • spaceId (TEKST, Optioneel): ID van de beherende space. Opmerking: Het verplaatsen van pagina's naar andere spaces wordt momenteel niet ondersteund door de API.

Uitvoer: Geeft de bijgewerkte pagina terug met zijn ID en metadata


Pagina ophalen

confluence.getPage

Haalt een specifieke Confluence-pagina op via diens ID, inclusief de inhoud en metadata. Vereist bevestiging: Nee

Parameters:

  • paginaId (TEKST, Vereist): De unieke id van de pagina waarvan u de inhoud wilt ophalen, te vinden door de confluence-zoekactie te gebruiken

Uitvoer: Geeft de paginainhoud en metadata terug

Triggers

Nieuwe pagina

confluence.newPage Wordt geactiveerd wanneer nieuwe pagina's in Confluence worden gepubliceerd. Vereist bevestiging: Nee Parameters: Geen Uitvoer: Geeft informatie over nieuw gepubliceerde pagina's


Bijgewerkte pagina

confluence.updatedPage Wordt geactiveerd wanneer een gepubliceerde Confluence-pagina wordt bijgewerkt. Vereist bevestiging: Nee

Parameters:

  • paginaId (TEKST, Vereist): De id van de pagina die op updates moet worden gecontroleerd

Uitvoer: Geeft informatie over bijgewerkte pagina's

Veelvoorkomende gebruikssituaties

  • Gegevensbeheer — Beheer en organiseer uw Confluence-gegevens

  • Automatisering — Automatiseer workflows met Confluence

  • Rapportage — Genereer inzichten en rapporten

  • Integratie — Verbind Confluence met andere tools

Beste praktijken

1

Aan de slag

Schakel de Confluence-integratie in uw werkruimte-instellingen in

2

Authenticeer met OAuth

3

Test de verbinding met een eenvoudige leesbewerking

4

Verken beschikbare acties voor uw gebruikssituatie

Belangrijke overwegingen:

  • Zorg voor de juiste authenticatiegegevens

  • Respecteer rate limits en API-quotums

  • Controleer instellingen voor gegevensprivacy

  • Test bewerkingen eerst in een veilige omgeving

Probleemoplossing

Probleem
Oplossing

Authenticatie mislukt

Controleer uw OAuth-gegevens

Rate limit overschreden

Verminder de frequentie van verzoeken

Gegevens niet gevonden

Controleer machtigingen en beschikbaarheid van gegevens

Verbindingstime-out

Controleer netwerkconnectiviteit

Ondersteuning

Voor extra hulp met de Confluence-integratie, neem contact op met [email protected]