Recuperar la información de tu organización en Zoho CRM se puede hacer a través del área integrada de Configuración de la empresa en la interfaz de usuario o mediante programación a través del endpoint OAuth de Zoho Accounts — ambos enfoques exponen identificadores clave de la organización y detalles de configuración.
Por qué es importante
Saber dónde encontrar y cómo recuperar la información de la organización es esencial cuando estás configurando integraciones, auditando tu configuración de CRM o construyendo aplicaciones personalizadas que necesitan identificar a qué organización de Zoho CRM están conectadas. Los administradores regularmente necesitan estos detalles para configurar años fiscales, horarios comerciales, configuración de moneda y preferencias de jerarquía. Los desarrolladores que construyen aplicaciones conectadas por OAuth deben resolver de manera confiable el ID de la organización y el nombre de la organización antes de hacer llamadas API posteriores.
Paso a paso
Opción A — Usando la interfaz de usuario de Zoho CRM (Administrador)
Paso 1. Inicia sesión en Zoho CRM con una cuenta que tenga el perfil de Administrador. Solo se recomienda que los administradores vean y personalicen detalles específicos de la empresa que diferencien una organización de otra. [6]
Paso 2. Navega a Configuración (el icono de engranaje en la esquina superior derecha), luego localiza la sección Configuración de la empresa. Esta área contiene detalles específicos de la organización, incluyendo configuración de año fiscal, horarios comerciales, preferencias de jerarquía y opciones de múltiples monedas. [6]
Paso 3. Abre Administrar configuración de la empresa para revisar o editar el perfil principal de tu organización — cosas como nombre de la empresa, dirección y zona horaria. Estos campos son los que Zoho CRM utiliza para distinguir tu organización de otras en la plataforma. [6]
Paso 4. Mientras estés en Configuración de la empresa, explora subsecciones según sea necesario:
- Configurar año fiscal — define el período de 12 meses que tu organización utiliza para la planificación y seguimiento de ventas. [6]
- Administrar horarios comerciales — establece horarios de trabajo según la ubicación de tu empresa, importante si tienes oficinas en múltiples países. [6]
- Administrar preferencia de jerarquía — controla cómo se estructura el acceso a datos entre usuarios por designación. [6]
- Administrar múltiples monedas — relevante si tu organización maneja transacciones internacionales. [6]
---
Opción B — Recuperar información de la organización mediante programación a través de OAuth
Paso 1. Completa el flujo OAuth 2.0 para tu integración de Zoho CRM para obtener un token de acceso válido. Sin un token, el endpoint de información de usuario/organización rechazará la solicitud. [4]
Paso 2. Realiza una solicitud GET al endpoint de información de usuario de Zoho Accounts:
GET https://accounts.zoho.<DC>/oauth/user/info
Authorization: Bearer <access_token>Reemplaza <DC> con tu sufijo de centro de datos (por ejemplo, com, eu, in, com.au). La respuesta contiene detalles de usuario y organización. [4]
Paso 3. Analiza la respuesta JSON para extraer los campos que necesitas. Los campos clave a buscar incluyen:
ZUID— el ID de usuario de Zoho. [4]Email— la dirección de correo electrónico del usuario autenticado. [4]- ID de organización — los nombres de campo varían según el centro de datos; busca
orgid,organizationidoZGIDen ese orden. Para organizaciones de un solo usuario, recurrir aZUIDes un enfoque razonable. [4] - Nombre de la organización — de manera similar, intenta
companyname,organizationnameoCompany_Nameen secuencia. Si ninguno está presente, la porción de dominio de la dirección de correo electrónico puede servir como etiqueta de respaldo. [4]
Paso 4. Almacena el crmorgid resuelto de forma segura (por ejemplo, en una tabla zoho_connections indexada por ID de conexión) para que las llamadas API posteriores puedan hacer referencia a la organización correcta sin volver a obtenerla. [5]
---
Errores comunes
- Los nombres de campo difieren según el centro de datos. Los campos de ID de organización y nombre de organización devueltos por
https://accounts.zoho.<DC>/oauth/user/infono son consistentes en todos los centros de datos de Zoho. Siempre implementa una cadena de respaldo en lugar de asumir que un único nombre de campo estará presente. [4] - Las organizaciones de un solo usuario pueden no devolver un ID de organización distinto. En este caso extremo, usar
ZUIDcomo identificador de organización proxy es una solución aceptada, pero ten en cuenta que es un identificador a nivel de usuario — no a nivel de organización. [4] - La configuración de la empresa es solo para administradores. Si un no administrador navega a Configuración, puede que no vea el menú completo de Configuración de la empresa. Asegúrate de que el perfil correcto esté asignado antes de solucionar problemas de elementos de menú faltantes. [6]
- Los campos de cuenta sincronizados son limitados. Si estás extrayendo datos de organización/cuenta en una integración de Zoho Desk–CRM, solo un conjunto definido de campos (Teléfono, Correo electrónico, Fax, Sitio web, Industria, Ingresos anuales, campos de dirección y Descripción) se asignarán. Los campos fuera de esta lista no se sincronizarán automáticamente. [2]
Qué verificar
- Confirma que tu sufijo de centro de datos es correcto en la URL del endpoint OAuth — una discrepancia devolverá un error de autenticación en lugar de datos de organización. [4]
- Verifica que el acceso de administrador esté activo para la cuenta que estás usando para navegar por la Configuración de la empresa en la interfaz de usuario de Zoho CRM. [6]
- Comprueba el
crmorgidalmacenado contra el valor devuelto por el endpoint de información de usuario después de cualquier re-autenticación para asegurar que el registro de conexión se mantenga preciso. [5]
---
*Beam Help es un recurso de soporte experto independiente para productos de Zoho y no es soporte oficial de Zoho. Para problemas de cuenta a nivel de plataforma, contacta a Zoho directamente a través de su portal de soporte.*