Recuperare le note dai record in Zoho CRM è semplice tramite l'interfaccia utente per gli utenti quotidiani, ed è disponibile tramite le Notes API per sviluppatori e amministratori che necessitano di accesso programmatico.
Perché è importante
I team di vendita si affidano alle note per monitorare l'avanzamento delle trattative, riassumere le interazioni con i clienti e mantenere il contesto visibile a tutto il team. [5] Che tu sia un rappresentante che rivede la cronologia di un contatto prima di una chiamata, o uno sviluppatore che crea un'integrazione per trasferire i dati delle note in un altro sistema, conoscere il metodo di recupero corretto fa risparmiare tempo e previene la perdita di contesto.
Procedura passo dopo passo
Passaggio 1. Comprendere cosa sono le Note in Zoho CRM.
Le note servono come strumento per registrare osservazioni sulle interazioni con clienti e prospect; poiché sono archiviate come dati CRM, qualsiasi rappresentante commerciale può verificare l'avanzamento di una trattativa in qualsiasi momento. [5] Prima di recuperare le note, verifica a quale modulo appartiene il record — Lead, Contatti, Account, Trattative e così via — poiché le note sono sempre associate a uno specifico record padre.
Passaggio 2. Recuperare le note tramite l'interfaccia utente di Zoho CRM.
Apri il record pertinente (ad esempio, un Contatto o un Account) in Zoho CRM. Scorri fino alla sezione Note nella vista dettaglio del record. Tutte le note associate a quel record saranno elencate lì. Questo è il percorso più rapido per gli utenti quotidiani che non necessitano di esportazioni in blocco o automazione. [5]
Passaggio 3. Utilizzare le Notes API di Zoho CRM per il recupero programmatico.
Se hai bisogno di recuperare note su larga scala o integrarle con un altro sistema, utilizza le REST API di Zoho CRM. Il modulo Note è accessibile tramite l'endpoint standard Get Records:
GET https://www.zohoapis.com/crm/v8/NotesIncludi il tuo token OAuth nell'intestazione Authorization come Zoho-oauthtoken <yourtoken>. Puoi paginare i risultati utilizzando il parametro pagetoken restituito in ogni risposta, passandolo come parametro di query nelle chiamate successive. [4]
Passaggio 4. Verificare i permessi di amministratore prima di chiamare le API.
Le API del modulo Note applicano un modello di autorizzazioni rigido. Se l'utente autenticato non è un amministratore, le API restituiscono un errore HTTP 403 NOT_SUPPORTED con il messaggio che l'endpoint è disponibile solo per gli utenti amministratori. [4] Assicurati che le credenziali OAuth che stai utilizzando appartengano a un profilo amministratore CRM, oppure chiedi al tuo amministratore di sistema di generare il token per tuo conto.
Passaggio 5. Filtrare o cercare le note secondo necessità.
Once you have access, you can narrow results by passing field filters as query parameters on the API call — for example, filtering by the parent record ID to retrieve only notes tied to a specific Lead or Contact. [4] Nell'interfaccia utente, la funzionalità di ricerca di Zoho CRM consente di individuare le note per parola chiave nel tuo account. [1]
Passaggio 6. (Facoltativo) Visualizzare le note nei record correlati nelle integrazioni con Zoho FSM.
Se la tua organizzazione utilizza Zoho FSM insieme a Zoho CRM o Zoho Desk, le note aggiunte a record come Richieste, Preventivi, Ordini di lavoro, Appuntamenti di servizio e Risorse vengono visualizzate in tutti i record associati. [6] Per visualizzarle da un record Contatto o Account, apri il record, fai clic sulla scheda Zoho FSM, passa il cursore sul record FSM collegato e fai clic sull'icona Visualizza note. Verrai indirizzato direttamente alla scheda Note per quel record. [2]
Errori comuni
- Errori 403 sulle API: Si tratta quasi sempre di un problema di autorizzazioni. Solo gli utenti amministratori possono interrogare il modulo Note tramite le API. I token non amministratori verranno rifiutati con
NOT_SUPPORTED. [4] - Note non visualizzate nei record correlati: Se utilizzi Zoho FSM e ti aspetti che le note si propaghino tra i record collegati (ad es., da un Ordine di lavoro a un Appuntamento di servizio), verifica che i record siano correttamente collegati tramite la catena Richiesta → Preventivo → Ordine di lavoro → Appuntamento di servizio. Le note fluiscono solo tra record che condividono questa relazione. [8]
- Lacune nella paginazione: Quando si recuperano grandi volumi di note tramite le API, cattura sempre il
page_tokenda ogni risposta e passalo nella chiamata successiva. Saltare questo passaggio causerà record duplicati o mancanti nel tuo dataset. [4] - Modulo di destinazione errato: Le note sono archiviate nel modulo
Notes, non nei singoli moduli padre comeLeadsoContacts. L'interrogazione diLeadsnon restituirà il contenuto delle note — devi puntare direttamente all'endpointNotes. [4]
Cosa verificare
- Accesso amministratore confermato: Verifica che il token OAuth utilizzato per le chiamate API appartenga a un utente amministratore CRM, altrimenti tutte le richieste alle Notes API falliranno con un errore 403. [4]
- Il collegamento del record è corretto: Nell'interfaccia utente, verifica che la nota sia associata al record padre previsto — specialmente negli ambienti integrati con FSM, dove le note possono apparire in più moduli correlati. [6]
- La paginazione è gestita: Se stai recuperando le note in modo programmatico, verifica che il tuo codice legga e passi correttamente il
page_tokenin modo che nessun record venga saltato nelle chiamate API multiple. [4]
---
*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale Zoho. Verifica sempre il comportamento in base alla tua specifica edizione di Zoho CRM e alla versione delle API.*