Il collegamento dei record in Zoho CRM ti consente di visualizzare dati connessi tra moduli e app esterne — questa guida spiega come recuperare e utilizzare quei dettagli di collegamento tramite funzionalità native e pattern URL a livello API.
Perché è importante
Quando i tuoi record CRM sono collegati a contatti, trattative, account o persino sistemi esterni come Zoho Desk o Zoho FSM, sapere *come* sono strutturati quei collegamenti ti aiuta a navigare rapidamente, creare automazioni ed evitare riferimenti incrociati tra moduli non funzionanti. I team che gestiscono assistenza sul campo, ticket di supporto o pipeline di vendita complesse traggono particolare vantaggio dal capire esattamente dove risiedono i dati dei record collegati e come accedervi in modo programmatico o tramite interfaccia utente. In qualità di supporto esperto indipendente per Zoho (non supporto ufficiale Zoho), Beam Help vede questa domanda emergere frequentemente quando i clienti stanno costruendo integrazioni o personalizzando le pagine di dettaglio dei record.
---
Procedura passo dopo passo
Passaggio 1. Comprendi il pattern URL standard dei record CRM prima di iniziare a recuperare i dettagli di collegamento. Ogni record di Zoho CRM segue il formato https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId} — dove dc è il tuo data center (ad es., com, eu, in) e Module è il nome API del modulo (ad es., Contacts, Deals). Se la tua organizzazione ha un ID org specifico, l'URL può assumere anche la forma /crm/org{OrgId}/tab/{Module}/{RecordId}. Conoscere questo pattern ti consente di costruire o verificare link diretti a qualsiasi record collegato. [2]
Passaggio 2. Quando recuperi dati di record tramite l'API di Zoho CRM, controlla il payload della risposta per i campi $se_module o module su ogni oggetto record correlato — questi indicano a quale modulo appartiene il record collegato. L'identificatore univoco del record si trova nel campo id, oppure all'interno di un oggetto annidato details sotto details.id se il campo id di primo livello è assente. [4]
Passaggio 3. Per identificare il nome visualizzato di un record collegato (utile per etichettare i link in dashboard o automazioni), cerca questi campi in ordine di priorità all'interno del record o del suo sotto-oggetto details: FullName, Name, Subject, DealName o Account_Name. Se nessuno di questi è popolato, ricorri alla costruzione di un'etichetta come Record {RecordId}. [4]
Passaggio 4. Se stai lavorando con record collegati anche a Zoho Desk, i dettagli di collegamento sono memorizzati in una sezione dedicata. Nel record associato all'interno di Zoho FSM (o moduli adiacenti a CRM), cerca la sezione Zoho Desk Info nel pannello sinistro — questa mostra il link diretto al ticket, account o contatto Desk di origine. [1][6]
Passaggio 5. Per visualizzare o gestire i link tra record di sistemi diversi dal lato Zoho Desk, apri un record Ticket, Account o Contatto in Desk e vai alla scheda Zoho FSM. Da lì puoi vedere quali record FSM (Richieste, Preventivi, Ordini di lavoro, Appuntamenti di servizio, Asset) sono collegati, accedervi con un clic, oppure usare l'icona link per allegare un record esistente. [1][7]
Passaggio 6. Per un approccio puramente interno a CRM per visualizzare i dati dei record correlati senza navigare altrove, usa il Mirror Component nella pagina di dettaglio di un record. Questa funzionalità riflette i valori dei campi in tempo reale da un record correlato — ad esempio, il numero di telefono o l'email di un contatto visualizzati direttamente all'interno di un record trattativa — così puoi verificare che il collegamento sia corretto e i dati siano aggiornati senza aprire separatamente il record collegato. [3]
Passaggio 7. Se stai costruendo un connettore o una funzione che deve richiamare dati di record collegati da un servizio di terze parti, configura una Connection nelle impostazioni sviluppatore di Zoho CRM. Dopo aver fatto clic su Create and Connect, la pagina risultante mostra il nome del link, il nome del servizio e lo stato, insieme a uno snippet di codice pronto all'uso per richiamare la connessione all'interno di una funzione Deluge. Il valore Connection in quello snippet corrisponde al nome del link che hai assegnato. [5]
---
Errori comuni
- Identificatore di modulo mancante: Se il campo
$se_moduleè vuoto in una risposta API, il sistema non può costruire un URL valido per il record CRM. Verifica sempre che il nome API del modulo sia presente prima di tentare di costruire un link diretto. [4] - Errori di collegamento tra sistemi: Quando si collega un Contatto di Zoho Desk a un record Zoho FSM, il Contatto deve essere già associato alla Company FSM corretta che corrisponde all'Account Desk. Saltare questo passaggio di associazione genera un errore e blocca la creazione del record. [1][6]
- L'ordine di scollegamento è importante: Se devi scollegare un Account Desk da Zoho FSM, devi prima scollegare tutti i Contatti associati a quell'Account. Il tentativo di scollegare l'Account mentre i Contatti sono ancora allegati fallirà — controlla prima la scheda Contacts nel record. [7]
- Disponibilità del Mirror Component: Secondo gli ultimi annunci, il Mirror Component è disponibile per i data center JP, CA, SA, UAE e AU. Se la tua organizzazione si trova su un DC diverso, questo metodo UI per visualizzare i dettagli di collegamento potrebbe non essere ancora accessibile. [3]
---
Cosa verificare
- Conferma che il nome API del
Modulee ilRecordIdnell'URL che hai costruito corrispondano a un record effettivo nella tua org CRM — naviga direttamente suhttps://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}per validarlo. [2][4] - Dopo aver collegato record tra sistemi diversi (ad es., Desk ↔ FSM), verifica che la sezione Zoho Desk Info appaia nel pannello sinistro del record FSM per confermare che il collegamento sia stato salvato correttamente. [6]
- Quando usi il Mirror Component, apri la trattativa o il record padre e conferma che i campi riflessi (come email o telefono del contatto) mostrino valori aggiornati, indicando che la relazione di lookup è intatta. [3]