Come recuperare i log di audit in Zoho

Recuperare i log di audit in Zoho CRM è semplice tramite un singolo endpoint GET che restituisce una cronologia paginata dell'attività dell'account. Ecco tutto ciò che devi sapere per chiamarlo correttamente.

Perché è importante

I log di audit offrono agli amministratori visibilità su chi ha modificato cosa e quando all'interno di un'organizzazione Zoho CRM. Ne avrai bisogno quando indaghi su modifiche impreviste ai dati, ti prepari per una verifica di conformità o semplicemente vuoi tenere un registro dell'attività degli utenti nel tempo. Senza accesso programmatico a questi log, risalire all'origine di un problema sui dati può essere dispendioso in termini di tempo e soggetto a errori.

Procedura passo dopo passo

Passaggio 1. Assicurati di avere un token di accesso OAuth 2.0 valido per la tua organizzazione Zoho CRM. Il token si ottiene completando il flusso OAuth standard di Zoho, che restituisce un accesstoken insieme a un valore expiresin (in genere 3600 secondi). Salva il timestamp di scadenza in modo da poter aggiornare il token prima di effettuare la richiesta al log di audit. ^[3]

Passaggio 2. Esegui una richiesta GET all'endpoint /settings/auditlog. Questa è l'operazione dedicata — denominata internamente getaudit_log — che si trova nella categoria Backup & History dell'API delle impostazioni di Zoho CRM. ^[1]

GET /settings/audit_log

Passaggio 3. Passa gli eventuali parametri di query richiesti utilizzando il dizionario p (o la stringa di query equivalente nel tuo client HTTP). L'endpoint accetta un oggetto parametro p, quindi puoi includere opzioni di paginazione o filtro come coppie chiave-valore all'interno di quella struttura. ^[1]

Una chiamata Python minimale si presenta così:

# Assuming `client` is your authenticated Zoho CRM API client
response = client.request("GET", "/settings/audit_log", {})

Per paginare o filtrare, popola il dizionario dei parametri prima di passarlo:

params = {"page": 1, "per_page": 50}
response = client.request("GET", "/settings/audit_log", params)

Passaggio 4. Analizza la risposta JSON. Il payload restituito conterrà le voci di audit per la tua organizzazione. Scorri i risultati e salvali o visualizzali secondo le necessità del tuo flusso di lavoro per la reportistica o la conformità. ^[1]

Passaggio 5. Se stai costruendo un'interfaccia utente su questa base, considera la possibilità di creare deep-link diretti verso l'interfaccia di Zoho CRM in modo che gli amministratori possano accedere direttamente al record pertinente. 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). ^[4]

Errori comuni

• Token di accesso scaduto. Il token OAuth scade dopo la finestra expiresin. Se ricevi un errore di autenticazione, verifica se tokenexpires_at è già trascorso e aggiorna il token prima di riprovare. ^[3]
• Data center errato. Zoho opera su più data center regionali. Se la tua organizzazione si trova sul data center EU o IN, l'URL base deve riflettere questa configurazione (ad es. zoho.eu anziché zoho.com). L'invio di richieste al DC sbagliato comporterà errori di autenticazione o errori 404. ^{[3] [4]}
• Parametro p vuoto. La funzione getauditlog utilizza per impostazione predefinita un dizionario vuoto {} quando non vengono forniti parametri. Questo è valido e restituirà la pagina predefinita dei risultati, ma se ti aspetti dati filtrati e dimentichi di passare i filtri, riceverai silenziosamente un output non filtrato. ^[1]
• Permessi insufficienti. L'accesso ai log di audit è in genere limitato ai profili di livello amministratore all'interno di Zoho CRM. Assicurati che gli scope OAuth e il profilo utente CRM associato al tuo token dispongano delle autorizzazioni necessarie per le impostazioni prima di chiamare questo endpoint. ^[1]

Cosa verificare

• Validità del token: Conferma che il tuo access_token non sia scaduto e che sia stato emesso con lo scope corretto per le impostazioni CRM prima di effettuare la richiesta.
• Allineamento del data center: Verifica che l'URL base nel tuo client API corrisponda al data center in cui è ospitata la tua organizzazione Zoho CRM. ^{[3] [4]}
• Paginazione della risposta: Controlla se la risposta include metadati di paginazione e assicurati di scorrere tutte le pagine se hai bisogno di una cronologia di audit completa anziché solo della prima pagina. ^[1]

---

*Beam Help è una risorsa di supporto esperto indipendente per gli utenti Zoho — non siamo il supporto ufficiale di Zoho. Per problemi a livello di piattaforma o domande sulla fatturazione, contatta direttamente Zoho.*