Résolution des problèmes du Developer Hub dans Zoho CRM

Résolution des problèmes du Developer Hub dans Zoho CRM

Cette page a été traduite à l'aide d'outils d'IA et peut contenir des erreurs. Pour obtenir les informations les plus précises et les plus récentes, veuillez consulter la version originale en anglais.

API et SDK

Une erreur « NO_CRM_ACCOUNT » s'affiche lors de la génération du jeton d'accès.

Vérifiez si le code OAuth utilisé a été généré avant une reconstruction de la sandbox. Le cas échéant, la reconstruction de la sandbox invalide l'ancien code, car elle est considérée comme la création d'une nouvelle organisation ; un nouveau jeton devra alors être généré pour la suite du traitement. Contactez l'assistance si vous rencontrez le moindre problème.


Une erreur « Invalid_Code » se produit lors de la génération du jeton d'accès.

Cette erreur peut être due à l'utilisation d'un centre de données (DC) incorrect lors de la génération du jeton. Assurez-vous que le domaine utilisé correspond bien à votre centre de données (par exemple : accounts.zoho.com, zoho.eu, zoho.in, etc.). L'utilisation d'un DC incorrect entraîne une erreur de code invalide.

Cette erreur peut également provenir de la réutilisation d'un ancien code d'autorisation. Les codes d'autorisation (grant tokens) générés via la Developer Console sont à usage unique et valables 10 minutes au maximum. Si le code est réutilisé ou a expiré, la demande de jeton échouera avec une erreur « invalid_code ».

Impossible de retrouver l'identité de l'utilisateur associé à une nouvelle clé API régénérée.

Contactez l'assistance en indiquant le nom de la fonction, une capture d'écran de la clé API actuelle et l'heure approximative à laquelle elle a fonctionné pour la dernière fois ou à laquelle le changement a été constaté, afin d'obtenir de l'aide.


Les enregistrements sont créés via l'API sans les champs obligatoires personnalisés.

Vérifiez que les informations requises, telles que la mise en page correcte et tous les identifiants de champs obligatoires, sont bien incluses dans le corps de la requête API. Si, après vérification, le problème persiste, contactez l'assistance pour obtenir de l'aide. Consultez cette page pour votre référence.

Lors d'appels API Get record/Search, une erreur 204 est renvoyée avec une réponse vide.

Si vous tentez de récupérer un enregistrement immédiatement après sa création, il peut ne pas être disponible pendant quelques secondes le temps de sa propagation. Vérifiez également si l'enregistrement a été converti. Dans ce cas, vous devrez transmettre le paramètre « converted » avec la valeur « Both » afin d'inclure également les enregistrements convertis dans la recherche.

Impossible de charger la page des crédits API après réception d'une alerte « API limit exhausted ».

Contactez l'assistance via une session en direct ou écrivez-nous à support@zohocrm.com.

Lors d'un appel API en masse, une erreur « File not supported » s'affiche.

Assurez-vous que le fichier ZIP ne contient pas plus d'un fichier CSV, ni de fichiers masqués, d'identifiants de fichiers dupliqués réutilisés, de fichiers volumineux ou de fichiers contenant des caractères spéciaux. Après ces vérifications, si le problème persiste, contactez l'assistance pour obtenir de l'aide.

Une erreur OAUTH_MISMATCH_ERROR se produit lors d'une requête API.

Vérifiez que le paramètre de portée (scope) est bien inclus dans l'URL d'autorisation utilisée pour générer le jeton d'accès, et assurez-vous que les mêmes portées sont utilisées lors de la génération du grant token, ainsi que les portées requises pour les appels API concernés. Si le problème persiste, contactez l'assistance pour obtenir de l'aide.

Une erreur « RECORD_IN_BLUEPRINT » s'affiche lors d'une tentative de mise à jour d'un enregistrement via l'API.

Cette erreur se produit lorsque l'enregistrement est actuellement engagé dans un processus Blueprint. Si vous devez néanmoins mettre à jour des enregistrements, utilisez l'API Blueprint Transition pour faire progresser l'enregistrement vers l'état suivant conformément au Blueprint configuré, afin de permettre la mise à jour sans enfreindre les contraintes du Blueprint. Vérifiez et contactez l'assistance si vous avez encore des questions.

Une erreur « TOO_MANY_REQUESTS » s'affiche lors d'appels API.

Cette erreur se produit lorsque vos requêtes dépassent l'une des limites API de Zoho CRM. Il s'agit le plus souvent de la limite de simultanéité (trop de requêtes simultanées ou ouvertes), mais cela peut également concerner la limite journalière de crédits/requêtes ou une limite de débit à court terme. Zoho applique ces limites afin de protéger les performances et la fiabilité du système. Vérifiez votre utilisation de l'API, réduisez le nombre de requêtes simultanées, regroupez les données autant que possible et mettez en place une logique de réessai avec interruption exponentielle. Consultez ce lien pour en savoir plus sur les limites API de Zoho CRM. Contactez l'assistance si vous avez besoin d'aide.


