Ajouter et gérer des connexions avec l’API

Que diriez-vous de créer vos propres intégrations et workflows avec l’API Notion ? Venez jeter un œil à notre espace pour les développeurs pour accéder à toute notre documentation, nos ressources et outils de gestion des intégrations.

Les membres peuvent ajouter des connexions à un espace de travail dans Paramètres et membres → Mes connexions. Les propriétaires d’espace de travail peuvent ajouter des connexions à un espace de travail dans Paramètres et membres → Connexions. Une fois qu'une connexion a été ajoutée, elle peut être ajoutée à d'autres pages.

Les connexions conçues avec l’API obéissent à un système d’autorisations semblables aux autorisations de partage pour les utilisateurs de Notion. Pour utiliser une connexion dans votre espace de travail, vous devez l’ajouter à la page dans laquelle elle sera active.

• Ouvrez cette page et cliquez sur le bouton ••• en haut à droite.

• En bas de la fenêtre contextuelle, cliquez sur Ajouter des connexions.

• Dans la fenêtre contextuelle qui s’affiche, recherchez et choisissez la connexion à ajouter. Vous pourrez uniquement voir les connexions créées pour cet espace de travail, et qui lui ont été associées.

• La connexion s’affichera alors dans le menu ••• de la page.

• Pour retirer une connexion d’une page, survolez son nom, puis choisissez Déconnecter.

• Depuis la barre latérale de gauche, cliquez sur Paramètres et membres, puis sur l’onglet Connexions.

• Vous y trouverez toutes les connexions actuellement installées dans cet espace de travail, le nom du propriétaire qui a ajouté la connexion, et la date d’ajout.

• Cliquez sur ••• à côté d’une connexion pour voir les autres options :

  • Récupérer un jeton d’API interne.

  • Consulter le site Web du développeur ou contacter son service d’assistance technique.

  • Afficher les utilisateurs ayant accès à la connexion.

  • Mettre fin à la connexion.

Si votre espace de travail dispose du forfait Entreprise, les propriétaires disposeront de paramètres supplémentaires pour gérer les connexions dans cet espace.

• En tant que propriétaire de l’espace de travail, cliquez sur Paramètres et membres, puis sur l’onglet Connexions.

• L’option Limiter l’installation de nouvelles connexions par les membres s’affiche en haut de l’écran. Cliquez sur le menu déroulant à droite pour choisir entre les deux options :

  • Aucune restriction : tous les membres de l’espace de travail peuvent installer n’importe quelle connexion dans l’espace de travail.

  • À partir de la liste des connexions autorisées : les membres de l’espace de travail peuvent uniquement installer les connexions préalablement approuvées par un propriétaire de l’espace.

• Si l’option À partir de la liste des connexions autorisées est sélectionnée, les propriétaires de l’espace de travail verront une option supplémentaire leur permettant d’approuver automatiquement les connexions créées par Notion. Par exemple :

  • GitHub

  • Jira

  • Slack

  • Asana

  • Trello

• Cliquez sur le bouton + Ajouter une connexion approuvée pour approuver de nouvelles connexions pour les membres de votre espace de travail.

• Dans la section Connexions approuvées, les propriétaires d’espace de travail peuvent voir la liste complète des connexions approuvées et installées dans l’espace de travail.

• À droite du nom de la connexion, nous affichons le nom de l’utilisateur qui l’a installée.

• Cliquez sur le menu ••• pour :

  • filtrer par utilisateur ;

  • révoquer l’accès de certains utilisateurs à une connexion ;

  • déconnecter tous les utilisateurs ;

  • supprimer la connexion de la liste des connexions approuvées.

Notion s’est associé à plusieurs services (comme Zapier et Typeform) pour vous proposer des connexions directement accessibles dans votre espace de travail, via OAuth.

• Recherchez Notion dans le menu des applications de la plateforme partenaire, et ajoutez-la.

• Dans le menu d’authentification, le service de connexion vous demandera un accès à votre espace de travail. Les niveaux d’accès requis pour la connexion seront précisés.

• Les connexions sont propres à chaque espace de travail. Si besoin, cliquez sur le nom de l’espace de travail en haut à droite, puis sélectionnez-en un autre. Choisissez ensuite Sélectionner des pages.

• Vous voyez alors la liste de toutes les pages de l’espace de travail choisi. Choisissez les pages auxquelles la connexion peut accéder, puis sélectionnez Donner l’accès.

• Une fois l’authentification terminée, la connexion sera visible dans le menu Paramètres et membres → Connexions de votre espace de travail.

• Cliquez sur le menu ••• (à côté du nom de la connexion) pour consulter le site Web du développeur, contacter son service client ou déconnecter votre espace de travail.

Certaines plateformes partenaires nécessitent un jeton d’intégration interne pour se connecter à votre espace de travail.

• Dans ce cas, suivez d’abord ces instructions pour créer une intégration interne correspondante pour votre espace de travail.

• Une fois l’intégration créée, cliquez sur Paramètres et membres dans la barre latérale, puis sur l’onglet Connexions.

• Cliquez sur le menu ••• situé à côté de la connexion que vous souhaitez lier à une plateforme partenaire, puis sur Copier le jeton d’intégration interne.

• Collez ce jeton d’intégration interne dans le champ correspondant du formulaire de configuration de la plateforme partenaire.