Recuperare le informazioni dell'organizzazione in Zoho CRM può essere fatto tramite l'area Company Settings integrata nell'interfaccia utente o a livello di programmazione tramite l'endpoint OAuth di Zoho Accounts — entrambi gli approcci forniscono identificatori org chiave e dettagli di configurazione.
Perché è importante
Sapere dove trovare e come recuperare le informazioni dell'organizzazione è essenziale quando stai configurando integrazioni, controllando la configurazione del tuo CRM o creando applicazioni personalizzate che devono identificare quale org di Zoho CRM sono collegate. Gli amministratori hanno regolarmente bisogno di questi dettagli per configurare anni fiscali, orari di lavoro, impostazioni di valuta e preferenze di gerarchia. Gli sviluppatori che creano app connesse tramite OAuth devono risolvere in modo affidabile l'ID org e il nome org prima di effettuare chiamate API successive.
Procedura passo dopo passo
Opzione A — Utilizzo dell'interfaccia utente di Zoho CRM (Amministratore)
Passaggio 1. Accedi a Zoho CRM con un account che dispone del profilo Amministratore. Solo gli amministratori sono consigliati per visualizzare e personalizzare i dettagli specifici dell'azienda che differenziano un'organizzazione da un'altra. [6]
Passaggio 2. Vai a Setup (l'icona dell'ingranaggio nell'angolo in alto a destra), quindi individua la sezione Company Settings. Quest'area contiene dettagli specifici dell'organizzazione inclusa la configurazione dell'anno fiscale, gli orari di lavoro, le preferenze di gerarchia e le opzioni multi-valuta. [6]
Passaggio 3. Apri Manage Company Settings per rivedere o modificare il profilo principale della tua organizzazione — cose come il nome dell'azienda, l'indirizzo e il fuso orario. Questi campi sono quelli che Zoho CRM utilizza per distinguere la tua org da altre sulla piattaforma. [6]
Passaggio 4. Mentre sei ancora in Company Settings, esplora le sottosezioni secondo necessità:
- Set up Fiscal Year — definisce il periodo di 12 mesi che la tua organizzazione utilizza per la pianificazione e il monitoraggio delle vendite. [6]
- Manage Business Hours — imposta gli orari di lavoro in base alla posizione della tua azienda, importante se hai uffici in più paesi. [6]
- Manage Hierarchy Preference — controlla come l'accesso ai dati è strutturato tra gli utenti per designazione. [6]
- Manage Multiple Currencies — rilevante se la tua organizzazione gestisce transazioni internazionali. [6]
---
Opzione B — Recupero delle informazioni org a livello di programmazione tramite OAuth
Passaggio 1. Completa il flusso OAuth 2.0 per la tua integrazione Zoho CRM per ottenere un access token valido. Senza un token, l'endpoint delle informazioni utente/org rifiuterà la richiesta. [4]
Passaggio 2. Effettua una richiesta GET all'endpoint delle informazioni utente di Zoho Accounts:
GET https://accounts.zoho.<DC>/oauth/user/info
Authorization: Bearer <access_token>Sostituisci <DC> con il suffisso del tuo data centre (ad es. com, eu, in, com.au). La risposta contiene i dettagli dell'utente e dell'organizzazione. [4]
Passaggio 3. Analizza la risposta JSON per estrarre i campi di cui hai bisogno. I campi chiave da cercare includono:
ZUID— l'ID utente Zoho. [4]Email— l'indirizzo email dell'utente autenticato. [4]- Org ID — i nomi dei campi variano per data centre; controlla
orgid,organizationidoZGIDin questo ordine. Per org a singolo utente, il fallback aZUIDè un approccio ragionevole. [4] - Org Name — allo stesso modo, prova
companyname,organizationnameoCompany_Namein sequenza. Se nessuno è presente, la parte del dominio dell'indirizzo email può servire come etichetta di fallback. [4]
Passaggio 4. Archivia il crmorgid risolto in modo sicuro (ad esempio, in una tabella zoho_connections con chiave per ID di connessione) in modo che le chiamate API successive possano fare riferimento all'organizzazione corretta senza ri-recuperare. [5]
---
Insidie comuni
- I nomi dei campi differiscono per data centre. I campi ID org e nome org restituiti da
https://accounts.zoho.<DC>/oauth/user/infonon sono coerenti in tutti i data centre Zoho. Implementa sempre una catena di fallback piuttosto che assumere che un singolo nome di campo sarà presente. [4] - Le org a singolo utente potrebbero non restituire un ID org distinto. In questo caso limite, l'utilizzo di
ZUIDcome identificatore org proxy è una soluzione accettata, ma tieni presente che è un identificatore a livello di utente — non a livello di organizzazione. [4] - Company Settings sono solo per amministratori. Se un non amministratore accede a Setup, potrebbe non vedere il menu Company Settings completo. Assicurati che il profilo corretto sia assegnato prima di risolvere i problemi relativi ai voci di menu mancanti. [6]
- I campi dell'account sincronizzati sono limitati. Se stai estraendo dati org/account in un'integrazione Zoho Desk–CRM, solo un set definito di campi (Telefono, Email, Fax, Sito web, Settore, Ricavi annuali, campi indirizzo e Descrizione) sarà mappato. I campi al di fuori di questo elenco non si sincronizzeranno automaticamente. [2]
Cosa controllare
- Conferma che il suffisso del tuo data centre è corretto nell'URL dell'endpoint OAuth — una mancata corrispondenza restituirà un errore di autenticazione piuttosto che i dati org. [4]
- Verifica che l'accesso amministratore sia attivo per l'account che stai utilizzando per sfogliare Company Settings nell'interfaccia utente di Zoho CRM. [6]
- Confronta il
crmorgidarchiviato con il valore restituito dall'endpoint delle informazioni utente dopo qualsiasi ri-autenticazione per assicurare che il record di connessione rimanga accurato. [5]
---
*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale di Zoho. Per i problemi di account a livello di piattaforma, contatta Zoho direttamente tramite il loro portale di supporto.*