Come recuperare i gruppi di utenti in Zoho

Recuperare i gruppi di utenti in Zoho CRM richiede di comprendere il contesto del prodotto con cui stai lavorando, poiché i gruppi di utenti funzionano diversamente nell'ecosistema di Zoho. Questa guida copre i metodi principali per accedere e recuperare le informazioni sui gruppi.

Perché è importante

I gruppi di utenti ti aiutano a organizzare e segmentare la tua base di utenti per un migliore controllo degli accessi, reporting e analitiche. Che tu stia gestendo i permessi in Zoho Analytics, organizzando gli utenti per attributi in Zoho Apptics, o controllando l'accesso ai documenti in Zoho Sign, sapere come recuperare i dati dei gruppi è essenziale per l'amministrazione e la conformità.

Passo dopo passo

Passo 1. Determina il contesto del tuo prodotto

I gruppi di utenti esistono in più prodotti Zoho con diversi metodi di recupero. Identifica se stai lavorando con Zoho Analytics (on-premise), Zoho Apptics (mobile analytics), o Zoho Sign (gestione documenti). Ognuno ha API e interfacce distinte per accedere alle informazioni sui gruppi.

Passo 2. Per Zoho Analytics on-premise: Autentica con OAuth

Configura l'autenticazione OAuth ottenendo il tuo token di accesso dall'endpoint degli account Zoho. Includi il tuo clientid, clientsecret e refreshtoken in una richiesta POST a https://accounts.zoho.com/oauth/v2/token con granttype impostato su refreshtoken. Memorizza il accesstoken restituito nelle intestazioni della tua richiesta come Authorization: Zoho-oauthtoken <access_token> ^[3].

Passo 3. Chiama l'endpoint dell'API GROUPINFO

Invia una richiesta POST a https://analyticsapi.zoho.com/api/<email>/<workspaceName> con i seguenti parametri: imposta ZOHOACTION su GROUPINFO, ZOHOOUTPUTFORMAT su JSON, ZOHOERRORFORMAT su JSON e ZOHOAPI_VERSION su 1.0 ^[3]. Includi l'intestazione di autorizzazione dal Passo 2.

Passo 4. Analizza la risposta dei metadati del gruppo

L'API restituisce un array JSON contenente tutti i gruppi nel tuo workspace. Ogni oggetto gruppo include groupId, groupName, groupDescription, createdTime e membersList (un array di indirizzi email dei membri) ^[3]. Estrai i gruppi di cui hai bisogno da questa risposta per ulteriori elaborazioni.

Passo 5. Per Zoho Apptics: Visualizza i gruppi nella console

Naviga a Marketer > Gruppi di utenti nel menu a sinistra per vedere i gruppi di utenti attivi, nuovi e inattivi per l'intervallo di date selezionato ^[1]. Questa interfaccia visualizza il conteggio totale dei gruppi e un elenco dettagliato che mostra il nome del gruppo, la data e l'ora di registrazione, l'ultima sessione attiva, i nuovi utenti, gli utenti attivi, i nuovi dispositivi e i dispositivi attivi ^[1].

Passo 6. Fai clic sui singoli gruppi per approfondimenti dettagliati

Seleziona qualsiasi gruppo di utenti dall'elenco per accedere alle analitiche granulari specifiche di quel gruppo ^[1]. Questo ti consente di analizzare quali segmenti guidano l'adozione e identificare i modelli di utilizzo tra diverse categorie di utenti.

Errori comuni

• Limitazione di attributo singolo in Apptics: Puoi raggruppare gli utenti per un solo attributo alla volta (come organizzazione, regione o lingua) ^[1]. Pianifica la tua strategia di raggruppamento di conseguenza.
• Requisiti di autorizzazione: Solo gli amministratori del server e i proprietari del workspace possono recuperare gli elenchi degli utenti e le informazioni sui gruppi tramite l'API Analytics ^[7]. Assicurati che il tuo account abbia il ruolo necessario.
• Contesto del workspace: Includi sempre il nome corretto del workspace nel tuo URI API. Le richieste senza un workspace valido non avranno successo.

Cosa verificare

• Verifica che il tuo token OAuth sia valido e non sia scaduto prima di effettuare chiamate API
• Conferma che l'indirizzo email e il nome del workspace nel tuo URI di richiesta corrispondono esattamente al tuo account Zoho Analytics
• Rivedi l'array membersList nella risposta per assicurarti che tutti i membri del gruppo previsti siano presenti

---

*Questo articolo è fornito da Beam Help — supporto esperto indipendente per Zoho. Non siamo il supporto ufficiale di Zoho.*