Apps de la barre latérale | Développeurs

Traduit pour votre confort. Le code, les noms de champs et la référence de l'API restent en anglais. Version anglaise

Les apps de la barre latérale affichent vos propres outils à côté du ticket : recherche de commandes, fiches CRM, actions internes. HelpFalcon exécute les apps écrites pour Zendesk App Framework (ZAF) v2 : beaucoup d’apps privées existantes s’installent sans changement.

Comment les apps s’exécutent

Chaque app tourne dans un iframe isolé et parle à HelpFalcon via le client ZAF, chargé depuis /apps/zaf_sdk.js à la place du fichier SDK de Zendesk.
client.get, client.set, client.invoke et les événements utilisent les noms ZAF v2 (ticket.subject, ticket.requester, currentUser, etc.).
Emplacements : ticket_sidebar, user_sidebar, top_bar (une icône avec popover) et nav_bar (une icône de la barre qui ouvre un grand panneau).

Appeler des API depuis une app

client.request() avec une URL relative /api/... s’exécute en tant qu’agent connecté.
Les URL absolues passent par un proxy côté serveur qui remplit les placeholders {{setting.name}}, y compris les réglages sécurisés, pour que les secrets n’atteignent jamais le navigateur. L’hôte doit figurer dans le domainWhitelist du manifeste (ou être un hôte supplémentaire autorisé par l’administrateur). Seul https est autorisé, les redirections ne sont pas suivies et les adresses de réseau privé sont refusées sauf autorisation de l’administrateur.
Les paramètres de type password sont toujours traités comme sécurisés. Les réglages sécurisés sont chiffrés au repos.

Hooks d’enregistrement et exigences

Les hooks ticket.save peuvent bloquer un envoi avec un message. Un hook qui ne répond pas sous 10 secondes ne bloque pas.
Les exigences du ticket s’appliquent aux mises à jour depuis l’espace agent, comme avec les apps Zendesk ; les mises à jour par API, e-mail et règles ne sont pas bloquées.

Installer

Les administrateurs installent et configurent les apps dans Admin Center, Integrations, Apps. Les restrictions par rôle et par groupe s’appliquent toutes deux quand elles sont définies ; les apps restreintes sont masquées et leurs appels au proxy refusés.

HelpFalcon inclut une app Jira intégrée.