Cómo recuperar un usuario específico del portal en Zoho CRM

Recuperar un usuario específico del portal en Zoho CRM se realiza de forma más confiable a través del objeto $Crm.user disponible en Client Scripts, que expone los detalles completos de identidad y rol de quien está actualmente conectado al portal.

Por qué esto es importante

Cuando construyes un Portal de Zoho CRM para clientes o socios, a menudo necesitas personalizar la experiencia — mostrando solo registros relevantes, aplicando reglas a nivel de campo, o lógica condicional basada en quién está viendo la página. Saber cómo recuperar programáticamente los detalles del usuario actual del portal te permite adaptar Client Scripts a usuarios individuales o tipos de usuario completos sin duplicar código. Esto es especialmente útil en soluciones verticales donde diferentes perfiles de portal necesitan comportamientos diferentes. ^[1]

Paso a paso

Paso 1. Confirma que el soporte de Client Script para Portales está habilitado en tu organización de Zoho CRM. Esta función se ha implementado en todos los centros de datos, por lo que debería estar disponible por defecto — pero verifica que esté activa en tu configuración de desarrollador o portal antes de escribir cualquier script. ^[1]

Paso 2. Abre el editor de Client Script para tu portal. Debido a que los Client Scripts existentes se extienden automáticamente a los portales, no necesitas crear un script completamente nuevo desde cero. Cualquier script que ya hayas escrito funcionará dentro del contexto del portal sin necesidad de reescribirlo o duplicarlo. ^[1]

Paso 3. Dentro de tu Client Script, llama a $Crm.user para recuperar los detalles del usuario actualmente autenticado. Este objeto único devuelve todos los campos de identidad que necesitas para lógica condicional. ^[1]

Paso 4. Inspecciona el campo type devuelto por $Crm.user para distinguir entre un usuario regular de CRM y un usuario del portal. Un usuario interno estándar devuelve "type": "Regular User", mientras que una cuenta de portal orientada al cliente devuelve "type": "Client Portal User". ^[1]

Paso 5. Utiliza los campos restantes de la respuesta $Crm.user para identificar al individuo específico. El objeto incluye:

• id — el ID único del registro de CRM para el usuario
• zuid — el ID de usuario de Zoho vinculado a su cuenta de Zoho
• fullname, firstname, last_name — campos de nombre para mostrar
• email — la dirección de correo electrónico registrada del usuario
• profile.id y profile.name — el perfil del portal asignado (p. ej., "ClientPortal")
• role.id y role.name — el rol asignado dentro del portal (p. ej., "Portal User") ^[1]

Paso 6. Para dirigirse a un *usuario específico* del portal en tu lógica de script, compara el valor id, email o zuid de $Crm.user contra un valor conocido. Por ejemplo, puedes ramificar tu script para que ciertas validaciones de campo o cambios de interfaz de usuario solo se apliquen cuando $Crm.user.email coincida con una dirección particular. ^[1]

Paso 7. Para dirigirse a un *tipo de usuario* completo en lugar de un individuo, verifica $Crm.user.type. Cuando el valor es igual a "Client Portal User", sabes que el espectador es un participante del portal en lugar de un miembro del equipo interno, y puedes aplicar personalizaciones en todo el portal en consecuencia. ^[1]

Paso 8. Si necesitas gestionar usuarios del portal fuera de scripts — por ejemplo, para activar, desactivar o eliminar un usuario — navega a Custom Portals, abre el portal relevante, ve a la pestaña Users, localiza la dirección de correo electrónico del usuario y haz clic en el icono More Options para elegir la acción apropiada. ^[7]

Errores comunes

• Confundir id con zuid: El campo id es el identificador de registro interno de CRM, mientras que zuid es el identificador de cuenta de Zoho entre productos. Usa id cuando consultes registros de CRM y zuid cuando necesites correlacionar entre servicios de Zoho. ^[1]
• Asumir que todos los usuarios son usuarios del portal: Si tu script se ejecuta tanto en la interfaz estándar de CRM como en el portal, siempre verifica $Crm.user.type antes de aplicar lógica específica del portal. Aplicar reglas del portal a un "Regular User" puede causar comportamiento inesperado. ^[1]
• Confusión entre perfil y rol: El objeto profile refleja el perfil del portal (controlando qué módulos son visibles), mientras que role refleja la posición del usuario en la jerarquía del portal. Estos son conceptos separados — no los uses indistintamente al escribir lógica condicional. ^[1]
• Invitaciones vs. usuarios activos: Un usuario que ha sido invitado pero aún no ha aceptado no aparecerá en la pestaña Users activa. Verifica la pestaña Invitations si un usuario que esperas encontrar falta en la lista. ^[7]

Qué verificar

• Verifica que $Crm.user.type devuelva "Client Portal User" cuando previsualizas el portal como una cuenta de portal de prueba, confirmando que el script se ejecuta en el contexto correcto. ^[1]
• Confirma que los valores profile.name y role.name coincidan con el perfil del portal y el rol que configuraste para ese usuario en la configuración del portal. ^[1]
• Después de cualquier acción de gestión de usuarios (activar, desactivar, eliminar), regresa a la pestaña Users en la sección Custom Portals para confirmar que el cambio se refleja en la lista de usuarios. ^[7]

---

*Beam Help es un recurso de soporte experto independiente para productos de Zoho y no es soporte oficial de Zoho. Siempre prueba los cambios de Client Script en un entorno sandbox o de desarrollador antes de implementar en producción.*