Connecteur iTop ITSM

Le connecteur développé par Wikit utilise l’API de Itop et permet aux Apps de communiquer avec la solution Itop pour donner la possibilité à vos utilisateurs de créer et de suivre leurs tickets.

Prérequis

• Les webservices REST d'iTop accessibles depuis les serveurs Wikit (/webservices/rest.php?version=).

Informations nécessaires

Nom du champ	Format / Type	Obligatoire	Commentaire
Url des webservices	URL	✅	Format : https:///webservices/rest.php?version=
Un code d'organisation où créer les tickets	Identifiant / Texte libre	✅	Code de l'organisation iTop dans laquelle les tickets seront créés
Un utilisateur Wikit (login/password)	Texte libre	✅	Utilisateur avec un Numéro d'employé WIKIT dépendant de l'organisation, disposant du profil REST SERVICE

💡 Les champs marqués ✅ sont obligatoires pour que le connecteur puisse fonctionner.

Configuration à réaliser

Trouver l'url des webservices

Pour trouver l'url des webservices, vous pouvez vous rendre dans l'onglet Informations Systèmes :

Trouver le code organisation

Pour trouver le code de votre organisation, vous pouvez vous rendre sur votre compte puis placer votre souris sur le nom de votre organisation et vous trouverez son identifiant :

*Ici dans cet exemple, le code organisation est Demo et son identifiant est 3*

Créer un utilisateur Wikit

Pour créer un utilisateur Wikit, rendez-vous dans le menu Administration puis cliquez sur Comptes utilisateurs :

Ensuite, cliquez sur le bouton + :

Activer le profil REST SERVICE sur l'utilisateur Wikit

Une fois avoir cliqué sur le bouton créer puis renseignez les informations de l'utilisateur Wikit, sélectionnez via la liste déroulante le profil REST SERVICE à lui attribuer :

Fonctionnement du connecteur

Création de ticket

Depuis le chat Wikit Semantics, l'utilisateur peut créer un ticket iTop dans l'organisation configurée (Un code d'organisation où créer les tickets). Le ticket est créé via les webservices REST d'iTop, avec l'utilisateur Wikit disposant du profil REST SERVICE.

Catégorisation iTop dans Wikit Semantics

Si vous souhaitez mettre en place un système de catégorisation dans votre application Wikit Semantics, je vous invite à suivre cette documentation en ligne tout en respectant le format de l'API d'iTop : https://docs.wikit.ai/wikit_semantics/categorization_of_itsm_tickets

Pour trouver la liste des services de votre organisation, vous devez vous rendre dans Gestion des services puis cliquez sur Services. Pour trouver l'identifiant de votre service, il suffit de cliquer sur le nom de votre service et vous retrouverez celui-ci dans l'url de votre navigateur :

Pour trouver la liste des sous-catégories de service de votre organisation, vous devez vous rendre dans Gestion des services puis cliquez sur Sous-catégorie de service. Pour trouver l'identifiant de votre sous-catégorie de service, il suffit de cliquer sur le nom de votre sous-catégorie et vous retrouverez celui-ci dans l'url de votre navigateur :

À titre d'exemple :

• le format pour le service : service_id
• le format pour la sous-catégorie d'un service : servicesubcategory_id

Vous pouvez aussi utiliser uniquement la redirection vers un formulaire externe en activant l'option tout simplement :