Come recuperare le regole di punteggio in Zoho

Recuperare le regole di punteggio in Zoho CRM è semplice una volta che si conosce il corretto endpoint API e il parametro modulo richiesto.

Perché è importante

Le regole di punteggio in Zoho CRM ti permettono di classificare automaticamente lead, contatti, trattative e altri record in base a criteri da te definiti. Se stai creando integrazioni, verificando la configurazione del tuo CRM o sincronizzando la logica di punteggio con un sistema esterno, avrai bisogno di un modo affidabile per recuperare queste regole in modo programmatico. Conoscere l'endpoint esatto e i suoi parametri fa risparmiare tempo e previene chiamate API mal configurate.

Passo dopo passo

Passaggio 1. Assicurati che la tua connessione OAuth includa gli scope Zoho CRM necessari prima di effettuare qualsiasi chiamata API. Il gruppo di scope richiesto per le impostazioni a livello di organizzazione è ZohoCRM.org.ALL, che copre la lettura dei dati di configurazione del CRM come le regole di punteggio. ^[3]

Passaggio 2. Autentica il tuo client e ottieni un access token valido. Il token viene recuperato scambiando un codice di autorizzazione o aggiornando un token esistente tramite l'endpoint OAuth token di Zoho. Una volta ottenuto, l'access token viene passato come token Bearer nell'intestazione Authorization di ogni richiesta successiva. ^[7]

Passaggio 3. Chiama l'endpoint delle regole di punteggio utilizzando una richiesta HTTP GET:

GET /settings/scoring_rules

Questo endpoint è categorizzato nelle impostazioni di punteggio e assegnazione in Zoho CRM. ^[1]

Passaggio 4. Passa il parametro module per specificare le regole di punteggio del modulo CRM che desideri recuperare. Ad esempio, per ottenere le regole di punteggio per il modulo Lead, fornisci module=Leads come parametro di query. Il parametro è obbligatorio — ometterlo non restituirà risultati significativi. ^[1]

Passaggio 5. Se stai lavorando in Python, la chiamata può essere strutturata come mostrato di seguito. Il metodo accetta il nome del modulo come stringa (m) ed esegue la richiesta GET con {"module": m} come parametri di query:

def get_scoring_rules(self, m: str):
    return self.c.request("GET", "/settings/scoring_rules", {"module": m})

Questo schema mantiene il nome del modulo flessibile, così puoi iterare su più moduli (ad es. Leads, Contacts, Deals) senza duplicare il codice. ^[1]

Passaggio 6. Analizza la risposta. L'API restituirà le regole di punteggio configurate per il modulo specificato. Salvale o elaborale secondo le tue esigenze — ad esempio, registrandole per un audit trail o confrontandole con una configurazione di riferimento.

Errori comuni

• Scope mancante o errato. Se il tuo token OAuth è stato generato senza ZohoCRM.org.ALL, l'API restituirà un errore di autorizzazione. Verifica sempre gli scope inclusi nel tuo token prima di eseguire il debug dell'endpoint. ^[3]
• Parametro module omesso. L'endpoint si aspetta un valore module. Chiamare GET /settings/scoring_rules senza specificare un modulo potrebbe restituire una risposta vuota o un errore. Passa sempre un nome di modulo CRM valido come Leads, Contacts o Deals. ^[1]
• Access token scaduto. I token di accesso Zoho scadono (in genere dopo 3600 secondi). La tua integrazione dovrebbe rilevare la scadenza e utilizzare il flusso di refresh token per ottenere un nuovo access token prima di riprovare la richiesta. ^[5]
• Mancata corrispondenza del data center. Zoho opera su più data center (.com, .eu, .in, ecc.). Assicurati che l'URL base della tua API corrisponda al data center in cui è ospitata la tua organizzazione CRM, altrimenti le richieste falliranno o restituiranno risultati imprevisti. ^[5]

Cosa verificare

• Copertura degli scope: Conferma che ZohoCRM.org.ALL sia presente negli scope utilizzati durante la generazione del tuo token OAuth. ^[3]
• Accuratezza del nome del modulo: Verifica che il nome del modulo che passi corrisponda esattamente al nome API utilizzato nella tua istanza di Zoho CRM (ad es. Leads e non Lead). ^[1]
• Validità del token: Controlla che il tuo access token non sia scaduto prima di effettuare la chiamata e che la tua logica di refresh funzioni correttamente. ^[5]

---

*Beam Help è una risorsa di supporto esperto indipendente per Zoho — non siamo il supporto ufficiale Zoho. Per problemi a livello di piattaforma, fai sempre riferimento alla documentazione ufficiale di Zoho.*