Notion

  L'intégration de Notion pour Botpress Studio vous permet de faire les choses suivantes :

## Migrer de la version `0.x` ou `1.x` vers `2.x`

La version `2.0` de l'intégration Notion ajoute le support de OAuth, qui est maintenant l'option de configuration par défaut.

Si vous avez précédemment créé une intégration Notion dans le portail de développement Notion et que vous souhaitez continuer à utiliser cette intégration, veuillez sélectionner l'option de configuration manuelle et suivre les instructions ci-dessous.

Sinon, sélectionnez l'option de configuration automatique et cliquez sur le bouton d'autorisation, puis suivez les instructions à l'écran pour connecter votre chatbot Botpress à Notion.

## Configuration

### Configuration automatique avec OAuth (recommandé)

C'est la façon la plus simple de configurer l'intégration. Pour configurer l'intégration de Notion en utilisant OAuth, cliquez sur le bouton d'autorisation et suivez les instructions à l'écran pour connecter votre chatbot Botpress à Notion. Cette méthode est recommandée car elle simplifie le processus de configuration et assure une communication sécurisée entre votre chatbot et Notion.

Lorsque vous utilisez ce mode de configuration, une application Notion  Botpress sera utilisée pour se connecter à votre compte Notion . Les actions prises par le bot seront attribuées à cette application, et non à votre compte personnel Notion .

### Configuration manuelle avec une intégration Notion personnalisée

#### Etape 1 - Créer l'intégration

Créer une intégration Notion [Créer une intégration - Développeurs Notion ]notion

#### Etape 2 - Donner accès aux actifs de Notion 

Donnez à votre intégration l'accès à toutes les pages et bases de données que vous voulez utiliser avec Botpress

#### Etape 3 - Configurez votre Bot

Donnez à votre intégration l'accès à toutes les pages et bases de données que vous souhaitez utiliser avec Botpress. [Partager une base de données avec votre intégration - Notion Developers]notion

Vous avez besoin d'un token pour connecter votre nouvelle intégration Notion _(pas la même que l'intégration Notion de Botpress Studio)_ avec Botpress Studio :

- `Auth Token` - Vous le trouverez en allant sur votre intégration sous notion. Une fois que vous avez cliqué sur votre intégration, allez dans la section "Secrets" et trouvez le champ "Internal Integration Secret". Cliquez sur "Show" puis sur "Copy". Collez le token copié dans le champ `Auth Token` de l'intégration Notion sous l'onglet "Integrations" de votre bot.

Il ne vous reste plus qu'à activer votre intégration et vous pourrez commencer à étendre les capacités de votre bot avec Notion.

## Usage

Les actions suivantes requièrent que vous connaissiez les identifiants des entités de Notion avec lesquelles votre bot va travailler. Toutes les entités notion (pages, bases de données, etc.) ont un identifiant qui peut être trouvé dans l'URL lorsque vous les visitez dans votre compte Notion dans un navigateur, ou en obtenant le lien en cliquant sur l'élément "Copier le lien" dans le menu (...). Voir [Get a Database Id - Notion Developers]notion pour plus d'informations.

### Ajouter un commentaire à une discussion

Cette action vous permet d'ajouter un commentaire à une discussion existante. Utilisez cette action pour répondre à un commentaire.

### Ajouter un commentaire à une page

Cette action vous permet d'ajouter des commentaires au niveau d'une page.

### Obtenir une base de données

Cette action vous permet d'obtenir les détails d'une base de données. Elle est idéalement utilisée avec l'action `Add Page to a Database`. En plus de la réponse de l'API de Notion ([Retreive a Database - Notion Developers]notion), cette action renvoie également une propriété optimisée `structure` (techniquement une déclinaison de type) qui peut être utilisée comme entrée pour une tâche d'IA afin de lui demander de générer une charge utile pour ajouter ou mettre à jour une page dans une base de données de Notion sur la base d'une entrée utilisateur.

### Ajouter une page à une base de données

Cette action devrait idéalement être utilisée en tandem avec `Get a Database` qui renvoie la structure de la base de données que vous pouvez utiliser pour demander à une [AI task]botpress de générer une charge utile. Voir [Working with Databases - Notion Developers]notion pour plus d'informations.

### Supprimer un bloc

Vous pouvez supprimer les entités suivantes :

- une page dans une base de données
- une page
- un bloc