Come recuperare le dashboard in Zoho

Recuperare le dashboard in Zoho CRM è semplice una volta autenticata la connessione API — una singola richiesta GET all'endpoint delle impostazioni restituisce tutti i dati delle dashboard disponibili.

Perché è importante

Se stai creando integrazioni, automatizzando flussi di lavoro per i report o verificando la configurazione analytics di Zoho CRM, avrai bisogno di accesso programmatico alle tue dashboard. Questo è particolarmente utile quando vuoi inventariare le dashboard esistenti, sincronizzarle con strumenti BI esterni o verificare quali viste analytics sono configurate per la tua organizzazione.

Procedura passo dopo passo

Passaggio 1. Assicurati che la connessione API di Zoho CRM sia attiva e autenticata. Il sistema utilizza token OAuth che possono scadere, quindi verifica che il tuo accesstoken sia valido prima di effettuare qualsiasi chiamata. Se il token è scaduto, un flusso di aggiornamento che utilizza il tuo refreshtoken memorizzato ne otterrà automaticamente uno nuovo. ^[3]

Passaggio 2. Effettua una richiesta GET all'endpoint /settings/dashboards dell'API di Zoho CRM. Questa è l'operazione designata — denominata get_dashboards — che si trova nella categoria Signals & Analytics dell'API delle impostazioni CRM. ^[6]

GET /settings/dashboards

Passaggio 3. La chiamata Python sottostante che alimenta questa operazione è semplice:

def get_dashboards(self):
    return self.c.request("GET", "/settings/dashboards")

L'oggetto client (self.c) gestisce l'aggiunta dell'intestazione di autorizzazione e l'instradamento della richiesta al dominio del data center corretto. ^[6]

Passaggio 4. Verifica che i tuoi scope OAuth includano le autorizzazioni necessarie per le impostazioni CRM. Il gruppo di scope richiesto comprende ZohoCRM.org.ALL, che concede l'accesso alle impostazioni a livello di organizzazione, inclusa la configurazione analytics. Senza gli scope corretti concessi al momento dell'autorizzazione OAuth, l'endpoint restituirà un errore di autorizzazione. ^[8]

Passaggio 5. Una volta ricevuta una risposta, analizza il payload restituito. Se stai creando link o riferimenti all'interfaccia utente di Zoho CRM, il pattern dell'URL base segue il formato https://crm.zoho.{dc}/crm dove {dc} è il suffisso del tuo data center (ad es., com, eu, in). ^[5]

Errori comuni

• Token di accesso scaduto o mancante. Se la connessione API non è autenticata, la chiamata fallirà immediatamente. Verifica sempre che la sessione sia attiva prima di eseguire la richiesta — uno stato non autenticato richiede di avviare nuovamente il flusso OAuth. ^[3]
• Dominio del data center errato. Zoho CRM è ospitato su più data center regionali. Inviare la richiesta a crm.zoho.com quando il tuo account si trova su crm.zoho.eu, ad esempio, comporterà una chiamata fallita o indirizzata erroneamente. Recupera il valore dc dal tuo record di connessione memorizzato e costruisci di conseguenza l'URL base. ^[5]
• Scope OAuth insufficienti. Se gli scope non erano configurati per includere l'accesso a livello di organizzazione CRM al momento della prima autorizzazione della connessione OAuth, l'endpoint delle dashboard rifiuterà la richiesta. Sarà necessario ri-autorizzare la connessione con il set di scope corretto. ^[8]

Cosa verificare

• Conferma che la risposta API contenga un elenco di oggetti dashboard e non stia restituendo un errore di autenticazione o di autorizzazione.
• Verifica che il valore dc nel tuo record di connessione corrisponda al data center Zoho effettivo su cui è registrato il tuo account, in modo che tutta la successiva costruzione degli URL sia corretta. ^[5]
• Controlla che gli scope OAuth concessi al momento della connessione includano ZohoCRM.org.ALL per garantire che gli endpoint a livello di impostazioni rimangano accessibili. ^[8]

---

*Beam Help fornisce supporto esperto indipendente per Zoho — non siamo il supporto ufficiale Zoho. Per problemi di fatturazione o account a livello di piattaforma, contatta direttamente Zoho.*