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

Thème

Intégrez votre compte Freshservice à NinjaOne pour permettre à vos utilisateurs de se connecter et de mapper les fonctions ITSM entre les 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 la politique NinjaOne.
  • Automatiser les mises à jour des tickets lorsqu'une condition précédemment déclenchée est réactivée. 
  • Automatiser la correspondance entre les appareils NinjaOne et 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 dans 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 à offrir une valeur ajoutée 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.
  • Le statut de l'intégration est indiqué dans Freshservice et NinjaOne.
  • Les pages Activité du tableau de bord NinjaOne incluront des informations sur l'activation ou la désactivation de l'intégration. 

Donner 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 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 applicables. 

    ChampDonnées
    Sous-domaine Freshservice

    Saisissez le texte qui précède « freshservice.com » dans le champ URL de votre compte Freshservice. Ne saisissez pas l'URL complète. 

    Par exemple, si l'URL est « ninjaone.freshservice.com », vous entrerez « ninjaone » dans ce champ.
    Clé APIEntrez la clé API que vous avez obtenue à partir de votre compte Freshservice. 
    E-mail du demandeurL'adresse e-mail que vous fournissez recevra des notifications lors de la création de tickets. 
  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 permettre la création de tickets. Vous trouverez ces données dans Freshservice sous Paramètres générauxParamètres de l'espace de travail. Les pages 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 fournissez une valeur non valide, l'espace de travail désigné comme « principal » dans Freshservice sera automatiquement renseigné.

Modèles de ticket

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

  1. Ouvrez l'onglet Modèles de ticket 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 afin de pouvoir 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 remettre le ticket au statut « ouvert »).
Vous pouvez sélectionner plusieurs statuts dans le menu déroulant Si le statut est
Rétriggerage de la conditionSélectionnez l'action qui sera effectuée 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 par défaut ceux sélectionnés 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 attributions 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'organisation

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'affiche sur le ticket dans Freshservice. Si l'organisation n'est pas mappée au département, les tickets n'affichent que l'expéditeur par défaut. 

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 départements dans Freshservice, consultez la documentation d'assistance de Freshservice, Gestion des utilisateurs : Freshservice (lien externe). 

Pour mapper les organisations NinjaOne aux départements Freshservice :

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

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

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

  1. Sélectionnez le nom du service Freshservice qui sera lié à 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 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

freshservice marketplace app.png
Figure 8 : Installer l'application NinjaOne dans Freshservice Marketplace (cliquez pour agrandir)

Ressources supplémentaires

Consultez les ressources suivantes pour en savoir plus sur Freshservice :

FAQ

Pour aller plus loin