Solucionar error de flujo de trabajo de Zoho CRM a Zoho Projects {"code":6831}

Este error aparece cuando una solicitud de Zoho CRM a Zoho Projects incluye un valor de parámetro que es más largo de lo que la API de Projects permite. La API devuelve el código 6831 con el mensaje "Input Parameter Exceeds Maximum Length" (El parámetro de entrada excede la longitud máxima) cuando uno o más campos superan sus límites de caracteres permitidos ^[5].

Qué significa

Zoho Projects validó un campo entrante y rechazó la solicitud porque la longitud de la cadena de un parámetro superó el límite del servicio. Esto ocurre comúnmente cuando CRM intenta crear o actualizar una tarea, nota o descripción de Proyecto a través de la API de Projects (por ejemplo, desde una automatización, función personalizada o integración) y un campo —a menudo las notas o la descripción— excede el máximo de caracteres de Projects para ese parámetro ^[5].

Causas comunes

• Notas o descripciones de tareas largas enviadas desde flujos de trabajo o funciones de CRM (el campo de notas es frecuentemente el culpable) ^[5].
• Un campo de CRM (texto enriquecido o texto largo) mapeado directamente a un parámetro de Projects sin truncamiento o validación ^[5].
• Pushes automatizados desde CRM (regla de flujo de trabajo, función personalizada o conector de terceros) que concatenan múltiples campos y exceden los límites de longitud ^[5].
• La falta de detalles del error en la respuesta hace que no esté claro qué campo exacto excedió el límite, por lo que los clientes reintentan con datos sin cambios y siguen recibiendo el error 6831 ^[5].

Cómo solucionarlo

1. Reproducir la solicitud fallida: captura el payload exacto que tu automatización o función de CRM envía a Zoho Projects (usa los registros de la función, las herramientas de desarrollador del navegador o los registros de tu middleware).
2. Inspeccionar campos de cadena: verifica las notas, la descripción, el título y los campos de texto personalizados en el payload para ver la longitud. Presta especial atención a los valores concatenados (comentarios + metadatos). Este error apunta más comúnmente al campo de notas ^[5].
3. Truncar o validar antes de enviar: agrega un paso de truncamiento o validación en el flujo de trabajo de CRM o la función personalizada. Por ejemplo, usa substring(notes, 0, 4000) o rechaza la operación con un error visible para el usuario si el contenido debe permanecer intacto. Elige un límite exacto basado en el parámetro de la API de Projects que uses (los campos de notas/descripción suelen tener límites más bajos que los títulos).
4. Si necesitas conservar el texto completo, almacena el contenido completo en CRM o WorkDrive y envía solo un resumen corto a Projects; incluye un enlace al registro completo. Considera también adjuntar el texto completo como un archivo en lugar de como una nota de tarea.
5. Probar la solución: reenvía el payload truncado/validado para confirmar que el error 6831 ya no aparece. Registra el payload reducido y la respuesta para depuraciones futuras.

Cuándo escalar

Si no puedes localizar el campo ofensivo en el payload de la solicitud, o si el truncamiento de candidatos obvios todavía devuelve 6831, recopila la solicitud fallida, las marcas de tiempo y los registros, y abre un ticket de soporte con el soporte de Zoho Projects para que puedan inspeccionar la validación del lado del servidor y decirte el parámetro exacto y su longitud permitida ^[5].