Recuperar grupos de usuarios en Zoho CRM requiere entender en qué contexto de producto estás trabajando, ya que los grupos de usuarios funcionan de manera diferente en el ecosistema de Zoho. Esta guía cubre los métodos principales para acceder y recuperar información de grupos.
Por qué esto es importante
Los grupos de usuarios te ayudan a organizar y segmentar tu base de usuarios para un mejor control de acceso, reportes y análisis. Ya sea que estés gestionando permisos en Zoho Analytics, organizando usuarios por atributos en Zoho Apptics, o controlando el acceso a documentos en Zoho Sign, saber cómo recuperar datos de grupos es esencial para la administración y el cumplimiento normativo.
Paso a paso
Paso 1. Determina tu contexto de producto
Los grupos de usuarios existen en múltiples productos de Zoho con diferentes métodos de recuperación. Identifica si estás trabajando con Zoho Analytics (on-premise), Zoho Apptics (análisis móvil), o Zoho Sign (gestión de documentos). Cada uno tiene APIs e interfaces distintas para acceder a la información de grupos.
Paso 2. Para Zoho Analytics on-premise: Autentica con OAuth
Configura la autenticación OAuth obteniendo tu token de acceso desde el endpoint de cuentas de Zoho. Incluye tu clientid, clientsecret, y refreshtoken en una solicitud POST a https://accounts.zoho.com/oauth/v2/token con granttype establecido en refreshtoken. Almacena el accesstoken devuelto en los encabezados de tu solicitud como Authorization: Zoho-oauthtoken <access_token> [3].
Paso 3. Llama al endpoint de la API GROUPINFO
Envía una solicitud POST a https://analyticsapi.zoho.com/api/<email>/<workspaceName> con los siguientes parámetros: establece ZOHOACTION en GROUPINFO, ZOHOOUTPUTFORMAT en JSON, ZOHOERRORFORMAT en JSON, y ZOHOAPI_VERSION en 1.0 [3]. Incluye tu encabezado de autorización del Paso 2.
Paso 4. Analiza la respuesta de metadatos de grupos
La API devuelve un array JSON que contiene todos los grupos en tu espacio de trabajo. Cada objeto de grupo incluye groupId, groupName, groupDescription, createdTime, y membersList (un array de direcciones de correo electrónico de miembros) [3]. Extrae los grupos que necesites de esta respuesta para procesamiento posterior.
Paso 5. Para Zoho Apptics: Ver grupos en la consola
Navega a Marketer > User groups en el menú izquierdo para ver grupos de usuarios activos, nuevos e inactivos para tu rango de fechas seleccionado [1]. Esta interfaz muestra el recuento total de grupos y una lista detallada que muestra el nombre del grupo, fecha y hora de registro, última sesión activa, usuarios nuevos, usuarios activos, dispositivos nuevos y dispositivos activos [1].
Paso 6. Haz clic en grupos individuales para obtener información detallada
Selecciona cualquier grupo de usuarios de la lista para acceder a análisis granulares específicos de ese grupo [1]. Esto te permite analizar qué segmentos impulsan la adopción e identificar patrones de uso en diferentes categorías de usuarios.
Errores comunes
- Limitación de atributo único en Apptics: Solo puedes agrupar usuarios por un atributo a la vez (como organización, región o idioma) [1]. Planifica tu estrategia de agrupación en consecuencia.
- Requisitos de permisos: Solo los Administradores de Servidor y Propietarios de Espacio de Trabajo pueden recuperar listas de usuarios e información de grupos a través de la API de Analytics [7]. Asegúrate de que tu cuenta tenga el rol necesario.
- Contexto del espacio de trabajo: Siempre incluye el nombre correcto del espacio de trabajo en tu URI de API. Las solicitudes sin un espacio de trabajo válido fallarán.
Qué verificar
- Verifica que tu token OAuth sea válido y no haya expirado antes de hacer llamadas a la API
- Confirma que la dirección de correo electrónico y el nombre del espacio de trabajo en tu URI de solicitud coincidan exactamente con tu cuenta de Zoho Analytics
- Revisa el array
membersListen la respuesta para asegurar que todos los miembros del grupo esperados estén presentes
---
*Este artículo es proporcionado por Beam Help — soporte experto independiente para Zoho. No somos soporte oficial de Zoho.*