Comment récupérer les boutons personnalisés dans Zoho

Les boutons personnalisés dans Zoho CRM peuvent être récupérés et gérés via la page Boutons dans les paramètres de personnalisation du CRM. Ils peuvent également être enrichis d'une logique Client Script pour des comportements plus interactifs directement sur la page d'enregistrement.

Pourquoi c'est important

Si vous créez des automatisations, des expériences portail ou des extensions développeur dans Zoho CRM, savoir où localiser et modifier les boutons personnalisés existants vous fait gagner un temps précieux en résolution de problèmes. Les boutons personnalisés vous permettent de déclencher une logique spécifique à un enregistrement, de remplir automatiquement des champs et d'exécuter des flux guidés en plusieurs étapes — le tout sans quitter la vue actuelle. ^[6] Comprendre comment les récupérer est également indispensable avant d'associer un Client Script ou des fonctions Deluge à un bouton existant.

---

Étape par étape

Étape 1. Connectez-vous à votre compte Zoho CRM en tant qu'administrateur. Accédez à Configuration (l'icône d'engrenage en haut à droite), puis rendez-vous dans Personnalisation. Il s'agit du hub central pour toutes les personnalisations au niveau des modules, y compris les boutons et les liens. ^[6]

Étape 2. Dans Personnalisation, sélectionnez Modules et champs, puis choisissez le module spécifique (par exemple, Contacts, Affaires ou un module personnalisé) dont vous souhaitez récupérer les boutons. Chaque module dispose de son propre ensemble indépendant de boutons personnalisés. ^[6]

Étape 3. Dans l'éditeur de module, localisez et cliquez sur la section Liens et boutons (parfois intitulée Boutons personnalisés). Cette page répertorie tous les boutons personnalisés créés pour ce module, ainsi que leur type de placement — par exemple, Page de détail, Menu d'action groupée de la page de liste ou Liste associée. ^{[1] [6]}

Étape 4. Cliquez sur le nom d'un bouton dans la liste pour ouvrir sa configuration. Vous pouvez y consulter le nom du bouton, son placement, la fonction Deluge ou le Client Script associé, ainsi que les restrictions au niveau du profil qui contrôlent quels utilisateurs le voient. ^{[6] [3]}

Étape 5. Si vous devez récupérer ou inspecter le Client Script associé à un bouton, notez que si le bouton lui-même est créé depuis la page Boutons, son Client Script peut être consulté et modifié séparément via la page de configuration du Client Script. Accédez à Configuration > Espace développeur > Client Script pour trouver le script associé. ^[6]

Étape 6. Pour les boutons utilisés dans les Portails (Candidat, Client, Fournisseur ou Personnalisé), le chemin de récupération est la même page Boutons, mais vous devez également vérifier les paramètres de restriction du Profil portail pour comprendre quels utilisateurs du portail peuvent voir chaque bouton. ^[3] Ces affectations de profil sont visibles lorsque vous ouvrez la vue de modification du bouton.

Étape 7. Si vous travaillez de manière programmatique et devez invoquer la logique sous-jacente d'un bouton via l'API, la fonction Deluge du bouton peut appeler les API Zoho CRM en interne via la couche ZDK CRM APIs, qui encapsule les endpoints REST standard du CRM. ^[6] Examinez le code de la fonction associée au bouton pour identifier les endpoints utilisés.

---

Erreurs courantes

• Le Client Script ne peut pas être créé depuis la page de configuration du Client Script pour les boutons. Il doit être initié depuis la page Boutons elle-même. Vous pouvez uniquement *modifier* le Client Script d'un bouton existant depuis la page de configuration — pas en créer un nouveau. ^[6]

• Les boutons d'action groupée de la page de liste peuvent ne pas remplir automatiquement les ID des enregistrements sélectionnés dans certains modules personnalisés. Si vous constatez que l'argument List est vide lors du déclenchement d'un bouton d'action groupée, vérifiez que le module est correctement configuré pour transmettre les ID des enregistrements sélectionnés à la fonction. Il s'agit d'un cas limite connu signalé dans le module Packages. ^[1]

• Les boutons portail sont soumis à des restrictions de profil. Si un bouton personnalisé semble manquant pour un utilisateur du portail, la cause la plus probable est que le bouton n'a pas été affecté au bon profil portail (par exemple, Candidat, Client ou Fournisseur). Vérifiez toujours les affectations de profil lors de la récupération de boutons destinés à une utilisation portail. ^[3]

• La portée du module est importante. Les boutons personnalisés sont spécifiques à un module. Un bouton créé pour le module Contacts n'apparaîtra pas dans la liste du module Affaires. Si vous ne trouvez pas un bouton, vérifiez que vous consultez bien la page Boutons du bon module. ^[6]

---

Points à vérifier

• Confirmez que le bon module est sélectionné sur la page Boutons — les boutons sont limités à leur module et n'apparaîtront pas dans d'autres modules. ^[6]
• Vérifiez les affectations de profil et de portail si le bouton est destiné aux utilisateurs du portail, en vous assurant que le bon profil portail (Candidat, Client, Fournisseur ou Personnalisé) est activé sur le bouton. ^[3]
• Consultez la page de configuration du Client Script pour confirmer si une logique de script supplémentaire est associée au bouton au-delà de la fonction Deluge principale, surtout si le comportement du bouton semble incomplet. ^[6]

---

*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Testez toujours les modifications de boutons dans un environnement sandbox avant de les déployer en production.*