Cómo recuperar registros de auditoría en Zoho

Recuperar registros de auditoría en Zoho CRM es sencillo a través de un único endpoint GET que devuelve un historial paginado de la actividad de la cuenta. Esto es lo que necesitas saber para llamarlo correctamente.

Por qué es importante

Los registros de auditoría ofrecen a los administradores visibilidad sobre quién cambió qué y cuándo dentro de una organización de Zoho CRM. Los necesitarás al investigar cambios de datos inesperados, prepararte para una revisión de cumplimiento normativo o simplemente mantener un registro de la actividad de los usuarios a lo largo del tiempo. Sin acceso programático a estos registros, rastrear el origen de un problema con los datos puede ser un proceso lento y propenso a errores.

Paso a paso

Paso 1. Asegúrate de tener un token de acceso OAuth 2.0 válido para tu organización de Zoho CRM. El token se obtiene completando el flujo OAuth estándar de Zoho, que devuelve un accesstoken junto con un valor expiresin (normalmente 3600 segundos). Guarda la marca de tiempo de expiración para poder renovarlo antes de realizar la solicitud al registro de auditoría. ^[3]

Paso 2. Realiza una solicitud GET al endpoint /settings/auditlog. Esta es la operación dedicada —denominada internamente getaudit_log— que se encuentra bajo la categoría Backup & History de la API de configuración de Zoho CRM. ^[1]

GET /settings/audit_log

Paso 3. Pasa los parámetros de consulta necesarios usando el diccionario p (o la cadena de consulta equivalente en tu cliente HTTP). El endpoint acepta un objeto de parámetro p, por lo que puedes incluir opciones de paginación o filtrado como pares clave-valor dentro de esa estructura. ^[1]

Una llamada mínima en Python tiene este aspecto:

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

Para paginar o filtrar, rellena el diccionario de parámetros antes de pasarlo:

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

Paso 4. Analiza la respuesta JSON. El payload devuelto contendrá las entradas de auditoría de tu organización. Itera sobre los resultados y almacénalos o muéstralos según sea necesario para tu flujo de trabajo de informes o cumplimiento normativo. ^[1]

Paso 5. Si estás construyendo una interfaz de usuario sobre esto, considera crear enlaces profundos directos a la interfaz de Zoho CRM para que los administradores puedan ir directamente al registro relevante. El patrón de URL del CRM sigue el formato https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}, donde dc es el sufijo de tu centro de datos (p. ej., com, eu, in). ^[4]

Errores comunes

• Token de acceso expirado. El token OAuth expira tras el período expiresin. Si recibes un error de autenticación, comprueba si tokenexpires_at ha pasado y renueva el token antes de volver a intentarlo. ^[3]
• Centro de datos incorrecto. Zoho opera en múltiples centros de datos regionales. Si tu organización está en el centro de datos EU o IN, la URL base debe reflejarlo (p. ej., zoho.eu en lugar de zoho.com). Enviar solicitudes al DC incorrecto generará errores de autenticación o errores 404. ^{[3] [4]}
• Parámetro p vacío. La función getauditlog usa por defecto un diccionario vacío {} cuando no se proporcionan parámetros. Esto es válido y devolverá la página de resultados predeterminada, pero si esperas datos filtrados y olvidas pasar tus filtros, recibirás resultados sin filtrar sin ningún aviso. ^[1]
• Permisos insuficientes. El acceso a los registros de auditoría suele estar restringido a perfiles de nivel administrador dentro de Zoho CRM. Asegúrate de que los ámbitos OAuth y el perfil de usuario de CRM asociado a tu token tengan los permisos de configuración necesarios antes de llamar a este endpoint. ^[1]

Qué verificar

• Validez del token: Confirma que tu access_token no ha expirado y que fue emitido con el ámbito de configuración de CRM correcto antes de realizar la solicitud.
• Alineación del centro de datos: Verifica que la URL base de tu cliente API coincida con el centro de datos donde está alojada tu organización de Zoho CRM. ^{[3] [4]}
• Paginación de la respuesta: Comprueba si la respuesta incluye metadatos de paginación y que estás iterando por todas las páginas si necesitas un historial de auditoría completo en lugar de solo la primera página. ^[1]

---

*Beam Help es un recurso de soporte experto independiente para usuarios de Zoho — no somos el soporte oficial de Zoho. Para problemas a nivel de plataforma o consultas de facturación, contacta directamente con Zoho.*