Cette erreur apparaît lorsque l'appel API de Zoho CRM/produit Zoho associé, qui devrait signaler les échecs de fonctions personnalisées, renvoie à la place un code HTTP 204 (Pas de contenu) ou un corps 200 vide, alors que l'interface utilisateur de Zoho affiche toujours les fonctions échouées. La surface API n'a actuellement aucun point de terminaison "function-failures" documenté, de sorte que le client voit "aucun échec" même si la vue Échecs du produit liste de vraies erreurs.[1]
Ce que cela signifie — explication concrète liée à la surface API de Zoho
L'API publique du produit n'expose pas le même rapport d'échecs de fonctions que celui utilisé par l'interface utilisateur ; les appelants des points de terminaison tentés atteignent soit une route non documentée, soit un point de terminaison qui renvoie intentionnellement 204/200 vide lorsqu'aucun flux d'échec au niveau de l'API n'existe. Cette inadéquation produit une réponse API vide même lorsque l'interface utilisateur contient des entrées pour les échecs de fonctions personnalisées ou les erreurs de scripts de workflow.[1]
Causes courantes
- Vous avez appelé un point de terminaison non documenté ou non pris en charge (aucune API officielle de "function-failures" n'existe dans la référence).[ ^1]
- Vous avez interrogé le mauvais produit ou point de terminaison de centre de données (DC) et avez atteint une route qui renvoie 204 pour les requêtes inter-DC ou non concordantes.[1]
- Votre jeton d'accès ou votre portée manque des droits pour visualiser l'automatisation ou les fonctions, ce qui amène l'API à supprimer les résultats.[1]
- Vous avez tenté de réutiliser un chemin "webhook-failures" ; les "webhook-failures" sont documentés mais ne signalent pas les échecs de fonctions personnalisées.[1]
Comment résoudre le problème
- Confirmez la référence API : consultez la documentation API officielle de Zoho pour votre produit et votre DC afin de vérifier si un point de terminaison "function-failures" est disponible. Si aucun point de terminaison n'est documenté, prévoyez d'utiliser l'interface utilisateur ou les journaux de l'application à la place.[1]
- Utilisez la vue Échecs de l'interface utilisateur pour un triage immédiat : ouvrez Zoho CRM (ou le produit qui exécute les fonctions) > Configuration > Automatisation > Fonctions/Échecs pour voir et réexécuter les fonctions échouées. Copiez les horodatages et les noms de fonctions pour l'audit.[1]
- Si vous devez automatiser : instrumentez vos fonctions pour enregistrer les échecs dans un magasin consultable (Zoho Analytics, un webhook personnalisé ou un service de journalisation externe) lorsqu'elles interceptent des exceptions. Cela vous donne un flux d'échecs accessible via API, indépendant du visualiseur d'échecs interne du produit.
- Vérifiez les portées OAuth et le DC : confirmez que le client OAuth utilise des portées qui permettent la lecture des métadonnées d'automatisation/de fonction et que votre URL de base de l'API correspond au DC de l'organisation. Réessayez après avoir corrigé les portées ou l'URL de base.[1]
- Collectez des preuves et reproduisez : capturez la requête/réponse API (en-têtes, URL, corps, statut HTTP), la ligne d'échec de l'interface utilisateur (nom de la fonction, heure, message d'erreur) et le DC du compte. Préparez ces éléments avant de contacter le support Zoho.[1]
Quand escalader
Ouvrez un ticket de support Zoho lorsque vous pouvez reproduire l'inadéquation avec les journaux de requêtes et la capture d'écran de l'interface utilisateur ; incluez les horodatages, les vidages de requêtes/réponses et le compte/DC affecté. Escaladez si cela bloque la récupération de l'automatisation ou si vous avez besoin d'une API officielle pour la surveillance des échecs au-delà des vérifications manuelles de l'interface utilisateur.