Come eliminare una vista in Zoho Desk

Eliminare una vista in Zoho Desk è semplice tramite API: invia una richiesta DELETE all'endpoint delle viste con l'ID della vista desiderata e Zoho Desk la rimuoverà in modo permanente.

Perché è importante

Le viste personalizzate aiutano gli agenti a filtrare e dare priorità ai ticket, ma nel tempo le viste obsolete o ridondanti ingombrano l'interfaccia. Che tu stia eseguendo una pulizia periodica, dismettendo un flusso di lavoro o automatizzando la gestione del ciclo di vita delle viste tramite uno script, conoscere la chiamata API corretta fa risparmiare tempo ed evita ricerche manuali nell'interfaccia. Ciò è particolarmente utile quando si gestiscono viste su larga scala in più reparti.

Procedura passo dopo passo

Passaggio 1. Verifica di avere gli scope OAuth corretti configurati per la tua integrazione con Zoho Desk. Come minimo, il tuo token deve includere Desk.settings.DELETE (e idealmente lo scope completo Desk.settings.ALL) per autorizzare operazioni distruttive sulle risorse di impostazioni come le viste. ^[2]

Passaggio 2. Recupera il view_id della vista che desideri rimuovere. Puoi ottenerlo elencando le viste tramite l'API di Zoho Desk in anticipo, oppure ispezionando l'URL della vista nell'interfaccia di Zoho Desk. Tieni questo ID a portata di mano — è un parametro di percorso obbligatorio. ^[1]

Passaggio 3. Costruisci la tua richiesta DELETE puntando all'endpoint /api/v1/views/{viewid}, sostituendo {viewid} con l'identificatore effettivo recuperato nel passaggio precedente. Non è richiesto alcun corpo della richiesta; l'ID della vista nel percorso è sufficiente per identificare la risorsa. ^[1]

Passaggio 4. Invia la richiesta. Utilizzando Python, la chiamata si presenta così (parafrasata dall'implementazione sottostante):

# Assuming `client` is your authenticated Zoho Desk API client
client.request("DELETE", f"/api/v1/views/{view_id}", None, None)

Una risposta positiva confermerà che la vista è stata eliminata. ^[1]

Passaggio 5. Se stai lavorando con le viste personalizzate di Zoho CRM anziché con le viste di Zoho Desk, tieni presente che l'endpoint è completamente diverso: DELETE /settings/custom_views/{vid}, e richiede un parametro module (ad es. "Leads", "Contacts") per identificare la vista del modulo da rimuovere. Non confondere questi due endpoint. ^[3]

---

> Beam Help è un servizio di supporto esperto indipendente per Zoho — non siamo il supporto ufficiale Zoho. Testa sempre le chiamate API distruttive in un ambiente sandbox o di staging prima di eseguirle sui dati di produzione.

---

Errori comuni

• Scope errato: Se il tuo token OAuth non include Desk.settings.DELETE o Desk.settings.ALL, l'API restituirà un errore di autorizzazione. Controlla attentamente l'elenco degli scope nella configurazione del tuo ambiente prima di eseguire il debug della richiesta stessa. ^[2]

• Confusione tra viste Desk e viste personalizzate CRM: L'endpoint di eliminazione delle viste di Zoho Desk (/api/v1/views/{viewid}) e l'endpoint delle viste personalizzate di Zoho CRM (/settings/customviews/{vid}) sono completamente separati. Utilizzare l'endpoint CRM con un ID vista Desk (o viceversa) restituirà un errore 404 o fallirà silenziosamente. ^[1][3]

• Eliminare un layout invece di una vista: Zoho Desk espone anche un endpoint DELETE /api/v1/layouts/{layoutId} per rimuovere i layout — un tipo di risorsa diverso. Verifica di puntare a un ID *vista* e non a un ID *layout* prima di eseguire la chiamata. ^[7]

• Azione irreversibile: L'eliminazione di una vista in Zoho Desk è permanente. Non esiste un cestino né un meccanismo di annullamento esposto tramite API. Verifica sempre il view_id prima di inviare la richiesta.

Cosa verificare

• Validazione dello scope: Conferma che il tuo token OAuth attivo includa Desk.settings.DELETE o Desk.settings.ALL e che il token non sia scaduto. ^[2]
• ID vista corretto: Verifica che il view_id che stai passando corrisponda effettivamente alla vista desiderata — elenca prima le viste e confronta prima di eliminare. ^[1]
• Conferma post-eliminazione: Dopo che la chiamata DELETE è andata a buon fine, prova a recuperare la vista tramite una richiesta GET per confermare che non esiste più e che non sia stata semplicemente disattivata. ^[1]