Connecteur EasyVista ITSM
Le connecteur développé par Wikit utilise l'API de EasyVista et permet aux Apps de communiquer avec la solution EasyVista pour donner la possibilité à vos utilisateurs de créer et de suivre leurs tickets.
Informations nécessaires
| Nom du champ | Format / Type | Obligatoire | Commentaire |
|---|---|---|---|
| URL de l'instance EasyVista | URL | ✅ | URL de base de votre instance EasyVista |
| Format d'URL pour la visualisation | URL | ✅ | Format de lien d'auto-connexion permettant d'accéder directement à un ticket depuis Wikit (voir Configuration à réaliser) |
| Identifiant | Texte libre | ✅ | Identifiant du compte de service utilisé pour appeler l'API EasyVista |
| Mot de passe | Mot de passe | ✅ | Mot de passe associé au compte de service |
| Type d'identification des utilisateurs | Liste de valeurs | ➖ | Email ou Login — champ utilisé pour faire correspondre les utilisateurs Wikit aux employés EasyVista |
| Identifiant du compte Wikit | Texte libre | ➖ | Identifiant de l'employé "Wikit" créé dans EasyVista (voir Configuration à réaliser) |
💡 Les champs marqués ✅ sont obligatoires pour que le connecteur puisse fonctionner.
Configuration à réaliser
Créer un nouvel employé "Wikit"
Vous devez vous rendre dans l'onglet Administration (1) → Gestion des accès (2) → Employés (3)
Créer un profil "Webservices"
Le profil "Webservices" permettra de donner à l'utilisateur Wikit, les droits d'accéder à l'API Rest d'Easyvista. Pour cela vous devez vous rendre dans Administration puis Gestion des accès et Profils utilisateurs :
Cocher la case API Rest pour ce nouveau profil :
À partir de la roue crantée ⚙️, activer les différentes méthodes nécessaires au chatbot (GET et POST /requests et GET /requests/id) :
Récupérer le format d'URL pour la visualisation des tickets
Se référer à la documentation lien d'auto-connexion : https://docs.easyvista.com/docs/fr/auto-connect-link
Le lien obtenu sera ensuite à utiliser dans le champ Format d'URL pour la visualisation.
Fonctionnement du connecteur
Création de ticket
Depuis le chat Wikit Semantics, l'utilisateur peut créer un ticket EasyVista. Le connecteur appelle la méthode POST /requests de l'API REST EasyVista pour créer l'enregistrement, puis retourne à l'utilisateur un lien de suivi construit à partir du Format d'URL pour la visualisation.
Correspondance des utilisateurs
Le connecteur fait correspondre les utilisateurs Wikit aux employés EasyVista via le champ Type d'identification des utilisateurs, qui peut être défini sur Email ou Login.
Consultation de tickets
L'utilisateur peut également consulter ses tickets existants depuis le chat. Le connecteur interroge l'API EasyVista via les méthodes GET /requests et GET /requests/id.