Vous êtes déjà client NinjaOne ? Connectez-vous pour consulter d'autres guides et les dernières nouvelles.

Démarrer avec l’intégration de Freshservice ITSM dans NinjaOne

Sujet

Intégrez votre compte Freshservice à NinjaOne pour permettre à vos utilisateurs de se connecter et de mapper les fonctions ITSM entre les deux plateformes. 

Environnement

  • Intégrations NinjaOne
  • Freshservice

Description

Grâce à l'intégration Freshservice, vous pouvez : 

  • Créer automatiquement des tickets Freshservice à partir des conditions de politique NinjaOne.
  • Automatiser les mises à jour des tickets lorsqu'une condition précédemment déclenchée est réactivée. 
  • Automatiser la mise en correspondance des appareils NinjaOne avec les actifs Freshservice. NinjaOne associera automatiquement tout actif Freshservice préexistant aux tickets Freshservice qu'il crée si le numéro de série de l'appareil correspond. De même, pour tout ticket Freshservice lié à un actif Freshservice, l'application NinjaOne Freshservice de la barre latérale tentera de localiser l'appareil NinjaOne correspondant à l'aide du numéro de série.
  • Découvrez les appareils NinjaOne par ID d'actif et numéro de série, et accédez-y à distance.

Nous travaillons à apporter une valeur ajoutée supplémentaire dans les prochaines versions, notamment la possibilité de mapper les organisations NinjaOne aux entreprises Freshservice. Veuillez soumettre vos suggestions ou demandes de fonctionnalités via notre formulaire de soumission d'idées

Sélectionnez une catégorie pour en savoir plus : 

Remarques importantes

Veuillez tenir compte des informations suivantes : 

  • La barre d'état système NinjaOne ne prend actuellement pas en charge la création de tickets Freshservice. Nous prévoyons d'ajouter cette fonctionnalité dans une prochaine version.
  • L'authentification est entièrement gérée par Freshservice.
  • L'état de l'intégration est indiqué dans Freshservice et NinjaOne.
  • Les pages d'activité du tableau de bord NinjaOne indiqueront si l'intégration est activée ou désactivée. 

Donnez aux techniciens l'accès à la fonctionnalité d'intégration

Vous devez définir les autorisations des techniciens ou des rôles sur « Autorisé » pour la configuration des intégrations ITSM/PSA. Vous trouverez cette autorisation dans la section Système.

ITSM permission.png
Figure 1 : NinjaOne → Administration → Comptes → Configuration du compte technicien → Autorisations système

Préparez la clé API pour l'intégration

Pour activer l'intégration dans NinjaOne, vous devrez fournir une clé API. Pour trouver votre clé API, consultez la page « Où trouver ma clé API ? » : Freshservice (lien externe). 

Activer l'intégration dans NinjaOne

Pour activer l'intégration Freshservice dans NinjaOne, procédez comme suit :

  1. Dans NinjaOne, accédez à AdministrationApplicationsInstallées et cliquez sur Ajouter une application

admin_apps_add app.png
Figure 2 : NinjaOne → Administration → Applications → Installées → Ajouter une application

  1. Sélectionnez Freshservice dans la liste et cliquez sur Continuer dans la fenêtre de confirmation.
    La page de configuration de l'application Freshservice s'affiche. 
  2. Cliquez sur Activer.
    La fenêtre contextuelle Paramètres de connexion s'affiche. 
  3. Utilisez le tableau suivant pour remplir les champs correspondants. 

    ChampDonnées
    Sous-domaine FreshserviceSaisissez le texte qui précède « freshservice.com » dans le champ URL de votre compte Freshservice. Ne saisissez pas l'URL complète. Parexemple, si l'URL est « ninjaone.freshservice.com », vous saisirez « ninjaone » dans ce champ.
    Clé APISaisissez la clé API que vous avez obtenue depuis votre compte Freshservice. 
    E-mail du demandeurL'adresse e-mail que vous fournissez recevra des notifications lors de la création d'un ticket. 
  4. Cliquez sur Enregistrer.

Configurer l'intégration Freshservice dans NinjaOne

Après avoir activé l'intégration, vous devez configurer les paramètres pour vous assurer que toutes les données sont correctement mappées et synchronisées entre Freshservice et NinjaOne. 

Paramètres par défaut 

Les paramètres par défaut déterminent le comportement des tickets Freshservice. 

Sur la page de configuration de l'application Freshservice dans NinjaOne, cliquez sur Modifier dans le widget Paramètres par défaut

freshservice_defaults.png
Figure 3 : NinjaOne → Configuration de l'application Freshservice → Modifier les paramètres par défaut

Une valeur d'ID d'espace de travail est requise pour activer la création de tickets. Vous pouvez trouver ces données dans Freshservice sous Paramètres générauxParamètres de l'espace de travail. Les pages des paramètres de l'espace de travail sont numérotées dans l'URL ; par exemple, si l'URL est ninjaonehelpdesk.freshservice.com/ws/2/admin/home, le champ ID de l'espace de travail doit avoir la valeur « 2 ».

Si vous laissez le champ ID de l'espace de travail vide ou si vous indiquez une valeur non valide, le champ sera automatiquement renseigné avec l'espace de travail désigné comme « principal » dans Freshservice.

