Utilisation des actions Notion dans les workflows d’actions

Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.

Mon édition

Suite, toutes les versions

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support

Team, Professional ou Enterprise

Résumé ◀▼

Vous pouvez connecter des workflows d’actions à Notion pour automatiser les tâches, comme la création, la mise à jour et la recherche de pages, l’ajout de commentaires et l’insertion de blocs de contenu. Utilisez un compte de service dédié pour les connexions et vérifiez les permissions avec soin. Ces actions vous aident à intégrer les workflows entre les plateformes, ce qui améliore la collaboration et la gestion du contenu au sein de vos processus d’assistance.

En connectant le créateur d’actions à des systèmes externes, comme Notion, les administrateurs peuvent intégrer Zendesk à des systèmes externes dans des workflows automatisés, ce qui améliore la collaboration et permet d’assurer une expérience fluide et cohérente sur plusieurs plateformes.

Remarque – Les étapes associées aux systèmes externes dans des workflows d’actions sont appelées collectivement des actions externes.

Cet article aborde les sujets suivants :

• Connexion de Notion au créateur d’actions
• Utilisation des actions Notion dans les workflows d’actions

Connexion de Notion au créateur d’actions

Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.

Quand vous vous connectez à des systèmes externes pour les utiliser dans des workflows d’actions, nous vous conseillons de suivre ces meilleures pratiques :

• Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.
• Toutes les intégrations demandent l’accès aux portées obligatoires. Cependant, il est important d’examiner et de valider les portées avant d’autoriser l’accès au système externe.
• Quand vous gérez les identifiants pour les outils basés sur des clés API, comme OpenAI, nous vous conseillons de stocker les clés dans un gestionnaire d’identifiants ou un coffre-fort sécurisé.

Pour connecter le créateur d’actions à Notion

1. Dans le Centre d’administration, cliquez sur Applications et intégrations () dans la barre latérale, puis sélectionnez Actions > Workflows d’actions.
2. Créez ou modifiez un workflow d’actions.
3. Ouvrez la barre latérale.
4. Sous Actions externes, cliquez sur Notion.
5. Cliquez sur Connexion.
6. Suivez les invites de Notion pour vous authentifier et terminer la connexion.

   Quand vous autorisez la connexion, vous êtes redirigé vers Notion pour accorder les permissions pour votre compte Zendesk.

   La connexion Notion utilise OAuth 2.0 avec le type d’octroi Code d’autorisation. Vérifiez les permissions avec soin avant d’autoriser la connexion. Ces permissions permettent aux workflows d’actions de créer et de modifier des pages, d’ajouter des commentaires, de gérer les éléments de la base de données et de mettre le contenu à jour dans votre espace de travail Notion pour votre compte.

   Remarque – Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.

Une fois que vous vous êtes connecté au système, vous verrez un indicateur de connexion et des détails sur l’instance à laquelle vous êtes connecté, ainsi que les actions disponibles pour Notion.

Utilisation des actions Notion dans les workflows d’actions

Les actions Notion suivantes sont disponibles :

• Créer une page
• Mettre la page à jour
• Rechercher une page
• Ajouter un commentaire
• Ajouter un bloc à la page

Création d’une page

Utilisez l’action Créer une page pour créer une nouvelle page dans Notion sous une page parent ou au niveau de l’espace de travail.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Titre Facultatives : Page parent, Créer au niveau de l'espace de travail, Contenu Vous devez spécifier Page parent ou configurer Créer au niveau de l’espace de travail sur vrai. Les pages au niveau de l’espace de travail sont disponibles uniquement pour les intégrations publiques. Le champ Page parent vous permet de rechercher vos pages Notion par nom.
Sortie	Détails de la page, notamment l’ID, l’URL et l’horodatage de création

Mise à jour d’une page

Utilisez l’action Mettre la page à jour pour mettre à jour le titre ou le statut d’une page Notion existante.

Remarque – L’archivage des pages au niveau de l’espace de travail n’est pas pris en charge via l’API Notion.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Identifiant de la page Facultatives : Titre, Archivé
Sortie	Détails de la page, notamment l’ID, l’URL et l’horodatage de la dernière modification

Recherche d’une page

Utilisez l’action Rechercher une page pour récupérer une page Notion par son identifiant ou son titre exact.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Facultatives : Identifiant de la page, Titre Soit l’identifiant de la page soit le titre est obligatoire. Remplissez l’un de ces champs pour identifier la page que vous voulez récupérer.
Sortie	Détails de la page, notamment l’identifiant, l’URL, le titre, l’icône, l’horodatage de création, l’horodatage de la dernière modification et le statut d’archivage.

Ajout d’un commentaire

Utilisez l’action Ajouter un commentaire pour ajouter un commentaire à une page ou un bloc Notion.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Identifiant de la page ou identifiant du bloc, Texte du commentaire Soit l’identifiant de la page soit le titre est obligatoire. Remplissez l’un de ces champs pour identifier la page que vous voulez récupérer.
Sortie	Identifiant du commentaire, horodatage de création et informations sur le créateur.

Ajout d’un bloc à la page

Utilisez l’action Ajouter un bloc à la page pour ajouter un bloc de contenu (un paragraphe, un titre ou une citation, par exemple) à une page Notion.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Facultatives : Identifiant de la page ou Type de bloc, Contenu Les types de blocs disponibles incluent : Paragraphe, Titre 1, Titre 2, Titre 3 et Citation.
Sortie	Identifiant du bloc, type et horodatage de création.