Utilisation des actions monday.com 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 avec monday.com en utilisant un token AP pour automatiser les tâches, comme la création, la mise à jour et la suppression d’éléments, l’ajout de commentaires et la gestion du statut ou du propriétaire des éléments. Cette intégration vous aide à simplifier les workflows en synchronisant les données entre les plateformes, ce qui améliore la collaboration et la gestion des tâches entre les équipes sans mises à jour manuelles.

En connectant le créateur d’actions à des systèmes externes, comme monday.com, 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 monday.com au créateur d’actions
• Utilisation des actions monday.com dans les workflows d’actions

Connexion de monday.com 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.

Lorsque 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 nécessitent des portées obligatoires. Cependant, il est important d’examiner et de valider les portées avant de valider l’accès au système externe.
• Si 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 générer votre token API

La connexion à monday.com nécessite un token API pour l’authentification. Stockez votre token API de manière sécurisée et ne le partagez jamais publiquement. Traitez-le comme un mot de passe.

1. Allez à votre photo de profil dans monday.com.
2. Cliquez sur Developers.
3. Allez à API Token.
4. Générez un nouveau token.
5. Enregistrez le token ou laissez la fenêtre ouverte pour pouvoir le copier et le coller dans Zendesk.

   Vous en aurez besoin pour connecter monday.com au créateur d’actions.

Vous pouvez aussi gérer vos tokens sur https://[votre-compte].monday.com/apps/manage/tokens. Consultez la documentation sur l’authentification de monday.com pour en savoir plus.

Pour connecter le créateur d’actions à monday.com

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 monday.com.
5. Cliquez sur Connexion.
6. Suivez les prompts de monday.com pour saisir votre token API monday.com et terminer la connexion.
   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 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 monday.com.

Utilisation des actions monday.com dans les workflows d’actions

Les actions monday.com suivantes sont disponibles :

• Créer un élément
• Rechercher un élément
• Mettre à jour l’élément
• Mettre à jour le statut de l’élément
• Mettre à jour le propriétaire de l’élément
• Créer un sous-élément
• Ajouter un commentaire
• Déplacer un élément vers un groupe
• Supprimer un élément
• Répertorier tous les éléments
• Rechercher un tableau
• Rechercher un utilisateur

Création d’un élément

Utilisez l’action Créer un élément pour créer un nouvel élément dans un tableau monday.com avec des valeurs de colonnes personnalisées.

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

	Variables
Entrées	Obligatoires : Board, Item name Facultatives : Group, colonnes spécifiques au tableau Une fois que vous avez sélectionné un tableau, des champs de saisie supplémentaires s’affichent pour les colonnes personnalisées de ce tableau. Vous pouvez définir des valeurs pour les colonnes de texte, de statut, de date, d’utilisateur et d’autres types de colonnes pris en charge par monday.com. Les valeurs des colonnes sont renvoyées sous la forme d’un tableau avec identifiant, texte, valeur et type pour chaque colonne.
Sortie	Les détails de l’élément, notamment item_id, board_id, group_id, item_name, item_url, board_name, group_title, created_at, creator_id, state et tableau column_values.

Recherche d’un élément

Utilisez l’action Rechercher un élément pour récupérer les détails d’un élément spécifique par identifiant.

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

	Variables
Entrées	Obligatoire : Item ID
Sortie	Les détails de l’élément, notamment item_id, item_name, item_url, state, board (avec identifiant et nom), group (avec id et titre), tableau column_values, creator (avec identifiant et nom), created_at et updated_at.

Mise à jour d’un élément

Utilisez l’action Mettre à jour l’élément pour modifier les valeurs des colonnes pour un élément existant.

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

	Variables
Entrées	Obligatoires : Board, Item ID Facultatives : colonnes spécifiques au tableau Une fois que vous avez sélectionné un tableau, des champs de saisie supplémentaires s’affichent pour les colonnes personnalisées de ce tableau. Fournissez uniquement des valeurs pour les colonnes que vous voulez mettre à jour. Les valeurs existantes pour les colonnes que vous ne spécifiez pas resteront inchangées.
Sortie	Les détails de l’élément, notamment item_id, item_name, item_url, board_id, board_name, group_id, group_title, state, updated_at et tableau column_values.

Mise à jour du statut d’un élément

Utilisez l’action Mettre à jour le statut de l’élément pour modifier le libellé de statut dans une colonne de statut.

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

	Variables
Entrées	Obligatoires : Item ID, Board, Status column, Status label
Sortie	Les détails de l’élément, notamment item_id, item_name, item_url, board_id, board_name, group_id, group_title, state, status_column_id et updated_status_value.

