Beam Help — soporte experto independiente para Zoho. Este artículo muestra formas prácticas de recuperar productos dentro de Zoho Desk para que los agentes o los scripts del cliente puedan mostrar registros de productos para tickets o widgets[8][7].
Por qué esto es importante
Los agentes a menudo necesitan vincular un producto a un ticket para que el historial de soporte y el contexto del activo viajen con la conversación[8]. Los desarrolladores y administradores que crean widgets del lado del cliente pueden necesitar obtener listas de productos (por ejemplo, por categoría) y devolver los elementos seleccionados al llamador[7].
Paso a paso
- Abre el módulo de Productos en Zoho Desk para ver los productos de la empresa. Los productos se gestionan a nivel de organización y están disponibles para que los agentes los asocien con tickets[8].[8]
- Usa los campos de producto en un ticket para vincular un artículo. Las entradas del módulo de Productos se pueden asociar con tickets para que los agentes registren de qué producto se trata un ticket[8].[8]
- Cuando necesites un selector personalizado o una lista filtrada, crea un widget que consulte el módulo de Productos. Los widgets pueden obtener productos basándose en una Categoría de Producto seleccionada y renderizar los resultados dentro de la interfaz de usuario del widget para su selección[7].[7]
- Prepara el código del widget para capturar y devolver selecciones al script del cliente. En el ejemplo del widget, los productos obtenidos se almacenan en una variable (searchresponse), se renderizan en el HTML del widget y los elementos seleccionados se recopilan en una matriz antes de devolverlos con $Client.close(selectedproducts)[7].[7]
- Sube el archivo zip del widget y créalo desde Configuración > Espacio del desarrollador > Widgets. Ve a Configuración, abre Espacio del desarrollador, elige Widgets y haz clic en Crear nuevo widget para subir la aplicación HTML empaquetada[7].[7]
- Establece la opción de alojamiento del widget en Zoho y especifica la página de entrada HTML; elige el tipo de botón para la renderización del script del cliente. El flujo de Creación de nuevo widget requiere que el Alojamiento se establezca en "Zoho", el nombre de la página que subiste, y el widget debe usar el tipo "botón" cuando planees lanzarlo desde un script del cliente[7].[7]
- Llama al widget desde tu script de cliente y recibe los productos seleccionados. El ejemplo del widget termina llamando a $Client.close(selected_products) para pasar los productos elegidos de vuelta al script del cliente y cerrar la ventana del widget[7].[7]
- Verifica la disponibilidad del producto y el acceso de los agentes en la Configuración de la empresa si los artículos no aparecen. La configuración del producto a nivel de empresa y los controles de asociación se encuentran en la Configuración de la empresa de Desk, en "Agregar y asociar productos con tickets", lo que afecta a cómo los productos están disponibles para los agentes[8].[8]
Errores comunes
- Si tu widget devuelve una lista vacía, confirma la lógica de filtrado de categorías de productos en el widget en lugar de asumir que Desk bloqueó la consulta; el ejemplo almacena los resultados en una variable search_response antes de renderizarlos[7].[7]
- Si los agentes no pueden vincular productos a tickets, verifica que los productos existan en la lista de productos de la empresa y que la configuración de tu organización exponga los productos a los agentes como se espera[8].[8]
Qué verificar
- Confirma que el producto aparece en tu lista de Productos de la empresa de Zoho Desk y que está configurado para usarse con tickets[8].[8]
- Si usas un widget, verifica que tu widget se haya subido a través de Configuración > Espacio del desarrollador > Widgets, que el alojamiento esté configurado en Zoho y que el tipo de widget sea "botón" cuando se invoque desde un script del cliente[7].[7]
- Asegúrate de que tu widget devuelva las selecciones usando $Client.close(selected_products) para que el script del cliente reciba los objetos de producto elegidos[7].[7]