Modèles de tickets

Pour créer un nouveau modèle de ticket, procédez comme suit : 

  1. Ouvrez l'onglet Modèles de tickets et cliquez sur Ajouter.

freshservice_ticket templates.png
Figure 4 : NinjaOne → Configuration de l'application Freshservice → Ajouter un modèle de ticket

  1. Utilisez le tableau suivant comme guide pour remplir les champs. 
OngletDonnées
GénéralDonnez un nom au modèle pour l'identifier.
Création de ticketAttribuez un statut et une priorité à tous les tickets qui utilisent ce modèle.
Réinitialisation de la conditionSélectionnez l'action qui sera effectuée en fonction du statut actuel du ticket. Vous pouvez choisir de ne rien faire ou de modifier le statut du ticket (par exemple, si la condition est réinitialisée, vous pouvez faire en sorte que le ticket revienne au statut « ouvert »).
Vous pouvez sélectionner plusieurs statuts dans le menu déroulant « Si le statut est ». 
Redéclenchement de la conditionSélectionnez l'action qui se produira en fonction du statut actuel du ticket. Vous pouvez créer un nouveau ticket ou ajouter des informations à un ticket existant. Si vous créez un nouveau ticket, les autres champs de la page seront désactivés, et le statut et la priorité seront définis par défaut selon la sélection effectuée dans la section Création de ticket.
  1. Attribuez le modèle à une politique pour les conditions déclenchées. Pour savoir comment procéder, consultez la section Utiliser Freshservice dans NinjaOne pour créer des tickets.

Le premier modèle de ticket que vous créez sera attribué par défaut. Vous ne pouvez pas modifier le paramètre par défaut tant que vous n'avez pas créé de modèle supplémentaire. Vous ne pouvez pas supprimer les modèles par défaut ni les modèles attribués à des conditions. 

La colonne « Utilisations » indique le nombre de politiques (conditions et automatisations planifiées) ou d’activités utilisant ce modèle spécifique. Ce nombre est un lien hypertexte ; cliquez dessus pour afficher les détails d’utilisation. Cette colonne est mise à jour lorsque vous ajoutez ou supprimez des affectations de modèles. 

Pour modifier les paramètres du modèle, cochez la case à côté du nom du modèle et cliquez sur Modifier. Vous trouverez des options de gestion supplémentaires si le modèle n'est pas défini comme modèle par défaut. 

freshservice_ticket templates_usages.png
Figure 5 : NinjaOne → Configuration de l'application Freshservice → Modifier le modèle de ticket ou afficher l'utilisation

Mappages d'organisations

Le mappage de vos organisations NinjaOne à vos départements Freshservice garantit que les tickets sont associés aux bons clients. Une fois le mappage effectué, le nom de l'organisation s'affichera sur le ticket dans Freshservice. Si l'organisation n'est pas mappée au département, les tickets n'afficheront que l'adresse e-mail par défaut du demandeur. 

Une fois l'intégration Freshservice activée dans NinjaOne, l'onglet Mappages d'organisations de la page de configuration de l'application se met automatiquement à jour avec la liste de toutes les organisations créées dans votre compte NinjaOne. Vous devez mapper manuellement l'organisation au service correspondant dans votre compte Freshservice. 

Pour savoir comment ajouter des services dans Freshservice, consultez la documentation d'assistance de Freshservice, Gestion des utilisateurs : Freshservice (lien externe). 

Pour associer les organisations NinjaOne aux services Freshservice :

  1. Ouvrez l'onglet « Mappages d'organisations » sur la page d'intégration de Freshservice. 
  2. Cochez la case à gauche du nom de l'organisation, placez votre curseur sur la ligne, puis cliquez sur le bouton représentant trois points situé à l'extrême droite. 
  3. Cliquez sur Modifier

freshservice_org mapping.png
Figure 6 : NinjaOne → Configuration de l'application Freshservice → Modifier le mappage d'organisations

La fenêtre contextuelle Modifier les paramètres s'affiche. 

  1. Sélectionnez le nom du service Freshservice qui sera associé à l'organisation NinjaOne dans le menu déroulant.
  2. Saisissez l'adresse e-mail de votre compte Freshservice dans le champ E-mail du demandeur
  3. Cliquez sur Enregistrer.

Une fois le mappage terminé, vous pouvez le sélectionner à nouveau pour mettre à jour ou effacer les données.

freshservice_org mapping_edit or clear.png
Figure 7 : Modifier ou effacer un mappage d'organisation

Installer l'application Marketplace

Vous pouvez installer l'application NinjaOne du Marketplace dans Freshservice pour améliorer l'accès aux appareils et aux outils à distance. 

Pour installer l'application, accédez à Paramètres générauxApplications et ouvrez l'onglet Applications personnalisées. Recherchez l'application personnalisée NinjaOne et cliquez sur Installer


Figure 8 : Installer l'application NinjaOne dans le Marketplace de Freshservice (cliquez pour agrandir)

Ressources supplémentaires

Consultez les ressources suivantes pour en savoir plus sur Freshservice :

FAQ

Pour aller plus loin