Impossible de créer un jeton d'actualisation lors de la génération du jeton d'accès.

Le flux d'autorisation OAuth ne renvoie pas de jeton d'actualisation lorsqu'il est défini sur « online ». Utilisez access_type=offline et prompt=consent dans l'URL d'autorisation pour obtenir un jeton d'actualisation, qui sera renvoyé dès le premier consentement. Assurez-vous que l'URI de redirection correspond exactement à l'entrée de la Developer Console, et conservez le jeton d'actualisation en lieu sûr. Si vous rencontrez un problème, contactez l'assistance pour obtenir de l'aide.

Lors de l'utilisation de l'opérateur « equals » dans un appel à l'API Search de Zoho CRM, des correspondances partielles sont renvoyées.

L'opérateur equals de l'API Search peut renvoyer des résultats allant au-delà des correspondances exactes dans certains cas, notamment lorsque plusieurs conditions sont combinées ou lorsqu'une valeur de champ sur une seule ligne contient des caractères spéciaux ; des enregistrements similaires ou partiellement correspondants peuvent alors être retournés. Pour des résultats de correspondance exacte fiables, utilisez l'API COQL avec le comparateur =.

Impossible d'effectuer une exécution parallèle avec l'API Bulk.

Les appels multiples à l'API Bulk ne prennent pas en charge l'exécution parallèle. Un seul traitement en masse est effectué à la fois, par module et par utilisateur. Ne démarrez une nouvelle opération en masse (import, export ou mise à jour) qu'après l'achèvement ou le rejet du traitement précédent ; cela permettra de poursuivre le traitement. Une fois la requête précédente terminée ou rejetée, la suivante pourra être traitée.


Widgets

Impossible de créer un widget personnalisé pour le portail client.

Les widgets ne sont pas pris en charge pour le portail client.

Lors de l'accès à un widget configuré en tant que WebTab, une erreur « Page not found » s'affiche.

Suivez les étapes décrites ici, puis empaquetez le code en conséquence. Si le problème persiste, contactez l'assistance pour obtenir de l'aide.


Client Script

ZDK.Apps n'est pas visible dans l'environnement Client Script.

Dans les modules nouvellement créés, ZDK.Apps peut ne pas être disponible dans l'environnement Client Script. Les références telles que ZDK.Apps.CRM.<ModuleName> ne sont alors pas reconnues, ce qui entraîne l'échec ou le comportement inattendu des références de module et des méthodes associées. L'activation de la clé ZDK depuis le backend résout ce problème. Contactez l'assistance en ligne pour obtenir de l'aide.

Impossible de modifier les scripts client après la migration du centre de données (DC), avec le message : « The Client Script you are accessing is not available. »

Contactez l'assistance pour vous connecter en direct avec nos experts en développement et obtenir de l'aide.

Impossible d'inclure des bibliothèques externes telles que Node.js ou Crypto-JS dans les scripts client.

Actuellement, l'importation de bibliothèques externes ou l'utilisation de packages Node.js dans les scripts client Zoho ne sont pas pris en charge.

Un script client conçu pour masquer toutes les vues à l'exception de « My Contacts » continue d'afficher toutes les vues dans la vue Kanban.

Ce comportement est connu. Actuellement, la restriction n'est pas appliquée dans la vue Kanban. La demande est en cours d'évaluation et pourra être intégrée dans une prochaine mise à jour.

Impossible d'écrire un script client pour le module New Team.

Actuellement, les scripts client pour le module Teams de Zoho CRM ne sont pas pris en charge, mais des travaux sont en cours. Une fois l'analyse terminée, les mises à jour seront communiquées.

L'un des scripts client créés pour l'événement OnBeforeUpdate sur le champ Stage ne fonctionne pas comme prévu.

Lorsqu'un script client est configuré pour se déclencher sur « OnBeforeUpdate » pour le champ « Stage », il est censé empêcher la modification du champ « Stage » vers « Closed Lost » en affichant une alerte et en renvoyant false. Nous comprenons que le comportement attendu consiste à déclencher le script uniquement après que l'utilisateur a enregistré la modification (via la coche bleue). Cependant, le comportement actuel est tel que le script se déclenche immédiatement lorsque l'utilisateur sélectionne Closed Lost, avant même l'enregistrement.

Le champ Stage étant traité différemment des autres champs, la prise en charge de certains événements de script client n'est pas encore implémentée. En guise de solution de contournement, nous vous suggérons de configurer le script client en utilisant l'événement « OnMandatoryFormLoad » pour les étapes « Closed Won/Lost ».
Nous travaillons à corriger ce comportement ; les améliorations correspondantes seront disponibles dans de prochaines versions.