Comment récupérer des fonctions dans Zoho

Récupérer des fonctions dans Zoho CRM vous permet de localiser, d'examiner et de réutiliser la logique personnalisée déjà déployée dans votre organisation — ce qui vous fait gagner du temps et évite la duplication de code dans vos automatisations.

Pourquoi c'est important

Lorsque votre équipe crée des automatisations, des workflows ou des intégrations, les fonctions personnalisées s'accumulent rapidement. Pouvoir récupérer et inspecter ces fonctions vous permet d'auditer la logique avant de la déclencher, d'invoquer une fonction depuis une autre, et de transmettre les bons paramètres sans approximation. Cela est particulièrement pertinent lors de la connexion de Zoho CRM à des services externes ou à d'autres produits Zoho. En tant que support expert indépendant (et non le support officiel de Zoho), Beam Help vous guide à travers les étapes clés ci-dessous.

Étape par étape

Étape 1. Accédez à la zone des paramètres des fonctions dans votre application Zoho. Pour Zoho CRM, rendez-vous dans Configuration → Espace développeur → Fonctions. Cette page liste toutes les fonctions personnalisées disponibles dans votre compte, y compris les fonctions autonomes pouvant être appelées de manière externe. ^[1]

Étape 2. Identifiez la fonction que vous souhaitez récupérer. Chaque fonction possède un nom unique (par exemple, createcontact1) qui fait partie de son endpoint d'exécution. Notez ce nom — vous en aurez besoin pour invoquer ou inspecter la fonction par programmation. ^[1]

Étape 3. Pour récupérer ou invoquer une fonction depuis une autre fonction, utilisez la tâche Deluge invokeurl. Construisez la requête en pointant vers l'endpoint d'exécution de la fonction. Pour Zoho FSM, le modèle ressemble à ceci :

rest = invokeurl
[
  url: "https://fsm.zoho.com/fsm/v1/functions/<function_name>/actions/execute?auth_type=oauth"
  type: GET
  parameters: {"Last_Name":"Robins","Email":"lucy.robins@zylker.com"}
  headers: Map()
  connection: "fsm"
];
return rest;

Adaptez l'URL de base et le nom de connexion à votre environnement Zoho CRM. ^[1]

Étape 4. Authentifiez correctement la requête. Les appels de fonctions autonomes nécessitent OAuth. Vous aurez besoin d'un Access Token valide obtenu depuis https://accounts.zoho.com/oauth/v2/token, et la portée doit inclure l'autorisation appropriée pour les fonctions (par exemple, ZohoFSM.settings.functions.CREATE dans FSM — vérifiez la portée CRM équivalente dans votre console développeur). ^[5]

Étape 5. Examinez le contenu de la réponse. Lorsque la fonction s'exécute avec succès, les messages de journalisation info émis par votre fonction sont retournés sous la clé userMessage, tandis que la valeur de retour réelle de la fonction apparaît sous la clé output. Utilisez ces clés pour vérifier que la fonction s'est exécutée comme prévu et pour extraire les données dont vous avez besoin. ^[5]

Étape 6. Si vous devez appeler la fonction depuis une automatisation de workflow plutôt que depuis une autre fonction, vous pouvez la connecter via une action de workflow Fonction personnalisée. Dans l'éditeur Deluge de cette action, utilisez le même modèle invokeurl ci-dessus, en fournissant l'URL correcte, la méthode HTTP (GET ou POST), les paramètres et le nom de connexion. ^[7]

Étape 7. Pour gérer la fonction après récupération — par exemple pour modifier sa logique, la cloner pour un nouveau cas d'usage, ou supprimer une version obsolète — retournez à la liste des fonctions dans Configuration et utilisez le menu d'actions contextuel situé à côté du nom de la fonction. Les options disponibles incluent Modifier, Supprimer et Cloner. ^[1]

Erreurs courantes

• Mauvaise méthode HTTP pour votre type d'entrée. Les paramètres peuvent être transmis via GET (ajoutés à la chaîne de requête) ou POST (dans le corps de la requête). Les confondre entraîne la réception d'entrées vides par la fonction. Faites toujours correspondre la méthode à la façon dont votre fonction lit APIRequest. ^[5]
• Portée OAuth manquante ou incorrecte. Si le jeton d'accès a été généré sans la portée de fonctions requise, l'appel API sera rejeté. Régénérez le jeton avec la portée correcte avant de réessayer. ^[5]
• Invocation d'une fonction qui n'est pas autonome. Seules les fonctions explicitement publiées comme autonomes peuvent être appelées via le modèle d'URL externe. Les fonctions réservées aux workflows ne sont pas accessibles de cette façon. ^[1]
• Plusieurs entrées de recherche dans les actions de récupération. Lors de la récupération d'enregistrements dans le cadre de la logique d'une fonction, fournir trop de champs uniques en entrée peut produire un comportement de correspondance AND/OR inattendu. Utilisez le nombre minimal de champs uniques nécessaires pour identifier un enregistrement. ^[8]

Ce qu'il faut vérifier

• Confirmez que le nom de la fonction dans l'URL correspond exactement au nom affiché dans la liste des fonctions — une seule différence de caractère retournera une erreur 404. ^[1]
• Vérifiez que la clé output dans la réponse contient la valeur de retour attendue avant de construire une logique en aval qui en dépend. ^[5]
• Assurez-vous que la connexion OAuth référencée dans le paramètre connection de invokeurl est active et n'a pas expiré ou été révoquée. ^[7]