Come ottenere record correlati in Zoho

Recuperare record correlati in Zoho CRM richiede una singola richiesta GET che punta a uno specifico record padre e indica la lista correlata (sotto-modulo) che si desidera ottenere — ecco come farlo correttamente.

Perché è importante

Quando lavori con i dati di Zoho CRM, i record raramente esistono in isolamento. Un Contatto può avere Deal collegati, un Deal può avere Attività associate e un Account può avere più Casi aperti. Sapere come recuperare queste liste correlate in modo programmatico ti permette di costruire integrazioni più ricche, automatizzare i follow-up e visualizzare il contesto completo di qualsiasi record senza navigare manualmente nell'interfaccia utente.

Procedura passo dopo passo

Passo 1. Identifica i tre parametri di percorso obbligatori prima di effettuare qualsiasi chiamata: il modulo (m), l'ID del record (rid) e il nome API della lista correlata (rel). Ad esempio, per recuperare i Contatti collegati a uno specifico Account, m sarà Accounts, rid sarà l'ID univoco del record Account e rel sarà Contacts. ^[3]

Passo 2. Costruisci la tua richiesta utilizzando il pattern di endpoint GET /{m}/{rid}/{rel}. L'operazione è denominata getrelatedrecords nel livello API di Zoho CRM. Una chiamata Python minimale si presenta così: ^[3]

get_related_records(m="Accounts", rid="<record_id>", rel="Contacts")

Il metodo esegue internamente una richiesta GET verso /<m>/<rid>/<rel> e accetta un parametro opzionale p per ulteriori opzioni di query come la paginazione. ^[3]

Passo 3. Passa le opzioni di paginazione o filtro tramite l'argomento dizionario p se prevedi un set di risultati di grandi dimensioni. Il parametro p si mappa direttamente sulle opzioni della query string supportate dall'endpoint, quindi puoi includere chiavi come page o per_page secondo necessità. ^[3]

Passo 4. Una volta ricevuta la risposta, puoi costruire link diretti nel browser verso qualsiasi record restituito. Il pattern URL del CRM segue https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}, dove dc è il suffisso del tuo data center (ad es. com, eu, in). ^[1] Se la tua organizzazione utilizza un data center non predefinito, sostituisci il suffisso corretto affinché i link si risolvano correttamente. ^[1]

Passo 5. Se stai lavorando all'interno di un livello di orchestrazione degli strumenti (come quello che il nostro team di Beam Help costruisce su Zoho CRM), il risultato di getrelatedrecords può essere passato direttamente a un'utilità di costruzione dei link. Tale utilità accetta il dizionario del risultato grezzo, il nome dello strumento, i parametri utilizzati, il tipo di app e gli identificatori del data center/organizzazione, quindi restituisce un elenco di oggetti URL nominati pronti per essere visualizzati in un'interfaccia chat o dashboard. ^[8]

---

*Beam Help è un supporto esperto indipendente per Zoho — non siamo il supporto ufficiale di Zoho.*

---

Errori comuni

• Nome rel errato. Il nome della lista correlata deve corrispondere al nome API atteso da Zoho, non all'etichetta visualizzata. Ad esempio, l'interfaccia potrebbe mostrare "Attività aperte" ma il nome API potrebbe essere Activities. Consulta il riferimento API del CRM per la stringa esatta.
• ID record mancante. Passare un rid vuoto o malformato causerà il fallimento silenzioso della richiesta o la restituzione di un payload di errore. Verifica sempre che l'ID del record padre sia una stringa non vuota prima di chiamare l'endpoint. ^[3]
• Mancata corrispondenza del data center. Se la tua organizzazione CRM è ospitata sul data center EU o IN e inserisci .com in modo fisso negli URL costruiti, i link non saranno raggiungibili. Deriva sempre il valore dc dai metadati di connessione memorizzati. ^[1]
• Parametro p vuoto. L'argomento p ha come valore predefinito un dizionario vuoto quando non viene fornito (p or {}), quindi ometterlo è sicuro — ma dimenticarsi di paginare su liste correlate di grandi dimensioni significa ricevere solo la prima pagina di risultati. ^[3]

Cosa verificare

• Conferma che il valore rel che stai utilizzando corrisponda al nome API esatto della lista correlata nella tua configurazione CRM, non solo alla sua etichetta nell'interfaccia utente. ^[3]
• Verifica che il valore dc (data center) memorizzato nel tuo record di connessione corrisponda al dominio su cui risiede effettivamente la tua organizzazione CRM, in modo che i link ai record generati si risolvano correttamente. ^[1]
• Dopo aver recuperato i risultati, controlla che la risposta contenga i sotto-record attesi e non sia un oggetto di errore — un rid mancante o errato è la causa più comune di una risposta vuota o fallita. ^[3]