Aller au contenu principal

Intégration HaloPSA

Connectez Palisade à HaloPSA pour importer automatiquement les domaines, créer des billets et synchroniser la facturation.

Lisez d’abord l’Aperçu des intégrations PSA si ce n’est pas déjà fait. Il couvre les deux choses qui empêchent le plus souvent les billets d’atteindre un PSA : l’association à un groupe dont chaque domaine a besoin, et le délai de quatre heures avant l’envoi d’une nouvelle tâche.

Étape 1 : créer un agent réservé à l’API dans HaloPSA​

  1. Dans HaloPSA, rendez-vous dans Configuration > Agents.
  2. Cliquez sur New pour créer un nouvel agent.
  3. Cochez la case API Agent pour en faire un agent réservé à l’API.
  4. Assignez l’agent à l’équipe et au service appropriés.
  5. Enregistrez l’agent.

Étape 2 : accorder les autorisations​

Configurez les autorisations suivantes pour l’agent d’API :

Autorisations des modules :

  • Tickets : Read and Modify
  • Customers : Read Only
  • Users : Read Only (Palisade déduit les domaines des contacts de chaque client : sans cette autorisation, l’importation des domaines ne retourne rien)
  • Projects : Read and Modify (voir la note ci-dessous)

Autorisations des billets :

  • Can add new tickets
  • Can view unassigned tickets
  • Can view others’ tickets
  • Can edit others’ tickets (sans elle, les mises à jour d’état échouent avec le message « You do not have permission to update this Ticket »)
info

Palisade crée deux éléments dans votre HaloPSA pendant la configuration. Lors de la configuration de la connexion, Palisade crée un projet nommé Palisade DMARC et une tâche Import Domains dans ce projet, puis les réutilise lors des connexions suivantes plutôt que de créer des doublons. C’est pourquoi l’agent d’API a besoin de l’accès en lecture et en modification aux projets. Rien d’autre n’est écrit en dehors des billets que Palisade ouvre.

Étape 3 : créer une application d’API​

  1. Rendez-vous dans Configuration > Integrations > HaloPSA API.
  2. Créez une nouvelle application d’API.
  3. Notez les renseignements suivants :
    • Server Host : le nom d’hôte de votre serveur HaloPSA (voir l’avertissement ci-dessous)
    • Client ID
    • Client Secret
  4. Réglez la méthode d’authentification à Client ID and Secret.
  5. Réglez l’agent sous lequel se connecter à l’agent d’API créé à l’étape 1.
  6. Configurez les autorisations de l’application :
    • Read/Edit Tickets
    • Read Customers
    • Read Users/Contacts
avertissement

Utilisez votre domaine HaloPSA de base comme Server Host. N’incluez pas https:// ni /api dans le nom d’hôte. N’utilisez pas de domaine personnalisé : utilisez le domaine d’origine fourni par HaloPSA.

conseil

Copiez votre Client ID et votre Client Secret immédiatement après leur création. Le Client Secret pourrait ne plus être accessible par la suite.

