Corriger l'erreur de workflow Zoho CRM vers Zoho Projects {"code":6831}

Cette erreur apparaît lorsqu'une requête de Zoho CRM vers Zoho Projects inclut une valeur de paramètre dont la longueur dépasse celle autorisée par l'API Projects. L'API renvoie le code 6831 avec le message "Input Parameter Exceeds Maximum Length" (Le paramètre d'entrée dépasse la longueur maximale) lorsque un ou plusieurs champs dépassent leurs limites de caractères autorisées ^[5].

Ce que cela signifie

Zoho Projects a validé un champ entrant et a rejeté la requête car la longueur de la chaîne d'un paramètre a dépassé la limite du service. Cela se produit couramment lorsque CRM tente de créer ou de mettre à jour une tâche, une note ou une description de Projet via l'API Projects (par exemple, à partir d'une automatisation, d'une fonction personnalisée ou d'une intégration) et qu'un champ — souvent les notes ou la description — dépasse le nombre maximum de caractères autorisés par Projects pour ce paramètre ^[5].

Causes courantes

• De longues notes ou descriptions de tâches envoyées depuis les workflows ou les fonctions CRM (le champ notes est souvent le coupable) ^[5].
• Un champ CRM (texte enrichi ou texte long) mappé directement à un paramètre Projects sans troncature ni validation ^[5].
• Des envois automatisés depuis CRM (règle de workflow, fonction personnalisée ou connecteur tiers) qui concatènent plusieurs champs et dépassent les limites de longueur ^[5].
• Le manque de détails d'erreur dans la réponse ne permet pas de savoir quel champ exact a dépassé la limite, ce qui amène les clients à réessayer avec des données inchangées et à continuer de recevoir le code 6831 ^[5].

Comment le corriger

1. Reproduire la requête défaillante : capturez la charge utile exacte que votre automatisation ou fonction CRM envoie à Zoho Projects (utilisez les journaux de fonctions, les outils de développement du navigateur ou les journaux de votre middleware).
2. Inspecter les champs de chaîne : vérifiez la longueur des notes, de la description, du titre et des champs de texte personnalisés dans la charge utile. Portez une attention particulière aux valeurs concaténées (commentaires + métadonnées). Cette erreur pointe le plus souvent vers le champ notes ^[5].
3. Tronquer ou valider avant l'envoi : ajoutez une étape de troncature ou de validation dans le workflow CRM ou la fonction personnalisée. Par exemple, utilisez substring(notes, 0, 4000) ou rejetez l'opération avec une erreur visible par l'utilisateur si le contenu doit rester intact. Choisissez une limite exacte basée sur le paramètre de l'API Projects que vous utilisez (les champs notes/description ont généralement des limites inférieures à celles des titres).
4. Si vous avez besoin de préserver le texte intégral, stockez le contenu complet dans CRM ou WorkDrive et envoyez uniquement un bref résumé à Projects ; incluez un lien vers l'enregistrement complet. Envisagez également de joindre le texte intégral sous forme de fichier plutôt que comme note de tâche.
5. Tester la correction : renvoyez la charge utile tronquée/validée pour confirmer que l'erreur 6831 n'apparaît plus. Enregistrez la charge utile réduite et la réponse pour le débogage futur.

Quand escalader

Si vous ne parvenez pas à localiser le champ fautif dans la charge utile de la requête, ou si la troncature des candidats évidents renvoie toujours le code 6831, rassemblez la requête défaillante, les horodatages et les journaux, puis ouvrez un ticket de support auprès du support Zoho Projects afin qu'ils puissent inspecter la validation côté serveur et vous indiquer le paramètre exact et sa longueur autorisée ^[5].