Come ottenere le visualizzazioni personalizzate in Zoho

Le visualizzazioni personalizzate in Zoho CRM possono essere recuperate sia come elenco completo per un determinato modulo, sia come singola visualizzazione tramite il suo ID, utilizzando due endpoint API dedicati disponibili attraverso l'API delle impostazioni del CRM.

Perché è importante

Quando si creano integrazioni o automazioni su Zoho CRM, spesso è necessario sapere quali visualizzazioni personalizzate esistono per un modulo — ad esempio, per replicare un filtro salvato in una dashboard esterna o per verificare che una visualizzazione esista prima di referenziarla a livello programmatico. Recuperare una visualizzazione specifica tramite ID consente di esaminarne la configurazione esatta senza dover scaricare l'intero elenco. In qualità di supporto esperto indipendente (non supporto ufficiale Zoho), Beam Help documenta questi endpoint affinché il tuo team possa utilizzarli con sicurezza.

Procedura passo dopo passo

Passaggio 1. Per recuperare tutte le visualizzazioni personalizzate di un modulo, invia una richiesta GET all'endpoint /settings/customviews, passando il nome API del modulo come parametro di query module.^[1] Ad esempio, per elencare tutte le visualizzazioni personalizzate del modulo Leads, la richiesta dovrà puntare a /settings/customviews?module=Leads.^[1]

Passaggio 2. La chiamata sottostante segue questo schema — il client invia una GET a /settings/custom_views con {"module": m} come payload del parametro, dove m è la stringa con il nome del modulo.^[1] Questa operazione è classificata come chiamata di tipo settings ed è stata verificata come SAFE, ovvero sicura da eseguire senza rischio di modificare dati.^[3]

Passaggio 3. Per recuperare una singola visualizzazione personalizzata tramite il suo ID, utilizza invece l'endpoint /settings/custom_views/{vid}, dove {vid} è l'identificatore univoco della visualizzazione.^[2] È comunque necessario fornire il nome del modulo come parametro di query insieme all'ID della visualizzazione.^[2]

Passaggio 4. La chiamata per la singola visualizzazione segue questo schema — il client invia una GET a /settings/custom_views/{vid} con {"module": m} come parametro, e vid è la stringa dell'ID della visualizzazione che si desidera esaminare.^[2] Come l'endpoint per l'elenco, questa operazione è classificata come SAFE e non produce effetti collaterali in scrittura.^[8]

Passaggio 5. Se stai lavorando all'interno del livello di strumenti di Beam Help, il tool getcustomview racchiude questo endpoint e accetta m (nome del modulo) e view_id come parametri.^[7] Fornisci entrambi i valori e il tool si occuperà della costruzione del percorso per te.^[7]

Errori comuni

• Parametro modulo mancante. Entrambi gli endpoint richiedono il parametro module — ometterlo produrrà una risposta fallita o ambigua, poiché le visualizzazioni personalizzate di Zoho CRM sono sempre associate a un modulo specifico.^[1][2]
• Confusione tra i due endpoint. /settings/customviews (senza suffisso nel percorso) restituisce l'elenco completo per un modulo, mentre /settings/customviews/{vid} punta a una visualizzazione specifica. Utilizzare l'endpoint dell'elenco quando si dispone già di un ID visualizzazione è inefficiente e restituisce più dati del necessario.^[1][2]
• ID visualizzazione non aggiornati. Gli ID delle visualizzazioni sono stabili, ma possono diventare non validi se una visualizzazione personalizzata viene eliminata dall'interfaccia del CRM. Gestisci sempre in modo appropriato una risposta di visualizzazione mancante nel codice della tua integrazione.^[8]

Cosa verificare

• Conferma che il nome API del modulo che stai passando corrisponda esattamente al nome interno utilizzato da Zoho CRM (ad es., Leads, Contacts, Deals) — una discrepanza non restituirà alcun risultato.^[1]
• Verifica che l'ID visualizzazione fornito a /settings/custom_views/{vid} sia stato ottenuto da una precedente chiamata all'elenco o dalle impostazioni del CRM, per evitare di referenziare una visualizzazione eliminata o inesistente.^[2][8]
• Assicurati che le tue credenziali API abbiano accesso allo scope settings, poiché entrambi gli endpoint si trovano sotto /settings/ e potrebbero richiedere autorizzazioni elevate rispetto al normale accesso a livello di record.^[3][8]