Verknüpfungen über die API hinzufügen und verwalten

Du möchtest mit der Notion-API starke Workflows und Integrationen einrichten? In unserem Entwicklungs-Hub findest du die passenden Dokumente, Materialien und Tools für das Integrationsmanagement.

Mitglieder können einem Workspace unter Einstellungen und Mitglieder → Meine Verknüpfungen weitere Verknüpfungen hinzufügen. Workspace-Besitzer/-innen können einem Workspace unter Einstellungen und Mitgliedern → Verknüpfungen weitere Verknüpfungen hinzufügen. Sobald eine Verknüpfung hinzugefügt wurde, kann sie zu weiteren Seiten hinzugefügt werden.

Bei Verknüpfungen, die über die API eingerichtet werden, sind die Freigabeberechtigungen für Notion-Benutzer/-innen ganz ähnlich aufgebaut. Damit du eine Verknüpfung in deinem Workspace nutzen kannst, musst du diese zunächst zu der entsprechenden Seite hinzufügen.

• Rufe die entsprechende Seite auf und klicke dann oben rechts auf •••.

• Im Popup-Fenster klickst du unten auf Verknüpfungen hinzufügen.

• In dem Fenster, das nun angezeigt wird, wählst du die Verknüpfung aus, die du zu dieser Seite hinzufügen möchtest. Es werden nur Verknüpfungen angezeigt, die für den jeweiligen Workspace erstellt wurden.

• Die Verknüpfung wird nun im •••-Menü der jeweiligen Seite angezeigt.

• Wenn eine Verknüpfung von einer Seite entfernt werden soll, bewegst du den Mauszeiger über ihren Namen und klickst dann auf Trennen.

• Gehe in der linken Seitenleiste auf Einstellungen und dann auf Verknüpfungen.

• Hier werden alle für diesen Workspace installierten Verknüpfungen sowie die Workspace-Besitzer/-innen und das Verknüpfungsdatum aufgelistet.

• Klicke neben einer Verknüpfung auf •••, um weitere Optionen einzublenden:

  • Internen API-Token abrufen

  • Website des Entwicklers aufrufen oder dessen Support kontaktieren

  • Benutzer/-innen mit Zugriff auf die Verknüpfung anzeigen

  • Verknüpfung trennen

Wenn du den Enterprise Plan nutzt, haben Workspace-Besitzer/-innen weitere Einstellungsmöglichkeiten zur Verwaltung von Verknüpfungen im Workspace.

• Als Workspace-Besitzer/-in gehst du auf Einstellungen und dann auf Verknüpfungen.

• Ganz oben wird die Option Installation von Verknüpfungen durch Mitglieder einschränken angezeigt. Klicke rechts auf das Dropdown-Menü, um eine von zwei Optionen auszuwählen:

  • Keine Beschränkungen: Alle Workspace-Mitglieder können beliebige Verknüpfungen im Workspace einrichten.

  • Nur von der Genehmigungsliste: Workspace-Mitglieder können nur Verknüpfungen einrichten, die von einem/-r Workspace-Besitzer/-in genehmigt wurden.

• Wenn die Option Von der Genehmigungsliste ausgewählt ist, wird Workspace-Besitzer/-innen eine weitere Option zur automatischen Genehmigung von Verknüpfungen angezeigt, die von Notion stammen. Dazu zählen:

  • GitHub

  • Jira

  • Slack

  • Asana

  • Trello

• Klicke auf + Genehmigte Verknüpfung hinzufügen, um weitere Verknüpfungen für Workspace-Mitglieder zu genehmigen.

• Unter Genehmigte Verknüpfungen wird Workspace-Besitzer/-innen eine Liste aller Verknüpfungen angezeigt, die genehmigt und im Workspace eingerichtet wurden.

• Rechts neben der jeweiligen Verknüpfung stehen die Namen der Benutzer/-innen, die diese im Workspace installiert haben.

• Wenn du auf das •••-Menü klickst, kannst du:

  • nach Benutzer/-in filtern

  • den Zugang einzelner Benutzer/-innen zu einer Verknüpfung zu widerrufen

  • alle Benutzer/-innen abmelden

  • die Verknüpfung von der Genehmigungsliste streichen

Notion arbeitet direkt mit verschiedenen Diensten (wie Zapier und Typeform) zusammen. Öffentliche Partnerverknüpfungen kannst du von deren Seite aus per OAuth direkt in deinen Workspace einfügen.

• Suche im App-Menü der Partnerplattform nach Notion und füge es hinzu.

• Es wird ein Authentifizierungsmenü angezeigt, in dem die Partnerverknüpfung Zugriff auf deinen Workspace anfordert. Hier werden auch die spezifischen Zugangsberechtigungen der Verknüpfung aufgeführt.

• Verknüpfungen beziehen sich immer nur auf einen bestimmten Workspace! Um zu einem anderen Workspace zu wechseln, klicke oben rechts auf den Workspace-Namen. Gehe anschließend auf Seiten auswählen.

• Es wird eine Liste sämtlicher Seiten in dem ausgewählten Workspace angezeigt. Wähle die Seiten aus, auf die die Verknüpfung zugreifen soll, und klicke dann auf Zugriff erlauben.

• Nach der Authentifizierung wird die Verknüpfung in deinem Workspace im Menü Einstellungen unter Verknüpfungen angezeigt.

• Klicke neben dem Namen der Verknüpfung auf das •••-Menü , um die Website des Entwicklers zu besuchen, dessen Support-Team zu kontaktieren oder die Verknüpfung von deinem Workspace zu trennen.

Um eine Verbindung zu deinem Workspace herstellen zu können, benötigen einige Partnerplattformen einen internen Integrationstoken.

• Befolge zunächst die Schritte in der Anleitung, um eine interne Integration für deinen Workspace einzurichten.

• Wenn du die interne Verknüpfung eingerichtet hast, gehe in der Seitenleiste auf Einstellungen und dann auf Verknüpfungen.

• Klicke neben der vorhandenen Verknüpfung, die du mit einer Partnerplattform verbinden möchtest, auf das •••-Symbol und anschließend auf Internen Integrationstoken kopieren.

• Kopiere den internen Integrationstoken in das entsprechende Feld auf der Konfigurationsseite der Partnerplattform.