Comment récupérer les connecteurs dans Zoho CRM

Récupérer les connecteurs dans Zoho CRM signifie accéder aux liens d'authentification qui permettent à votre compte CRM de communiquer avec des services tiers — et comprendre comment les référencer correctement dans vos fonctions Deluge.

Pourquoi c'est important

Les connecteurs (également appelés Connexions) servent de pont d'authentification entre Zoho CRM et les applications externes. Lorsque vous créez une fonction qui appelle un service externe, vous devez connaître le nom du lien du connecteur et son statut actuel avant de pouvoir l'invoquer de manière fiable. ^[8] Que vous récupériez des données de campagne depuis MailChimp ou que vous interrogiez une API REST externe, le connecteur doit être configuré et récupérable avant que tout code d'intégration puisse fonctionner. ^[1]

> Remarque : Beam Help est un support expert indépendant pour Zoho — nous ne sommes pas le support officiel de Zoho.

---

Étape par étape

Étape 1. Connectez-vous à votre compte Zoho CRM et accédez à Configuration. Depuis là, localisez la section Espace développeur (ou Hub développeur) dans le menu de gauche. C'est ici que réside toute la configuration des connecteurs et des fonctions. ^[1]

Étape 2. Dans l'espace développeur, sélectionnez Connexions (parfois intitulé Connecteurs selon votre version du CRM). Cette section liste chaque lien d'authentification déjà créé par votre organisation, ainsi que son statut actuel. ^[8]

Étape 3. Dans la liste des connexions, localisez le connecteur que vous souhaitez récupérer. Chaque entrée affiche trois informations clés : le Nom du lien, le Nom du service (l'application tierce contre laquelle il s'authentifie) et le Statut de la connexion (active ou inactive). ^[1]

Étape 4. Cliquez sur un connecteur spécifique pour ouvrir sa vue détaillée. Vous y trouverez l'extrait de code généré automatiquement qui vous montre exactement comment référencer ce connecteur dans une fonction Deluge. Le champ Connection dans cet extrait correspond directement au nom du lien que vous avez vu dans la liste. ^[1]

Étape 5. Copiez le nom du lien depuis la vue détaillée. Cette chaîne est ce que vous passerez en tant que paramètre connection chaque fois que vous utiliserez une tâche Invoke URL dans une fonction Deluge pour appeler le service tiers. ^[1]

Étape 6. Si vous avez besoin que le connecteur soit utilisé comme source pour la fonctionnalité Requêtes, accédez à Configuration → Espace développeur → Requêtes, puis ajoutez une nouvelle source API REST. Dans ce formulaire, vous pouvez spécifier l'URL de base, les paramètres par défaut, les en-têtes et — point crucial — sélectionner la connexion (connecteur) existante depuis une liste déroulante pour authentifier la requête. ^[7]

Étape 7. Pour vérifier que le connecteur fonctionne de bout en bout, référencez-le dans une fonction de test à l'aide de la tâche Invoke URL. L'éditeur de fonctions vous affichera le nom du lien de connexion en contexte, et vous pourrez exécuter un appel de test pour confirmer que le service tiers répond comme prévu. ^[1]

---

Erreurs courantes

• Casse incorrecte du nom du lien : Le nom du lien est sensible à la casse lorsqu'il est référencé dans le code Deluge. Copiez-le exactement tel qu'il apparaît sur la page de détail du connecteur — ne le retapez pas manuellement. ^[1]

• Statut inactif : Si le statut du connecteur apparaît comme inactif ou expiré, le jeton d'authentification a peut-être expiré. Vous devrez réautoriser la connexion avant que toute fonction la référençant puisse réussir. ^[8]

• Domaines de confiance manquants pour les sources de base de données : Si vous utilisez la fonctionnalité Requêtes avec un connecteur API REST et que l'hôte n'est pas au format d'adresse IP, vous devez l'ajouter aux Domaines de confiance dans les paramètres de votre CRM, et mettre en liste blanche les adresses IP de Zoho CRM côté serveur relais. Ignorer cette étape provoquera des délais d'expiration de connexion même lorsque le connecteur lui-même semble actif. ^[7]

• Portée du connecteur vs portée de la fonction : Les connexions peuvent être invoquées depuis des fonctions et des widgets, mais le connecteur doit avoir reçu les portées OAuth correctes pour le service tiers au moment de sa création. Récupérer un connecteur configuré avec des portées insuffisantes entraînera des erreurs d'autorisation à l'exécution, et non au stade de la récupération. ^[8]

---

Ce qu'il faut vérifier

• Le nom du lien est exact : Confirmez que le nom du lien copié depuis la vue détaillée du connecteur correspond caractère par caractère à ce qui apparaît dans le paramètre connection de votre fonction Deluge. ^[1]
• Le statut est actif : Dans la liste des connexions, vérifiez que la colonne de statut du connecteur affiche un état actif/connecté avant de déployer toute fonction qui en dépend. ^[1]
• La source est configurée pour les Requêtes (le cas échéant) : Si vous utilisez le connecteur comme source API REST dans la fonctionnalité Requêtes, confirmez que l'URL de base, les en-têtes et la référence de connexion sont tous correctement renseignés dans la configuration de la source. ^[7]