Un utente tenta di rimuovere un allegato da un record CRM ma il file rimane sul record o la chiamata API fallisce; questo solitamente deriva da permessi, dall'allegato che risiede in un posto diverso (allegati email vs record), o da una sincronizzazione/integrazione che ricrea il file.
Cosa significa — spiegazione concreta legata alla superficie API di Zoho
Quando elimini un allegato in Zoho CRM, stai rimuovendo un file collegato all'oggetto Allegati/Note di un record; gli allegati email e i file archiviati dalle integrazioni (ad esempio, Campaigns, Mail o sincronizzazioni di terze parti) potrebbero non trovarsi nello stesso spazio di archiviazione e non verranno rimossi dalla stessa chiamata API[2][8]. L'eliminazione può anche essere bloccata da impostazioni utente o amministrative che impediscono la modifica dei record o da integrazioni che ricreano o risincronizzano i file quando viene eseguita una sincronizzazione periodica[5][6].
Cause comuni
- Il file è un allegato email in Zoho Mail o collegato tramite il componente aggiuntivo Mail; l'eliminazione dall'interfaccia utente/API di CRM non rimuoverà l'allegato email originale[2].
- L'integrazione o la sincronizzazione ricrea l'allegato alla prossima esecuzione (comportamento di Campaigns/sincronizzazione periodica)[5][8].
- L'account o il token API non dispone dei permessi di eliminazione per il modulo o per l'endpoint Allegati (ruolo utente, profilo o ambito OAuth)[6].
- L'allegato è archiviato come record correlato (Note, Allegati o in un campo file personalizzato) e la tua richiesta è rivolta all'endpoint o all'ID record errato[8].
- Il file è più grande dei limiti o in uso da un altro processo; l'API restituisce un errore o va in timeout.
Come risolvere
- Conferma dove si trova il file. Apri il record CRM e controlla gli Elenchi Correlati: Allegati, Note, Email. Se appare sotto Email, rimuovilo da Zoho Mail/Gadget o scollega l'email piuttosto che utilizzare l'endpoint Allegati[2][8].
- Controlla le impostazioni di integrazione/sincronizzazione. Se è configurata una sincronizzazione Campaigns/periodica o un connettore di terze parti, disabilita temporaneamente tale sincronizzazione o metti in pausa la mappatura e poi elimina il file in modo che non venga ricreato dal prossimo ciclo di sincronizzazione[5][8].
- Verifica i permessi utente e API. In Impostazioni CRM > Utenti e Controllo > Profili, assicurati che l'utente/profilo abbia il permesso di eliminare allegati su quel modulo. Per le chiamate API, conferma che gli ambiti OAuth includano ZohoCRM.modules.ALL e gli ambiti che consentono le eliminazioni, o utilizza un token amministratore[6].
- Utilizza l'endpoint API e gli ID corretti. Per gli allegati dei record CRM, chiama l'API Allegati con recordId e attachmentId; per le note o i campi file utilizza rispettivamente gli endpoint Note o File. Conferma gli ID dall'Elenchi Correlati dell'interfaccia utente CRM o dall'API Record prima di eliminare.
- Riprova e controlla i log. Effettua la chiamata di eliminazione, quindi conferma tramite GET nell'elenco Allegati del record. Se il file riappare, ricontrolla il passaggio 2 per una sincronizzazione attiva o un webhook che lo ricrea.
Quando escalare
Se hai confermato il tipo di file e utilizzato la corretta API/endpoint con permessi adeguati ma l'allegato riappare ancora o l'API di eliminazione restituisce un errore non descrittivo, apri un ticket con il Supporto Zoho includendo: recordId, attachmentId, modulo interessato, richiesta/risposta API esatta (senza segreti) e l'ora in cui si è verificato il problema in modo che il supporto possa tracciare la sincronizzazione/webhook o la replica backend.