Notion

  Mit der Notion für Botpress Studio können Sie folgende Dinge tun:

## Migrieren von Version `0.x` oder `1.x` auf `2.x`

Die Version `2.0` der Notion unterstützt nun auch OAuth, was nun die Standardkonfigurationsoption ist.

Wenn Sie zuvor eine Notion im Notion erstellt haben und diese Integration weiterhin verwenden möchten, wählen Sie bitte die manuelle Konfigurationsoption und folgen Sie den nachstehenden Anweisungen.

Andernfalls wählen Sie die automatische Konfigurationsoption und klicken Sie auf die Schaltfläche Autorisierung. Folgen Sie dann den Anweisungen auf dem Bildschirm, um Ihren Botpress mit Notion zu verbinden.

## Konfiguration

### Automatische Konfiguration mit OAuth (empfohlen)

Dies ist die einfachste Art, die Integration einzurichten. Um die Notion mit OAuth einzurichten, klicken Sie auf die Schaltfläche Autorisierung und folgen Sie den Anweisungen auf dem Bildschirm, um Ihren Botpress mit Notion zu verbinden. Diese Methode wird empfohlen, da sie den Konfigurationsprozess vereinfacht und eine sichere Kommunikation zwischen Ihrem Chatbot und Notion gewährleistet.

Wenn Sie diesen Konfigurationsmodus verwenden, wird eine Botpress Notion verwendet, um eine Verbindung zu Ihrem Notion herzustellen. Aktionen, die der Bot ausführt, werden dieser Anwendung und nicht Ihrem persönlichen Notion zugeschrieben.

### Manuelle Konfiguration mit einer benutzerdefinierten Notion 

#### Schritt 1 - Integration erstellen

Erstellen Sie eine Notion [Eine Integration erstellen - Notion ]notion

#### Schritt 2 - Zugriff auf Notion ermöglichen

Geben Sie Ihrer Integration Zugriff auf alle Seiten und Datenbanken, die Sie mit Botpress
verwenden möchten Botpress

#### Schritt 3 - Konfigurieren Sie Ihren Bot

Geben Sie Ihrer Integration Zugriff auf alle Seiten und Datenbanken, die Sie mit Botpress verwenden möchten. [Geben Sie eine Datenbank für Ihre Integration frei - Notion Developers]notion

Sie benötigen ein Token, um Ihre neu erstellte Notion _(nicht dasselbe wie die Notion von Botpress Studio)_ mit Botpress Studio zu verbinden:

- `Auth Token` - Diesen finden Sie, wenn Sie unter notion zu Ihrer Integration gehen. Sobald Sie auf Ihre Integration klicken, gehen Sie zum Abschnitt "Secrets" und suchen Sie das Feld "Internal Integration Secret". Klicken Sie auf "Anzeigen" und dann auf "Kopieren". Fügen Sie das kopierte Token in das Feld "Authentifizierungs-Token" für die Notion auf der Registerkarte "Integrationen" für Ihren Bot ein.

Nun müssen Sie nur noch Ihre Integration aktivieren und schon können Sie die Möglichkeiten Ihres Bots mit Notion erweitern.

## Verwendung

Für die folgenden Aktionen müssen Sie die Ids der Notion kennen, mit denen Ihr Bot arbeiten soll. Alle notion (Seiten, Datenbanken usw.) haben eine Id, die in der URL zu finden ist, wenn Sie diese in Ihrem Notion in einem Browser besuchen, oder indem Sie den Link durch Klicken auf den Punkt "Link kopieren" im Menü (...) erhalten. Weitere Informationen finden Sie unter [Datenbank-ID abrufen - Notion ]notion

### Kommentar zu einer Diskussion hinzufügen

Diese Aktion ermöglicht es Ihnen, einen Kommentar zu einer bestehenden Diskussion hinzuzufügen. Verwenden Sie dies, um auf einen Kommentar zu antworten.

### Kommentar zu einer Seite hinzufügen

Mit dieser Aktion können Sie Kommentare auf Seitenebene hinzufügen.

### Eine Datenbank abrufen

Hiermit können Sie die Details einer Datenbank abrufen. Dies wird idealerweise mit der Aktion "Seite zu einer Datenbank hinzufügen" verwendet. Zusätzlich zur Antwort der Notion ([Retreive a Database - Notion Developers]notion) gibt diese Aktion auch eine optimierte "Structure"-Eigenschaft (technisch gesehen eine Typendeklaration) zurück, die als Eingabe für eine KI-Aufgabe verwendet werden kann, um sie anzuweisen, eine Nutzlast zum Hinzufügen oder Aktualisieren einer Seite in einer Notion auf der Grundlage einer Benutzereingabe zu generieren.

### Seite zu einer Datenbank hinzufügen

Diese Aktion sollte idealerweise in Verbindung mit `Get a Database` verwendet werden, die die Struktur der Datenbank zurückgibt, die Sie verwenden können, um eine [KI-Aufgabe]botpress anzuweisen, eine Nutzlast zu erzeugen. Siehe [Arbeiten mit Datenbanken - Notion ]notion für weitere Informationen.

### Einen Block löschen

Sie können die folgenden Entitäten löschen:

- eine Seite in einer Datenbank
- eine Seite
- einen Block