Ajouter et gérer des connexions avec l’API

Ajouter et gérer des intégrations avec l’API - bannière
Dans cet article

Vous pouvez utiliser notre API pour connecter d’autres applications à Notion, automatiser certaines actions dans votre espace de travail, et accéder aux connexions développées par nos partenaires. 🤖


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 membresMes connexions. Les propriétaires d’espace de travail peuvent ajouter des connexions à un espace de travail dans Paramètres et membresConnexions. Une fois qu'une connexion a été ajoutée, elle peut être ajoutée à d'autres pages.

Remarque : dans les forfaits Entreprise, la possibilité d'ajouter des connexions peut être limitée aux propriétaires des espaces de travail. Cliquez ici pour en savoir plus.

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.

Remarque : Seuls les propriétaires d’espaces de travail peuvent gérer toutes les connexions dans un espace de travail. Les membres ne peuvent gérer que les connexions qu’ils ont créées.

Avec un forfait Entreprise, vous pouvez limiter la création de connexions aux propriétaires d’espace de travail uniquement.

  • 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.

Remarque : Seuls les propriétaires d’espaces de travail peuvent gérer toutes les connexions dans un espace de travail. Les membres ne peuvent gérer que les connexions qu’ils ont créées.

Avec un forfait Entreprise, vous pouvez limiter la création de connexions aux propriétaires d’espace de travail uniquement.

  • 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.

Limiter les droits d’installation des connexions par les membres

  • 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.

Approuver automatiquement les connexions créées par Notion

  • 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

Gérer la liste des connexions autorisées

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

Remarque : avant de pouvoir approuver une connexion pour le reste de votre espace de travail, vous (ou un autre administrateur) devez d’abord l’installer ! Seules les connexions déjà installées dans l’espace de travail s’afficheront dans le menu déroulant + Connexion approuvée.

Les instructions pour l’installation des connexions sont décrites ci-dessous.

  • 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.

Installer directement depuis une plateforme partenaire via OAuth

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.

Installer via un jeton d’intégration interne

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.

Remarque : Notion ne fournit pas d’assistance pour les problèmes liés aux intégrations partenaires. Nous vous recommandons de contacter directement le service client du partenaire.


Donner votre avis

Cette ressource vous a-t-elle été utile ?