Récupérer une action personnalisée dans Zoho CRM vous permet d'inspecter, de réutiliser ou de dépanner les actions automatisées — telles que les mises à jour de champs, les notifications par e-mail, les webhooks et les fonctions — qui alimentent vos workflows de vente et de marketing. Chez Beam Help (support expert indépendant pour Zoho, et non le support officiel de Zoho), nous vous guidons pas à pas pour localiser et examiner ces actions.
Pourquoi c'est important
Les actions personnalisées dans Zoho CRM sont les éléments fondamentaux de l'automatisation : elles se déclenchent lorsque des règles de workflow, des blueprints ou des processus d'approbation sont activés. Si une action se comporte de manière incorrecte, est dupliquée ou doit être réutilisée dans une nouvelle règle, vous devez d'abord savoir comment la récupérer et l'inspecter. Comprendre où ces actions se trouvent est également utile lorsque vous souhaitez associer une fonction ou un webhook existant à un nouveau workflow plutôt que de le recréer de zéro. [8]
Étape par étape
Étape 1. Connectez-vous à votre compte Zoho CRM et accédez à Configuration (l'icône d'engrenage en haut à droite). Il s'agit du hub central pour toute la personnalisation et la configuration de l'automatisation. [8]
Étape 2. Dans Configuration, accédez à Automatisation puis sélectionnez Actions. Cette section répertorie toutes les actions configurées dans votre CRM — y compris les tâches de workflow, les mises à jour de champs, les notifications par e-mail, les webhooks et les fonctions associées. [8]
Étape 3. Sur la page Actions, vous verrez le catalogue complet des actions enregistrées, regroupées par type. Parcourez la liste ou utilisez la barre de recherche pour localiser l'action personnalisée dont vous avez besoin. La liste affiche le nom de l'action, son type et le module auquel elle appartient, ce qui facilite l'identification de la bonne entrée. [8]
Étape 4. Cliquez sur le nom de l'action que vous souhaitez récupérer. Cela ouvre la vue détaillée où vous pouvez inspecter chaque paramètre — par exemple, les champs mis à jour, le script de fonction associé ou l'endpoint webhook configuré. [8]
Étape 5. Si l'action personnalisée implique une fonction (un script Deluge), la vue détaillée affichera le bloc de code et toutes les références de connexion utilisées pour invoquer des services externes. Les connexions sont identifiées par un Nom de lien, et le bloc de code lui-même indique la méthode HTTP (GET, POST, PUT ou DELETE) ainsi que les paramètres dynamiques que la fonction transmet au moment de l'exécution. [7]
Étape 6. Pour réutiliser l'action dans une autre règle de workflow, revenez à l'éditeur de règles de workflow, faites défiler jusqu'à la section Actions et choisissez Associer. La liste déroulante affichera toutes les actions précédemment créées du type concerné, vous permettant ainsi d'associer l'action récupérée sans avoir à la reconstruire. [8]
Étape 7. Si l'action que vous recherchez est liée à un connecteur (une intégration avec un service tiers), accédez à Configuration → Espace développeur → Connexions. Vous pouvez y consulter le Nom de lien, le Nom du service et le Statut actuel de chaque connexion, ainsi que l'extrait de code prêt à l'emploi pour l'invoquer dans une fonction. [7]
Erreurs courantes
- L'action n'apparaît pas dans la liste. Les actions sont spécifiques à un module dans certains contextes. Si vous ne trouvez pas une action, vérifiez que vous cherchez dans le bon périmètre de module — une action créée pour les Prospects n'apparaîtra pas automatiquement lors de la modification d'un workflow Contacts. [8]
- Le statut de la connexion est inactif. Lors de la récupération d'une action basée sur une fonction, vérifiez toujours que la connexion associée affiche un statut Actif sous Configuration → Connexions. Une connexion inactive entraînera l'échec silencieux de la fonction au moment de l'exécution. [7]
- Les paramètres dynamiques renvoient des valeurs vides. Si l'action récupérée utilise des paramètres pour extraire des données spécifiques à un enregistrement (comme le nom ou l'e-mail d'un prospect), vérifiez que les mappages de paramètres référencent toujours des noms d'API de champs valides. Les noms d'API de champs peuvent changer si un champ est supprimé puis recréé. [7]
- Appel d'une fonction autonome depuis une autre fonction. Si votre action personnalisée appelle une fonction autonome via une URL (en utilisant
invokeurl), confirmez que le chemin de l'endpoint et le type d'authentification sont toujours corrects — par exemple, les appels basés sur OAuth nécessitent une connexion valide et non expirée. [2]
Ce qu'il faut vérifier
- L'action est toujours liée à au moins une règle active. Ouvrez la vue détaillée de l'action et confirmez qu'elle est associée à une règle de workflow ou à un blueprint actif ; les actions orphelines peuvent facilement passer inaperçues lors des audits. [8]
- Les identifiants de connexion sont valides. Si l'action intègre un service tiers, vérifiez que la connexion sous Configuration → Connexions affiche le bon Nom de lien et un statut Actif avant de vous appuyer sur l'action en production. [7]
- Les paramètres de fonction correspondent aux noms de champs actuels. Après avoir récupéré une action basée sur une fonction, comparez les références de paramètres dynamiques avec la liste de champs actuelle du module concerné afin d'éviter les erreurs d'exécution. [7]