Étape 4 : configurer dans Palisade​

  1. Dans Palisade, rendez-vous sur la page Intégrations.
  2. Choisissez HaloPSA comme PSA.
  3. Saisissez les identifiants suivants :
    • Server Host : le nom d’hôte de votre serveur HaloPSA (sans https:// ni /api)
    • Client ID : celui de l’application d’API
    • Client Secret : celui de l’application d’API
  4. Cliquez sur Connecter pour établir la connexion.
  5. Une fois la connexion établie, configurez l’intégration :
    • Configurer le type de billet : choisissez le type de billet que Palisade doit utiliser pour créer des billets. Réglez-le avant toute autre chose : Palisade en a besoin pour créer le projet Palisade DMARC.
    • Configurer les états : associez les six états de billet de Palisade à votre flux d’états HaloPSA.
    • Configurer les priorités : associez les quatre niveaux de priorité de Palisade à vos priorités HaloPSA.
    • Choisir les tâches qui créent des billets : sélectionnez les types de tâches qui ouvrent un billet HaloPSA. Tous les types sont sélectionnés au départ. Consultez Choisir les billets que Palisade ouvre.
    • Importation des domaines : indiquez si Palisade déduit les domaines des adresses courriel des contacts.
    • Associer les clients PSA : voir ci-dessous.

Associer les clients PSA​

Palisade associe des groupes à des customers HaloPSA. Un groupe est le regroupement de domaines propre à Palisade, et c’est lui qui porte le lien vers le client. Il y a deux façons d’obtenir un groupe associé :

Importer les clients depuis HaloPSA. Palisade crée un groupe par client, déjà associé, et, si l’importation des domaines est activée, récupère les domaines qu’il trouve dans les utilisateurs et contacts de chaque client.

Associer les groupes que vous avez déjà. Les groupes que vous avez créés vous-même commencent sans client associé, et il n’est pas possible de définir l’association en créant un groupe. Choisissez le client HaloPSA de chaque groupe et cliquez sur Enregistrer les modifications.

avertissement

Un groupe sans client HaloPSA associé n’ouvre aucun billet, pas plus qu’un domaine qui ne fait partie d’aucun groupe. Si vous utilisiez Palisade avant de connecter HaloPSA, chaque groupe que vous avez créé vous-même reste sans association tant que vous ne l’associez pas ici.

Lorsque vous associez un groupe qui a déjà des tâches ouvertes, Palisade vous demande s’il faut créer des billets pour les tâches ouvertes pendant qu’il n’était pas associé. Choisissez Synchroniser les billets pour les envoyer.

Liste de vérification​

Une fois la configuration terminée, vérifiez que l’intégration fonctionne correctement :

  • L’état de la connexion indique Connecté sur la page Intégrations, sans avertissement d’autorisation
  • Chaque groupe est associé à un client HaloPSA, et chaque domaine fait partie d’un groupe
  • Les six états et les quatre priorités sont tous associés
  • L’importation des domaines récupère les domaines des clients attendus
  • Un billet apparaît dans HaloPSA pour une tâche de plus de quatre heures
remarque

La synchronisation va dans un seul sens. Palisade crée les billets et tient leur état à jour, mais fermer un billet dans HaloPSA ne règle pas la tâche dans Palisade. Consultez La synchronisation va dans un seul sens.

Dépannage​

Aucun billet n’apparaît​

  1. Quatre heures se sont-elles écoulées? Consultez Les billets attendent quatre heures.
  2. Chaque groupe est-il associé à un client? Les groupes que vous avez créés vous-même ne sont pas associés automatiquement. L’avis bleu en haut de la page de l’intégration compte les tâches ignorées pour cette raison, et Voir les journaux nomme le groupe en cause pour chacune.
  3. Chaque domaine fait-il partie d’un groupe?
  4. L’intégration est-elle active?
  5. Les six états et les quatre priorités sont-ils tous associés?
  6. Le type de tâche est-il toujours sélectionné?

« You do not have permission to update this Ticket »​

L’agent d’API peut créer des billets, mais pas les modifier. Accordez à l’agent l’autorisation can edit others’ tickets dans ses autorisations de billets, et confirmez que l’application d’API elle-même a l’accès en lecture et en modification aux billets.

Les domaines ne s’importent pas​

  • L’importation des domaines est peut-être désactivée dans les paramètres de l’intégration.
  • L’application d’API, ou l’agent sous lequel elle se connecte, ne peut peut-être pas lire les Users/Contacts. Cliquez sur Tester la connexion : Palisade signale précisément ce problème. N’accorder que Clients et Tickets est une erreur de configuration courante : les clients s’importent correctement, mais l’importation des domaines ne produit rien, sans aucun message.

Autres problèmes​

Consultez l’onglet Journaux de la page de l’intégration. Il consigne chaque envoi, mise à jour et synchronisation, avec le message d’erreur de tout ce qui a échoué. Une tâche qui n’a ouvert aucun billet parce que son groupe n’est pas associé ou que son domaine ne fait partie d’aucun groupe est indiquée comme Ignoré plutôt que comme une erreur, et nomme le groupe et le domaine.