Zoho CRM offre diversi modi per recuperare i record correlati — da un componente UI senza codice che rispecchia i dati in tempo reale direttamente nella pagina di dettaglio di un record, a strumenti di query GraphQL e REST per l'accesso programmatico rivolti agli sviluppatori.

Perché è importante

Lavorando in Zoho CRM, i record raramente esistono in isolamento. Un'opportunità è collegata a un contatto; un caso è associato a un account. Senza un metodo strutturato per visualizzare quei dati correlati, il tuo team perde tempo navigando tra i moduli per trovare un numero di telefono, un indirizzo email o un aggiornamento di stato. Sapere quale metodo di recupero si adatta al tuo caso d'uso — basato su UI o su API — fa risparmiare tempo significativo e riduce i cambi di contesto.

Procedura passo dopo passo

Opzione A: Usa il Mirror Component (Senza codice, UI)

Passaggio 1. Comprendi cosa fa il Mirror Component. Agisce come una finestra live incorporata direttamente nella pagina di dettaglio di un record, rispecchiando in tempo reale i valori dei campi di un record correlato. Ad esempio, un rappresentante commerciale che lavora su un'opportunità può vedere il numero di telefono o l'indirizzo email del contatto collegato senza mai lasciare il record dell'opportunità. ^[1]

Passaggio 2. Verifica l'idoneità del tuo data center. Nella versione più recente, il Mirror Component è disponibile per i data center JP, CA, SA, UAE e AU. Se la tua organizzazione si trova su uno di questi DC, la funzionalità dovrebbe essere accessibile dalle impostazioni del tuo CRM. ^[1]

Passaggio 3. Naviga alla pagina di dettaglio del record in cui desideri aggiungere il componente. Il Mirror Component viene configurato a livello di layout di pagina — apri Impostazioni → Moduli e Campi, seleziona il modulo pertinente e apri l'editor di layout per la vista di dettaglio di quel modulo. ^[1]

Passaggio 4. Individua l'opzione Mirror Component nella palette dei componenti dell'editor di layout e trascinala sul canvas del layout. Configurala selezionando il campo di lookup che definisce la relazione (ad esempio, il lookup Contatto su un'Opportunità), quindi scegli quali campi del record correlato desideri visualizzare. ^[1]

Passaggio 5. Salva il layout. I membri del team che visualizzano quel record vedranno ora i campi rispecchiati aggiornati in tempo reale — senza necessità di navigazione. ^[1]

---

Opzione B: Usa l'API GraphQL (Sviluppatori, query con molte letture)

Passaggio 1. Verifica che la tua edizione di CRM supporti GraphQL. L'API GraphQL non è disponibile nelle versioni di prova di nessuna edizione di Zoho CRM — è necessario un piano a pagamento. ^[3]

Passaggio 2. Autentica il tuo client API utilizzando un token OAuth 2.0 valido per Zoho CRM. Una volta autenticato, puoi interrogare sia i dati dei record che i metadati attraverso il tipo radice Query, che espone due campi di primo livello: Records e Meta. ^[3]

Passaggio 3. Costruisci una query che recuperi campi da più moduli correlati in una singola richiesta. Ad esempio, per recuperare i nomi degli account insieme ai cognomi dei lead in una sola chiamata, struttura la tua query in questo modo: ^[3]

query {
  Records {
    Accounts {
      _data {
        Account_Name {
          value
        }
      }
    }
    Leads {
      _data {
        Last_Name {
          value
        }
      }
    }
  }
}

Passaggio 4. Usa il tipo Meta quando hai bisogno di informazioni strutturali — come i valori api_name dei ruoli o i dettagli degli utenti — anziché dati dei record. Sia Meta che Records supportano filtri e paginazione per restringere grandi set di risultati. ^[3]

---

Opzione C: Usa la funzionalità Query (Sviluppatori, sorgenti esterne/database)

Passaggio 1. Naviga su Impostazioni → Spazio Sviluppatore → Query in Zoho CRM. Questa funzionalità ti consente di definire sorgenti dati e scrivere query in stile SQL su di esse. ^[5]

Passaggio 2. Aggiungi una sorgente. I tipi di sorgente supportati includono:

REST API — punta a un endpoint esterno con un URL base, parametri predefiniti e intestazioni. ^[5]
Database — connetti MySQL, Microsoft SQL o PostgreSQL fornendo host, porta, nome del database, credenziali e impostazioni SSL opzionali. ^[5]
Cloud Database — connetti database Amazon RDS, Google Cloud Platform o Microsoft Azure con campi di configurazione simili. ^[5]

Passaggio 3. Se l'host della tua sorgente non è in formato indirizzo IP, aggiungilo ai Domini Attendibili nelle impostazioni del CRM. Inoltre, inserisci nella whitelist gli indirizzi IP di Zoho CRM sul tuo server relay in modo che il CRM possa raggiungere il tuo database. ^[5]

Passaggio 4. Scrivi e salva la tua query. Consulta la pagina Limiti all'interno della documentazione delle Query per i limiti delle sorgenti di query SQL, le restrizioni sulle query e le strutture di esempio per le diverse operazioni. ^[5]

---

Errori comuni

Mirror Component non visibile? Ricontrolla il tuo data center. La funzionalità è attualmente limitata ai DC JP, CA, SA, UAE e AU — le organizzazioni su altri DC non la vedranno ancora nell'editor di layout. ^[1]
GraphQL non restituisce nulla su un account di prova? L'API GraphQL non è esplicitamente disponibile nelle edizioni di prova. Passa a un piano a pagamento prima di tentare chiamate API. ^[3]
Le query al database falliscono? Le due cause più comuni sono una voce mancante nei Domini Attendibili per il tuo host e gli IP di Zoho CRM non inseriti nella whitelist sul tuo server relay. Risolvi entrambi prima di testare la connettività. ^[5]

---

Cosa verificare

Mirror Component: Dopo aver salvato il layout, apri un record live e verifica che i campi rispecchiati mostrino i valori correnti del record correlato — non dati obsoleti o vuoti. ^[1]
GraphQL: Verifica che la tua query restituisca i campi value attesi sotto _data per ogni modulo e che i parametri di paginazione funzionino correttamente se il tuo dataset è grande. ^[3]
Query / Sorgenti database: Verifica che lo stato della connessione alla sorgente risulti attivo nella pagina di configurazione delle Query ed esegui una query di test per convalidare il recupero delle righe prima di incorporarla nell'automazione. ^[5]

---

*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale di Zoho. Per problemi a livello di piattaforma o domande sulla fatturazione, contatta Zoho direttamente tramite il portale del tuo account.*

Come recuperare i record correlati in Zoho CRM