Apps da barra lateral

Os apps da barra lateral mostram as suas próprias ferramentas ao lado do ticket: consulta de pedidos, registros do CRM, ações internas. O HelpFalcon executa apps escritos para o Zendesk App Framework (ZAF) v2, então muitos apps privados existentes instalam sem mudanças.

Como os apps rodam

• Cada app roda num iframe isolado e conversa com o HelpFalcon pelo cliente ZAF, carregado de /apps/zaf_sdk.js no lugar do arquivo SDK do Zendesk.
• client.get, client.set, client.invoke e os eventos usam os nomes do ZAF v2 (ticket.subject, ticket.requester, currentUser etc.).
• Locais: ticket_sidebar, user_sidebar, top_bar (um ícone com popover) e nav_bar (um ícone na barra que abre um painel grande).

Chamar APIs a partir de um app

• client.request() com uma URL relativa /api/... roda como o agente conectado.
• URLs absolutas passam por um proxy no servidor que preenche os placeholders {{setting.name}}, incluindo configurações seguras, para que segredos nunca cheguem ao navegador. O host precisa estar no domainWhitelist do manifesto (ou ser um host extra que o administrador permita). Só https é permitido, redirecionamentos não são seguidos e endereços de rede privada são recusados, a menos que o administrador os permita.
• Parâmetros do tipo password são sempre tratados como seguros. Configurações seguras são guardadas criptografadas.

Hooks de salvamento e requisitos

• Hooks ticket.save podem bloquear um envio com uma mensagem. Um hook que não responde em 10 segundos não bloqueia.
• Os requisitos do ticket valem para atualizações feitas no espaço de agentes, como nos apps do Zendesk; atualizações por API, e-mail e regras não são bloqueadas.

Instalar

Administradores instalam e configuram apps em Admin Center, Integrations, Apps. Restrições por função e por grupo valem as duas quando definidas; apps restritos ficam ocultos e as chamadas deles ao proxy são recusadas.

O HelpFalcon vem com um app do Jira integrado.