Intégrations de l’API de Notion

Pour accéder à la documentation, aux ressources et aux outils de gestion des intégrations, rendez-vous sur notre espace pour les développeurs .

1. Depuis la barre latérale gauche, cliquez sur Paramètres, puis sur Intégrations.

2. Seuls les propriétaires d’espace de travail peuvent accéder à l’onglet Intégrations et créer des intégrations. Si ce n’est pas votre cas, contactez votre administrateur d’espace de travail ou utilisez un autre espace.

3. En bas de la fenêtre, cliquez sur Développer vos propres intégrations.

4. Une nouvelle fenêtre Mes intégrations s’ouvrira dans votre navigateur. Cliquez sur le bouton + Nouvelle intégr..

5. Donnez un Nom à votre intégration. Vous pouvez également importer une image pour le logo.

6. Dans le menu déroulant, choisissez l’ Espace de travail associé à cette intégration.

   

   Remarque : vérifiez que vous utilisez le même compte Notion sur votre session Web et votre application de bureau. Sinon, les comptes et espaces de travail que vous aurez sous les yeux ne seront pas les bons !

   

7. Votre intégration interne a été ajoutée avec succès ! Vous la verrez désormais dans votre espace de travail, dans le menu Paramètres  → Mes intégrations.

8. Cliquez sur ••• à côté de celle-ci pour récupérer le jeton d’intégration interne. Il sera nécessaire pour toutes les automatisations que vous développerez avec l’API, et vous permettra de relier votre espace de travail à des plateformes partenaires.

Toutes les nouvelles intégrations sont d’abord internes. Si vous êtes un développeur travaillant sur une intégration publique, suivez d’abord les instructions ci-dessus pour créer une intégration interne.

Ensuite, suivez les instructions de notre guide du développeur pour la convertir en intégration publique.

Pendant le processus de configuration de l’application, les développeurs pourront choisir le niveau d’accès qui sera demandé à l’utilisateur.

• Autorisations en matière de contenu :

  • Contenu en lecture seule

  • Contenu en écriture seule

  • Insérer du contenu

• Autorisations de l’utilisateur

  • Aucune information d’utilisateur

  • Consulter les informations des utilisateurs (hors adresses e‑mail).

  • Consulter les informations des utilisateurs, notamment les adresses e‑mail

Ce niveau d’accès s’affiche lorsque les utilisateurs installent des intégrations. Il apparaît aussi dans le menu Partager de toutes les page auxquelles l’intégration a été ajoutée. En savoir plus sur l’installation d’intégrations dans un espace de travail →

Les webhooks d’intégration permettent aux intégrations de surveiller et de répondre aux modifications apportées aux espaces de travail Notion en temps réel.

Lorsque des modifications sont apportées à des pages ou des bases de données partagées avec votre intégration, Notion envoie automatiquement des notifications à votre point d’accès webhook, ce qui permet à votre intégration de mettre à jour instantanément d’autres outils, d’exécuter des tâches automatisées ou d’afficher les dernières modifications.

Pour obtenir des instructions, consultez la documentation destinée aux développeurs.

Les actions de webhook et les webhooks d’intégration ont certains points communs : ils ont tous deux des déclencheurs et peuvent envoyer des événements à des services tiers. Cependant, les webhooks d’intégration offrent des fonctionnalités plus étendues :

• Ils peuvent surveiller l’activité dans plusieurs espaces de travail.

• Ils peuvent gérer un nombre illimité d’actions.

En revanche, les actions de webhook sont conçues pour des cas d’utilisation plus simples et sont configurées via des automatisations de base de données avec un ensemble limité de déclencheurs.