Cette erreur survient lorsque les points de terminaison de pipeline du module Deals renvoient un code 204 No Content ou un objet pipeline null, même si le CRM affiche le pipeline par défaut (Standard) dans l'interface utilisateur. L'API ne commence à renvoyer des données de pipeline qu'après la création d'au moins un pipeline personnalisé, ce qui perturbe les intégrations qui s'attendent à un enregistrement de pipeline pour chaque compte [1].
Ce que cela signifie
Lorsque vous appelez les points de terminaison de pipeline de Zoho CRM pour les Deals et recevez un code 204 No Content ou un pipeline null, l'API n'expose pas le pipeline Standard intégré si aucun pipeline personnalisé n'existe dans le compte. La page Gérer les pipelines sous Paramètres CRM peut ne montrer aucun pipeline configuré, et pourtant le pipeline Standard existe toujours dans l'interface utilisateur ; la réponse de l'API l'omet jusqu'à ce qu'un pipeline personnalisé soit ajouté [1].
Causes courantes
- Un comportement/bug de la plateforme où l'API omet le pipeline Standard par défaut à moins qu'un pipeline personnalisé n'existe [1].
- Le compte n'a réellement aucun pipeline personnalisé configuré, déclenchant la réponse 204 alors que l'interface utilisateur affiche toujours le pipeline Standard implicite [1].
- L'absence de la portée des paramètres de pipeline dans le jeton API peut empêcher le retour des données de pipeline — vérifiez que vos portées OAuth incluent la portée des paramètres de pipeline si elle est utilisée [2].
- Le code d'intégration traite le code 204 comme une erreur stricte au lieu d'un état signifiant "seul le pipeline par défaut est présent", ce qui entraîne des échecs en aval [1].
Comment résoudre le problème
- Ajoutez un pipeline personnalisé dans le compte comme solution de contournement à court terme : ouvrez Paramètres CRM > Configuration > Gérer les pipelines (Pipelines) et créez n'importe quel pipeline personnalisé. L'API renverra alors le pipeline Standard plus le nouveau pipeline personnalisé, restaurant les données attendues pour les intégrations [1].
- Mettez à jour votre intégration pour gérer le code 204 No Content avec souplesse : lorsque le point de terminaison de pipeline renvoie 204, revenez à considérer que le compte utilise le pipeline Standard (utilisez les valeurs du champ Étape des Deals et votre mappage par défaut connu). Cela évite de bloquer le traitement lorsqu'aucun objet pipeline n'est renvoyé [1].
- Si vous avez besoin des identifiants de pipeline par programmation, créez un pipeline personnalisé minimal via l'API ou l'interface utilisateur pour forcer l'API à renvoyer des objets pipeline ; capturez les identifiants de pipeline renvoyés pour une utilisation future [1].
- Si vous ne pouvez pas créer de pipelines personnalisés dans les comptes clients, ajoutez une détection robuste : en cas de 204 des points de terminaison de pipeline, interrogez les enregistrements Deals pour obtenir les valeurs d'étape afin de reconstruire les listes de pipelines/étapes attendues et poursuivez sans les identifiants de pipeline. Implémentez des tentatives et enregistrez l'occurrence du 204 pour une analyse ultérieure [1].
- Collectez les journaux et ouvrez un ticket de support si vous avez besoin d'une correction permanente de la plateforme : incluez les paires de requêtes/réponses API, les horodatages, l'ID de l'organisation et une séquence reproductible (aucun pipeline personnalisé -> 204 ; ajout d'un pipeline personnalisé -> les objets pipeline apparaissent) afin que le support puisse escalader le comportement backend [1].
Quand escalader
Escaladez vers le support Zoho lorsque votre intégration ne peut pas fonctionner sans les identifiants de pipeline et que la création d'un pipeline personnalisé n'est pas une option, ou lorsque le comportement 204 se produit de manière incohérente entre les comptes malgré des configurations identiques — incluez les journaux API et l'ID de l'organisation pour une résolution la plus rapide [1].