Canaux de dossiers
Créez dans un centre de services l'adresse par laquelle un autre système ouvre des dossiers, et l'URL où Elion ITSM le prévient des réponses.
Sur cette page
Un canal de dossiers est la porte par laquelle un autre système (le formulaire de support de votre produit, votre site web, un chatbot) crée des dossiers dans un centre de services. Chaque canal comporte :
une URL pour créer des dossiers, qui identifie votre entreprise et l'espace ;
un secret d'entrée, avec lequel votre système signe ce qu'il envoie ;
en option, une URL de sortie (webhook) de votre système, où Elion ITSM envoie une notification quand l'équipe répond, change le statut ou résout, et un secret de sortie pour que votre système vérifie ces notifications.
Un espace peut avoir jusqu'à 10 canaux, un par système connecté.
Avant de commencer
Vous devez être Responsable de l'espace, ou disposer du niveau Administrer dans Espaces, groupes, règles, catégories, services et organisation.
L'espace doit être un centre de services (MDA, ESM ou CSM).
Si vous allez recevoir des notifications, préparez l'URL de votre système qui les recevra. Elle doit être en
https://et accessible depuis internet.
Créer un canal
Ouvrez l'espace et accédez à Réglages.
Ouvrez l'onglet Canaux de dossiers.
Cliquez sur Nouveau canal et remplissez :
Champ
Quoi saisir
Nom
Pour le reconnaître, par exemple « Formulaire de support de mon produit ».
URL de sortie (webhook, facultatif)
L'URL de votre système qui reçoit les notifications. Si vous la laissez vide, le demandeur reçoit les e-mails habituels d'Elion ITSM.
Événements
Les notifications à envoyer : Réponse de l'équipe, Changement de statut, Résolu, Clôturé et Enquête de satisfaction.
Valeurs par défaut des dossiers
Type, Groupe, Catégorie, Service, Impact et Urgence des dossiers si la requête ne les indique pas.
Qui peut ouvrir des dossiers
Créer le demandeur s'il n'existe pas, Demandeurs enregistrés uniquement ou Uniquement les e-mails de ces domaines (avec Domaines autorisés).
Enregistrez. Une fenêtre apparaît avec l'URL pour créer des dossiers (POST), le Secret d'entrée et, si vous avez indiqué une URL de sortie, le Secret de sortie.
Copiez-les avec les boutons Copier et transmettez-les à l'équipe de développement par un moyen sûr. Cliquez sur C'est fait, je les ai copiés.
L'URL et les secrets ne sont affichés qu'une seule fois. Si vous les perdez, renouvelez le secret : de nouveaux sont générés.
Administrer un canal
Dans la liste, vous voyez pour chaque canal s'il est actif, vers quel domaine il envoie les notifications, quand il a reçu le dernier dossier, quand il a envoyé la dernière notification et la dernière erreur. Les actions sont les suivantes :
Action | Ce qu'elle fait |
|---|---|
Modifier | Modifie le nom, l'URL de sortie, les événements, les valeurs par défaut et qui peut ouvrir des dossiers. Si vous indiquez une URL de sortie pour la première fois, son secret s'affiche. |
Mettre en pause / Activer | En pause, l'URL refuse les nouveaux dossiers et aucune notification n'est envoyée. |
Tester la sortie | Envoie une notification de test ( |
Renouveler le secret d'entrée | Génère une nouvelle URL et un nouveau secret. L'ancienne URL cesse immédiatement de fonctionner ; l'ancien secret reste valable 24 heures. |
Renouveler le secret de sortie | Génère un nouveau secret. Pendant 24 heures, les notifications portent les deux signatures, la nouvelle et l'ancienne. |
Voir les livraisons | Affiche les 50 dernières notifications envoyées avec leur statut : en file, nouvel essai, livré, échec ou ignoré. |
Supprimer | Retire le canal. Son URL cesse de fonctionner. Les dossiers déjà créés restent dans l'espace. |
Ce qui arrive aux dossiers
Ils arrivent dans l'espace du canal comme n'importe quel ticket, avec l'origine API, et suivent les règles d'affectation, le SLA et les notifications de l'espace.
Le demandeur est recherché par son e-mail. S'il n'existe pas et que le canal le permet, il est créé comme demandeur, sans mot de passe.
Si le dossier indique l'entreprise du demandeur, il est associé au compte portant ce RUT ou ce nom, et le compte est créé s'il n'existe pas.
Si le canal a une URL de sortie, Elion ITSM n'envoie pas d'e-mails au demandeur : c'est votre système qui le prévient. Les observateurs du dossier reçoivent quand même des e-mails.