Il motore AI Zia di Zoho CRM è in grado di individuare record che assomigliano strettamente a un determinato record — utile per identificare duplicati, trovare prospect correlati o incrociare i riferimenti degli account — il tutto tramite una singola chiamata API.
Perché è importante
Quando è necessario identificare in modo programmatico i record che condividono caratteristiche simili a un record noto, scansionare manualmente il CRM è impraticabile su larga scala. L'endpoint dei record simili di Zia consente di automatizzare questa ricerca all'interno di qualsiasi modulo supportato, alimentando i risultati in flussi di lavoro a valle, routine di deduplicazione o motori di raccomandazione. Questo è particolarmente utile se combinato con le funzionalità di intelligenza più ampie di Zia, come il punteggio di abbandono, dove la comprensione della somiglianza tra record può affinare le previsioni. [3]
---
Procedura passo dopo passo
Passaggio 1. Comprendi la struttura dell'endpoint.
L'operazione necessaria è una richiesta GET inviata a /{m}/{rid}/zia/similar_records, dove {m} è il nome API del modulo (ad esempio, Leads, Contacts o Deals) e {rid} è l'ID univoco del record per cui vuoi trovare le somiglianze. [1]
Passaggio 2. Identifica i due parametri obbligatori.
Prima di effettuare la chiamata, raccogli le seguenti informazioni:
m— il nome API del modulo Zoho CRM che contiene il record sorgente.rid— l'identificatore univoco del record specifico di cui vuoi recuperare i record simili.
Entrambi i parametri sono obbligatori; la richiesta non verrà risolta senza di essi. [1][2]
Passaggio 3. Costruisci e invia la richiesta.
Utilizzando il client HTTP o l'SDK che preferisci, invia una richiesta GET al percorso completamente risolto. In Python, la chiamata si presenta così:
result = client.get_zia_similar_records(m="Leads", rid="4876876000000123456")Internamente questo si risolve in GET /Leads/4876876000000123456/zia/similar_records rispetto all'URL base dell'API di Zoho CRM. [1][2]
Passaggio 4. Gestisci la risposta.
Il corpo della risposta conterrà i record che Zia ha identificato come simili a quello specificato. Analizza il payload restituito in base al tuo caso d'uso — ad esempio, segnalando potenziali duplicati, pre-popolando suggerimenti di record correlati o inserendo i punteggi di somiglianza in un dashboard di reportistica. [2]
Passaggio 5. Itera tra i moduli secondo necessità.
Poiché il nome del modulo è un parametro di percorso anziché un valore fisso, puoi riutilizzare lo stesso schema di chiamata in qualsiasi modulo CRM sostituendo {m}. Questo rende semplice costruire un ciclo che verifica la somiglianza tra Contacts, Leads e Accounts in una singola esecuzione dello script. [1]
---
Errori comuni
- Nome API del modulo errato. Il parametro
{m}deve corrispondere esattamente al nome API del modulo, non alla sua etichetta di visualizzazione. Ad esempio, usaContactse noncontactoCONTACTS. Un valore errato restituirà un errore o un insieme di risultati vuoto. [1] - ID record non valido o inaccessibile. Se
{rid}appartiene a un record a cui l'utente autenticato non può accedere, o se l'ID è malformato, l'endpoint non restituirà dati utili. Valida sempre l'ID del record prima di costruire la richiesta. [1] - Funzionalità Zia non abilitate. Le funzionalità di intelligenza di Zia, incluso il rilevamento delle somiglianze, devono essere attive per la tua organizzazione. Se Zia non è stata configurata o non è disponibile nel tuo piano, l'endpoint potrebbe non restituire risultati anche per input validi. [3]
---
Cosa verificare
- Conferma il nome API del modulo accedendo alle impostazioni di Zoho CRM e verificando la stringa esatta utilizzata nell'API — i nomi visualizzati e i nomi API possono differire.
- Verifica il formato dell'ID record incrociando il valore
ridcon un record noto recuperato tramite l'API dei record standard prima di chiamare l'endpoint Zia. - Conferma che Zia sia attiva nelle impostazioni della tua organizzazione, poiché la funzionalità dei record simili dipende dal motore analitico di Zia che deve essere abilitato e addestrato sui tuoi dati. [3]
---
*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale Zoho. Per domande relative ai diritti a livello di piattaforma, contatta direttamente Zoho.*