Cómo recuperar botones personalizados en Zoho

Los botones personalizados en Zoho CRM se pueden recuperar y gestionar desde la página Buttons dentro de la configuración de personalización del CRM, y también se pueden ampliar con lógica de Client Script para un comportamiento más rico e interactivo directamente en la página del registro.

Por qué esto es importante

Si estás creando automatizaciones, experiencias de portal o extensiones para desarrolladores dentro de Zoho CRM, saber dónde localizar y editar los botones personalizados existentes ahorra un tiempo considerable en la resolución de problemas. Los botones personalizados te permiten activar lógica específica del registro, autocompletar campos y ejecutar flujos guiados de varios pasos, todo sin salir de la vista actual. ^[6] Entender cómo recuperarlos también es esencial antes de adjuntar Client Script o funciones de Deluge a un botón existente.

---

Paso a paso

Paso 1. Inicia sesión en tu cuenta de Zoho CRM como administrador. Ve a Setup (el icono de engranaje en la esquina superior derecha) y luego accede a Customization. Este es el centro principal para todas las personalizaciones a nivel de módulo, incluidos botones y enlaces. ^[6]

Paso 2. Dentro de Customization, selecciona Modules and Fields y elige el módulo específico (por ejemplo, Contacts, Deals o un módulo personalizado) cuyos botones deseas recuperar. Cada módulo mantiene su propio conjunto independiente de botones personalizados. ^[6]

Paso 3. Dentro del editor del módulo, localiza y haz clic en la sección Links and Buttons (a veces etiquetada como Custom Buttons). Esta página lista todos los botones personalizados que se han creado para ese módulo, junto con su tipo de ubicación — por ejemplo, Detail Page, List Page Bulk Action Menu o Related List. ^{[1] [6]}

Paso 4. Haz clic en cualquier nombre de botón de la lista para abrir su configuración. Aquí puedes revisar el nombre del botón, su ubicación, la función de Deluge o Client Script asociada, y cualquier restricción a nivel de perfil que controle qué usuarios lo ven. ^{[6] [3]}

Paso 5. Si necesitas recuperar o inspeccionar el Client Script adjunto a un botón, ten en cuenta que, aunque el botón en sí se crea desde la página Buttons, su Client Script se puede ver y editar por separado desde la página de configuración de Client Script. Ve a Setup > Developer Space > Client Script para encontrar el script vinculado. ^[6]

Paso 6. Para los botones utilizados dentro de Portals (Candidate, Client, Vendor o Custom), la ruta de recuperación es la misma página Buttons, pero también debes revisar la configuración de restricciones de Portal Profile para entender qué usuarios del portal pueden ver cada botón. ^[3] Estas asignaciones de perfil son visibles cuando abres la vista de edición del botón.

Paso 7. Si trabajas de forma programática y necesitas invocar la lógica subyacente de un botón mediante la API, la función de Deluge del botón puede llamar a las APIs de Zoho CRM internamente a través de la capa ZDK CRM APIs, que envuelve los endpoints REST estándar del CRM. ^[6] Revisa el código de la función adjunta al botón para identificar qué endpoints se están utilizando.

---

Errores comunes

• El Client Script no se puede crear desde la página de configuración de Client Script para botones. Debe iniciarse desde la propia página Buttons. Solo puedes *editar* el Client Script de un botón existente desde la página de configuración, no crear uno nuevo allí. ^[6]

• Los botones de List Page – Bulk Action pueden no autocompletar los IDs de los registros seleccionados en ciertos módulos personalizados. Si observas que el argumento List está vacío al activar un botón de acción masiva, verifica que el módulo esté correctamente configurado para pasar los IDs de los registros seleccionados a la función. Este es un caso límite conocido reportado en el módulo Packages. ^[1]

• Los botones de portal están restringidos por perfil. Si un botón personalizado no aparece para un usuario del portal, la causa más probable es que el botón no se haya asignado al perfil de portal correcto (por ejemplo, Candidate, Client o Vendor). Confirma siempre las asignaciones de perfil al recuperar botones destinados al uso en portales. ^[3]

• El alcance del módulo es importante. Los botones personalizados son específicos de cada módulo. Un botón creado para el módulo Contacts no aparecerá en la lista del módulo Deals. Si no puedes encontrar un botón, verifica que estés buscando en la página Buttons del módulo correcto. ^[6]

---

Qué verificar

• Confirma que el módulo correcto está seleccionado en la página Buttons — los botones tienen alcance por módulo y no aparecerán entre módulos distintos. ^[6]
• Verifica las asignaciones de perfil y portal si el botón está destinado a usuarios del portal, asegurándote de que el perfil de portal correcto (Candidate, Client, Vendor o Custom) esté habilitado en el botón. ^[3]
• Revisa la página de configuración de Client Script para confirmar si hay lógica de scripting adicional adjunta al botón más allá de la función de Deluge principal, especialmente si el comportamiento del botón parece incompleto. ^[6]

---

*Beam Help es un recurso de soporte experto independiente para los productos de Zoho y no es el soporte oficial de Zoho. Prueba siempre los cambios en los botones en un entorno de sandbox antes de implementarlos en producción.*