Un usuario intenta eliminar un archivo adjunto de un registro de CRM, pero el archivo permanece en el registro o la llamada a la API falla; esto suele deberse a permisos, a que el archivo adjunto se encuentra en un lugar diferente (adjuntos de correo electrónico vs. adjuntos de registro) o a que una sincronización/integración recrea el archivo.
Qué significa — explicación concreta vinculada a la superficie de la API de Zoho
Cuando eliminas un archivo adjunto en Zoho CRM, estás eliminando un archivo vinculado al objeto de Adjuntos/Notas de un registro; los archivos adjuntos de correo electrónico y los archivos almacenados por integraciones (por ejemplo, Campaigns, Mail o sincronizaciones de terceros) pueden no estar en el mismo almacenamiento y no se eliminarán con la misma llamada a la API[2][8]. La eliminación también puede ser bloqueada por configuraciones de usuario o administrador que impiden la modificación de registros o por integraciones que recrean o resincronizan archivos cuando se ejecuta una sincronización periódica[5][6].
Causas comunes
- El archivo es un adjunto de correo electrónico en Zoho Mail o está vinculado a través del complemento de Mail; eliminarlo desde la interfaz de usuario/API de CRM no eliminará el adjunto de correo electrónico original[2].
- La integración o sincronización recrea el archivo adjunto en la próxima ejecución (comportamiento de Campaigns/sincronización periódica)[5][8].
- La cuenta o el token de API carecen de permisos de eliminación para el módulo o el punto final de Adjuntos (rol de usuario, perfil o ámbito de OAuth)[6].
- El archivo adjunto se almacena como un registro relacionado (Notas, Adjuntos o en un campo de archivo personalizado) y tu solicitud se dirige al punto final o ID de registro incorrecto[8].
- El archivo es más grande que los límites o está en uso por otro proceso; la API devuelve un error o se agota el tiempo de espera.
Cómo solucionarlo
- Confirma dónde se encuentra el archivo. Abre el registro de CRM y revisa las Listas Relacionadas: Adjuntos, Notas, Correos electrónicos. Si aparece en Correos electrónicos, elimínalo de Zoho Mail/Gadget o desvincula el correo electrónico en lugar de usar el punto final de Adjuntos[2][8].
- Comprueba la configuración de integración/sincronización. Si hay configurada una sincronización de Campaigns/periódica o un conector de terceros, deshabilita temporalmente esa sincronización o pausa el mapeo y luego elimina el archivo para que no se recree en el próximo ciclo de sincronización[5][8].
- Verifica los permisos del usuario y de la API. En Configuración de CRM > Usuarios y Control > Perfiles, asegúrate de que el usuario/perfil tenga permiso para eliminar adjuntos en ese módulo. Para las llamadas a la API, confirma que los ámbitos de OAuth incluyan ZohoCRM.modules.ALL y los ámbitos que permitan eliminaciones, o utiliza un token de administrador[6].
- Usa el punto final y los ID de API correctos. Para los adjuntos de registros de CRM, llama a la API de Adjuntos con el ID del registro y el ID del adjunto; para notas o campos de archivo, utiliza los puntos finales de Notas o Archivos respectivamente. Confirma los ID desde la Lista Relacionada de la interfaz de usuario de CRM o la API de Registros antes de eliminar.
- Vuelve a intentarlo y revisa los registros. Realiza la llamada de eliminación, luego confirma mediante GET en la lista de Adjuntos del registro. Si el archivo reaparece, vuelve a comprobar el paso 2 para ver si una sincronización activa o un webhook lo están recreando.
Cuándo escalar
Si confirmaste el tipo de archivo y utilizaste la API/puntos finales correctos con permisos adecuados, pero el archivo adjunto aún reaparece o la API de eliminación devuelve un error no descriptivo, abre un ticket con Soporte de Zoho incluyendo: ID del registro, ID del adjunto, módulo afectado, solicitud/respuesta exacta de la API (sin secretos) y la hora en que ocurrió el problema para que el soporte pueda rastrear la sincronización/webhook o la replicación en segundo plano.