Come eliminare un team in Zoho Desk

L'eliminazione di un team in Zoho Desk tramite API richiede una singola richiesta DELETE autenticata che punta all'identificatore univoco del team specifico. Ecco tutto ciò che devi sapere per farlo in modo corretto e sicuro.

Perché è importante

I team in Zoho Desk aiutano a instradare i ticket e a organizzare gli agenti — ma nel tempo, team ridondanti o ristrutturati possono rendere la tua configurazione disordinata. Che tu stia automatizzando uno script di pulizia o costruendo un flusso di lavoro amministrativo, sapere come rimuovere un team in modo programmatico è essenziale per mantenere la configurazione di Zoho Desk in ordine. Questa guida illustra l'approccio tramite API, che è il metodo più affidabile per eliminazioni in blocco o automatizzate.

> Nota: Beam Help è una risorsa di supporto esperto indipendente — non il supporto ufficiale di Zoho.

---

Procedura passo dopo passo

Passaggio 1. Verifica che gli scope OAuth siano configurati correttamente.

Prima di effettuare qualsiasi chiamata API distruttiva, verifica che il client OAuth connesso includa le autorizzazioni necessarie per Zoho Desk. Le operazioni a livello di impostazioni — inclusa la gestione dei team — richiedono scope come Desk.settings.ALL o almeno Desk.settings.DELETE nella configurazione del token. ^[2]

Passaggio 2. Recupera il team_id che vuoi eliminare.

Avrai bisogno dell'identificatore univoco del team prima di inviare la richiesta di eliminazione. Se non lo hai già memorizzato, usa una richiesta GET sull'endpoint dei team per elencare tutti i team e annota il team_id di quello che vuoi rimuovere. Tieni questo valore a portata di mano per il passaggio successivo.

Passaggio 3. Invia la richiesta DELETE all'endpoint dei team.

Invia una richiesta HTTP DELETE autenticata al seguente endpoint, sostituendo il tuo identificatore di team effettivo al posto di {team_id}: ^[1]

DELETE /api/v1/teams/{team_id}

In Python, utilizzando il wrapper client di Zoho Desk, il codice è il seguente:

def delete_team(self, team_id: str, p: dict = None):
    return self.c.request("DELETE", f"/api/v1/teams/{team_id}", p, None)

Passa il team_id come argomento stringa. Il parametro opzionale p può contenere eventuali parametri di query aggiuntivi, se necessario. ^[1]

Passaggio 4. Gestisci la risposta dell'API.

Un'eliminazione riuscita restituirà un codice di stato HTTP di successo appropriato. Se la risposta indica un errore — come un 404 (team non trovato) o un 403 (autorizzazioni insufficienti) — torna ai Passaggi 1 e 2 per verificare la configurazione degli scope e la correttezza del team_id fornito. [^1, ^2]

---

Errori comuni

• Endpoint errato per gruppi vs. team. Zoho Desk dispone di un endpoint separato per eliminare i gruppi dell'Help Center (DELETE /api/v1/helpcenter/{helpcenterid}/groups/{groupid}), che è una risorsa completamente diversa da un team. Assicurati di puntare a /api/v1/teams/{team_id} e non a un endpoint di gruppi o reparti. ^[4]

• Scope OAuth mancanti o insufficienti. Se il token è stato generato senza Desk.settings.DELETE o Desk.settings.ALL, l'API rifiuterà la richiesta. Controlla l'elenco degli scope nella tua configurazione OAuth prima di cercare il problema altrove. ^[2]

• Confusione tra team e reparti. I reparti dispongono di un proprio set di endpoint (ad esempio, per dissociare agenti o rimuovere loghi). L'eliminazione di un team non influirà sull'appartenenza o sulla configurazione dei reparti — questi vengono gestiti separatamente. [^3, ^5]

---

Cosa verificare

• Copertura degli scope: Conferma che il token OAuth attivo includa almeno uno tra Desk.settings.ALL o Desk.settings.DELETE prima di effettuare la chiamata. ^[2]
• ID risorsa corretto: Verifica che il team_id che stai passando corrisponda effettivamente a un team (e non a un reparto o a un gruppo dell'Help Center), confrontandolo prima con una lista GET dei team. ^[1]
• Stato della risposta: Dopo il completamento della chiamata DELETE, conferma che la risposta HTTP indichi il successo — qualsiasi codice di errore deve essere analizzato in relazione alle tue credenziali e alla validità dell'ID del team. ^[1]