Comment créer des variables dans Zoho CRM

Les variables dans les requêtes Zoho CRM vous permettent d'injecter des valeurs dynamiques au moment de l'exécution, rendant une requête enregistrée réutilisable dans de nombreux contextes différents sans avoir à la réécrire à chaque fois.

Pourquoi c'est important

Lorsque vous créez une requête dans Zoho CRM, des valeurs de filtre codées en dur limitent sa réutilisation. Les variables résolvent ce problème en agissant comme des espaces réservés qui sont remplis au moment où la requête s'exécute — par exemple, en transmettant un ID de contact spécifique ou une valeur d'étape depuis un composant Canvas ou un appel API. Comprendre comment les déclarer et les utiliser correctement permet de gagner un temps de développement considérable et de maintenir votre bibliothèque de requêtes légère. ^[5]

---

Étape par étape

Étape 1. Accédez à la section Requêtes en allant dans Configuration → Developer Hub → Requêtes. La fenêtre Requêtes s'ouvre et liste toutes les requêtes existantes que vous avez déjà créées. ^[2]

Étape 2. Cliquez sur Ajouter une requête pour commencer à créer une nouvelle requête. Dans la fenêtre contextuelle Créer une requête, saisissez un Nom de requête et un Nom API, puis cliquez sur Suivant. ^[2]

Étape 3. Sous Configuration, le type de source par défaut est Module Zoho CRM. Si vous avez besoin d'un type de source différent (tel que COQL ou REST API), cliquez sur Modifier pour changer. Sélectionnez le module CRM que vous souhaitez interroger. Si le module contient des champs de liaison, vous pouvez inclure des modules associés via le menu déroulant Module associé — notez qu'un maximum de deux champs de module associé sont autorisés ici. ^[2]

Étape 4. Dans le menu déroulant Champs, sélectionnez les champs que vous souhaitez que la requête retourne. Vous pouvez sélectionner jusqu'à 50 champs dans une seule requête. ^[2]

Étape 5. Sous Critères, choisissez la façon dont vous souhaitez filtrer les enregistrements. Les options sont Aucun (pas de filtre), filtrer par ID d'enregistrement, ou appliquer des Critères personnalisés en utilisant des comparateurs combinés avec des opérateurs ET/OU. C'est ici que les variables deviennent essentielles : au lieu de saisir une valeur fixe pour un critère, choisissez l'option de valeur dynamique. Une valeur dynamique indique que les données réelles seront fournies lors de l'exécution de la requête ailleurs dans votre configuration CRM. ^[2]

Étape 6. Déclarez votre variable en utilisant la syntaxe requise. Partout où vous souhaitez une valeur dynamique — dans un champ de critère, une instruction COQL, un endpoint REST API ou une valeur de paramètre — saisissez le nom de la variable encadré par des doubles accolades : {{VARIABLE_NAME}}. C'est le seul format accepté ; tout écart empêchera la variable d'être reconnue au moment de l'exécution. ^[1][5]

Étape 7. Les variables sont prises en charge dans plusieurs emplacements de requête : valeurs de critères, instructions COQL, URL d'endpoints et autres champs de paramètres. Lorsque vous associerez ultérieurement la requête à un composant tel qu'une vue Canvas, vous serez invité à mapper chaque variable déclarée au champ ou à la source de données appropriée afin que la valeur d'exécution puisse être transmise correctement. ^[5]

Étape 8. Une fois votre requête et vos variables configurées, cliquez pour enregistrer. Vous pouvez revenir à la requête à tout moment depuis l'onglet Requêtes. Pour ajuster la structure de la réponse, survolez la requête, cliquez sur l'icône à trois points et sélectionnez Gérer le schéma — cela vous permet de modifier les types de champs et les libellés dans la sortie de la requête sans la réécrire. ^[1]

---

Erreurs courantes

• Syntaxe de variable incorrecte. Les variables doivent être écrites sous la forme {{VARIABLE_NAME}} — les accolades simples, les crochets ou tout autre format ne fonctionneront pas. Vérifiez chaque espace réservé avant d'enregistrer. ^[1][5]
• Variables non mappées lors de l'association. Si vous associez une requête contenant des variables à un composant Canvas ou à une autre fonctionnalité CRM sans mapper chaque variable à un champ source, la requête échouera à l'exécution car aucune valeur n'est fournie. Vérifiez toujours l'étape de mappage après avoir associé une requête. ^[5]
• Dépassement des limites de champs ou de liaisons. Sélectionner plus de 50 champs ou plus de deux liaisons de modules associés entraînera le rejet de la configuration de la requête. Planifiez votre sélection de champs avant de créer les critères. ^[2]
• Prérequis pour la source REST API. Si vous utilisez un type de source REST API plutôt qu'un module CRM, vous devez d'abord ajouter l'hôte externe aux Domaines de confiance et mettre en liste blanche les IP de Zoho CRM sur votre serveur relais avant que la source puisse être validée et enregistrée. ^[5]

---

Ce qu'il faut vérifier

• La syntaxe des variables est correcte — confirmez que chaque espace réservé dynamique dans votre requête suit le format à doubles accolades {{VARIABLE_NAME}} avant d'enregistrer. ^[1]
• Les variables sont mappées — après avoir associé la requête à un Canvas ou à un autre composant, ouvrez la configuration de mappage et vérifiez que chaque variable est résolue vers un champ de données actif. ^[5]
• Le schéma correspond à vos besoins — utilisez Gérer le schéma pour confirmer que les types de champs et les libellés dans la réponse de la requête correspondent à ce qu'attend le composant consommateur, surtout si vous avez modifié le schéma après la création initiale. ^[1]

---

*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Pour les problèmes au niveau de la plateforme, soumettez toujours un ticket directement auprès de Zoho.*