Cómo recuperar dashboards en Zoho

Recuperar dashboards en Zoho CRM es sencillo una vez que tu conexión a la API está autenticada: una única solicitud GET al endpoint de configuración devuelve todos los datos de dashboards disponibles.

Por qué esto es importante

Si estás creando integraciones, automatizando flujos de trabajo de informes o auditando la configuración de análisis de tu Zoho CRM, necesitarás acceso programático a tus dashboards. Esto resulta especialmente útil cuando quieres inventariar los dashboards existentes, sincronizarlos con herramientas de BI externas o verificar qué vistas de análisis están configuradas para tu organización.

Paso a paso

Paso 1. Asegúrate de que tu conexión a la API de Zoho CRM esté activa y autenticada. El sistema utiliza tokens OAuth que pueden caducar, así que confirma que tu accesstoken sea válido antes de realizar cualquier llamada. Si el token ha expirado, un flujo de actualización usando tu refreshtoken almacenado obtendrá uno nuevo de forma automática. ^[3]

Paso 2. Realiza una solicitud GET al endpoint /settings/dashboards de la API de Zoho CRM. Esta es la operación designada —denominada get_dashboards— que se encuentra bajo la categoría Signals & Analytics de la API de configuración del CRM. ^[6]

GET /settings/dashboards

Paso 3. La llamada Python subyacente que ejecuta esta operación es sencilla:

def get_dashboards(self):
    return self.c.request("GET", "/settings/dashboards")

Tu objeto cliente (self.c) se encarga de adjuntar el encabezado de autorización y enrutar la solicitud al dominio del centro de datos correcto. ^[6]

Paso 4. Confirma que tus scopes de OAuth incluyan los permisos de configuración de CRM necesarios. El grupo de scopes requerido abarca ZohoCRM.org.ALL, que otorga acceso a la configuración a nivel de organización, incluida la configuración de análisis. Sin los scopes correctos concedidos en el momento de la autorización OAuth, el endpoint devolverá un error de autorización. ^[8]

Paso 5. Una vez que recibas una respuesta, analiza el payload devuelto. Si estás creando enlaces o referencias hacia la interfaz de Zoho CRM, el patrón de URL base sigue el formato https://crm.zoho.{dc}/crm, donde {dc} es el sufijo de tu centro de datos (por ejemplo, com, eu, in). ^[5]

Errores comunes

• Token de acceso caducado o ausente. Si la conexión a la API no está autenticada, la llamada fallará de inmediato. Verifica siempre que la sesión esté activa antes de ejecutar la solicitud; un estado no autenticado requiere reiniciar el flujo OAuth. ^[3]
• Dominio de centro de datos incorrecto. Zoho CRM está alojado en múltiples centros de datos regionales. Enviar la solicitud a crm.zoho.com cuando tu cuenta está en crm.zoho.eu, por ejemplo, resultará en una llamada fallida o mal dirigida. Obtén el valor dc de tu registro de conexión almacenado y construye la URL base en consecuencia. ^[5]
• Scopes de OAuth insuficientes. Si los scopes no se configuraron para incluir acceso a nivel de organización del CRM cuando se autorizó la conexión OAuth por primera vez, el endpoint de dashboards rechazará la solicitud. Necesitarías volver a autorizar la conexión con el conjunto de scopes correcto. ^[8]

Qué verificar

• Confirma que la respuesta de la API contiene una lista de objetos de dashboard y que no devuelve un error de autenticación o permisos.
• Verifica que el valor dc en tu registro de conexión coincida con el centro de datos de Zoho en el que está registrada tu cuenta, para que toda la construcción de URLs posterior sea correcta. ^[5]
• Comprueba que los scopes de OAuth concedidos en el momento de la conexión incluyan ZohoCRM.org.ALL para garantizar que los endpoints a nivel de configuración permanezcan accesibles. ^[8]

---

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