Apps de la barra lateral | Desarrolladores

Traducido para tu comodidad. El código, los nombres de campos y la referencia de la API siguen en inglés. Versión en inglés

Las apps de la barra lateral muestran tus propias herramientas junto al ticket: consultas de pedidos, fichas del CRM, acciones internas. HelpFalcon ejecuta apps escritas para Zendesk App Framework (ZAF) v2, así que muchas apps privadas existentes se instalan sin cambios.

Cómo funcionan las apps

Cada app se ejecuta en un iframe aislado y habla con HelpFalcon a través del cliente ZAF, cargado desde /apps/zaf_sdk.js en lugar del archivo SDK de Zendesk.
client.get, client.set, client.invoke y los eventos usan los nombres de ZAF v2 (ticket.subject, ticket.requester, currentUser, etc.).
Ubicaciones: ticket_sidebar, user_sidebar, top_bar (un icono con un popover) y nav_bar (un icono en la barra que abre un panel grande).

Llamar a APIs desde una app

client.request() con una URL relativa /api/... se ejecuta como el agente que ha iniciado sesión.
Las URL absolutas pasan por un proxy del lado del servidor que rellena los marcadores {{setting.name}}, incluidos los ajustes seguros, para que los secretos nunca lleguen al navegador. El host debe estar en el domainWhitelist del manifiesto (o ser un host adicional que permita el administrador). Solo se admite https, no se siguen redirecciones y se rechazan las direcciones de red privadas salvo que el administrador las permita.
Los parámetros de tipo password siempre se tratan como seguros. Los ajustes seguros se guardan cifrados.

Hooks de guardado y requisitos

Los hooks ticket.save pueden bloquear un envío con un mensaje. Un hook que no responde en 10 segundos no bloquea.
Los requisitos del ticket se aplican a las actualizaciones desde el espacio de agentes, como con las apps de Zendesk; las actualizaciones por API, correo y reglas no se bloquean.

Instalar

Los administradores instalan y configuran apps en Admin Center, Integrations, Apps. Las restricciones por rol y por grupo se aplican ambas cuando están definidas; las apps restringidas se ocultan y sus llamadas al proxy se rechazan.

HelpFalcon incluye una app de Jira integrada.