Mise à jour du propriétaire d’un élément

Utilisez l’action Mettre à jour le propriétaire de l’élément pour affecter un utilisateur à la colonne d’utilisateur de l’élément.

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

	Variables
Entrées	Obligatoires : Item ID, Board, People column, User Le champ de la colonne d’utilisateur est rempli dynamiquement en fonction des colonnes de type utilisateur du tableau que vous avez sélectionné. Le champ d’utilisateur vous permet de rechercher un utilisateur dans les utilisateurs de votre espace de travail et de le sélectionner.
Sortie	Les détails de l’élément, notamment item_id, item_name, item_url, board_id, board_name, group_id, group_title, state, people_column_id, people_column_value et assignee_user_id.

Création d’un sous-élément

Utilisez l’action Créer un sous-élément pour créer un sous-élément sous un élément parent existant. Les sous-éléments sont créés dans le tableau des sous-éléments de l’élément parent et héritent du contexte du tableau de leur élément parent.

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

	Variables
Entrées	Obligatoires : Parent item ID, Item name
Sortie	Les détails du sous-élément, notamment subitem_id, subitem_name, subitem_url, parent_item_id, parent_item_name, board_id, board_name, group_id, group_title, state, created_at et tableau column_values. subitem_url fournit un lien direct vers le sous-élément dans monday.com.

Ajout d’un commentaire

Utilisez l’action Ajouter un commentaire pour publier un commentaire ou mettre un élément à niveau.

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

	Variables
Entrées	Obligatoires : Item ID, Comment
Sortie	Les détails du commentaire, notamment update_id, item_id, comment_text, created_at et objet de créateur (avec identifiant et nom).

Déplacement d’un élément vers un groupe

Utilisez l’action Déplacer un élément vers un groupe pour déplacer un élément dans un autre groupe au sein du même tableau.

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

	Variables
Entrées	Obligatoires : Item ID, Board, Group Le champ de groupe est rempli dynamiquement en fonction des groupes disponibles dans le tableau sélectionné. Vous pouvez déplacer les éléments entre les groupes d’un même tableau.
Sortie	Les détails de l’élément, notamment item_id, item_name, item_url, board_id, board_name, destination_group_id, destination_group_title et state.

Suppression d’un élément

Utilisez l’action Supprimer un élément pour supprimer définitivement un élément de monday.com.

Important : cette action supprime définitivement l’élément et est irréversible. Il faut donc l’utiliser avec prudence.

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

	Variables
Entrées	Obligatoire : Item ID
Sortie	L’identifiant de l’élément et le statut de confirmation de suppression.

Répertorier tous les éléments

Utilisez l’action Répertorier tous les éléments pour récupérer les éléments d’un tableau ou de tous les tableaux.

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

	Variables
Entrées	Facultatives : Board, Limit Si vous ne spécifiez pas de tableau, l’action effectue ses recherches dans tous les tableaux accessibles de votre espace de travail. Le champ de limite contrôle le nombre maximum d’éléments renvoyés (par défaut : 25).
Sortie	Un tableau des éléments contenant les objets des éléments (chacun avec item_id, item_name, item_url, state, board_id, board_name, group_id, group_title et tableau column_values) et l’indicateur booléen has_more. L’indicateur has_more indique si d’autres éléments sont disponibles, au-delà de la limite spécifiée.

Recherche d’un tableau

Utilisez l’action Rechercher un tableau pour récupérer les détails d’un tableau spécifique. Utilisez cette action pour découvrir la structure d’un tableau, notamment tous les groupes et toutes les colonnes disponibles et leurs types. Ces informations sont utiles pour créer des workflows dynamiques.

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

	Variables
Entrées	Facultative : Board ID
Sortie	Les détails du tableau, notamment board_id, board_name, description, state, board_kind, objet d’espace de travail (avec identifiant et nom), tableau de groupes (chacun avec identifiant et titre) et tableau de colonnes (chacune avec identifiant, titre et type).

Recherche d’un utilisateur

Utilisez l’action Rechercher un utilisateur pour récupérer des informations sur un utilisateur par identifiant ou adresse e-mail.

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

	Variables
Entrées	Facultatives : User ID, Email Indiquez soit ID d’utilisateur, soit E-mail pour rechercher un utilisateur. Si les deux sont indiqués, ID d’utilisateur a priorité.
Sortie	Les détails de l’utilisateur, notamment user_id, name, email, title, photo_url et objet de compte (avec identifiant et nom). photo_url fournit un lien direct vers la photo de profil de l’utilisateur dans monday.com.