Intégration ConnectWise
Connectez Palisade à ConnectWise PSA pour importer automatiquement les domaines, créer des billets et synchroniser la facturation au moyen des ententes (agreements).
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.
Prérequis
Palisade se connecte en tant que membre d’API (API member) ConnectWise et a besoin d’un rôle de sécurité qui peut lire vos entreprises, vos contacts et vos tables de configuration, et créer des billets de service.
Dans ConnectWise, les rôles de sécurité sont définis par module, et chaque ligne a des niveaux distincts Add, Edit, Delete et Inquire, chacun réglé à None, My, My Team ou All. Réglez les éléments suivants :
| Module | Ligne d’autorisation | Niveaux |
|---|---|---|
| Companies | Company Maintenance | Inquire: All |
| Companies | Contacts | Inquire: All |
| Service Desk | Service Tickets | Add: All, Edit: All, Inquire: All |
| Service Desk | Close Service Tickets | Inquire: All |
| Finance | Agreements | Inquire: All, ainsi que Add + Edit: All si vous utilisez la synchronisation de la facturation |
| Procurement | Product Catalog | Inquire: All |
| System | Table Setup | Add: All, Inquire: All |
Les tableaux de service (service boards) proviennent de System > Table Setup, et non de Service Desk. Après avoir réglé Table Setup, cliquez sur Customize sur cette ligne et autorisez au moins Service / Service Board. Sans cela, la liste des tableaux de service dans Palisade est vide et vous ne pouvez pas terminer la configuration, même si le test de connexion réussit : lire les entreprises et lire la définition des tableaux sont des autorisations différentes.
Les contacts comptent plus qu’il n’y paraît. Palisade déduit les domaines de chaque entreprise à partir des adresses courriel de ses contacts. Sans l’accès Inquire à Companies > Contacts, la liste des entreprises s’importe correctement, mais l’importation des domaines ne retourne rien, sans aucun message. Le bouton Tester la connexion de Palisade vérifie précisément ce point et vous avertit.
Étape 1 : configurer les identifiants
Trouver votre URL d’API
Votre URL d’API ConnectWise dépend de votre région :
| Région | URL de l’API |
|---|---|
| Amérique du Nord | https://api-na.myconnectwise.net |
| Europe | https://api-eu.myconnectwise.net |
| Australie | https://api-aus.myconnectwise.net |
| Préproduction | https://api-staging.connectwisedev.com |
Saisissez seulement l’URL de base, sans chemin.
Obtenir votre Company ID
Votre Company ID est l’identifiant que vous utilisez pour vous connecter à ConnectWise PSA. Vous le trouverez sur l’écran de connexion ou dans les paramètres de votre compte ConnectWise.
Créer un membre d’API et générer des clés
Les clés d’API appartiennent à un membre d’API dédié, qui se trouve dans son propre onglet, et non dans la liste ordinaire des membres.
- Dans ConnectWise, allez dans System > Members et choisissez l’onglet API Members.
- Cliquez sur + pour créer un nouveau membre d’API.
- Réglez le Member ID à quelque chose de reconnaissable, comme
Palisade. - Réglez le Level à Corporate (Level 1).
- Réglez le Role ID au rôle de sécurité configuré dans les prérequis.
- Sous Service Defaults, décochez Restricted Board Access pour qu’aucun tableau ne soit restreint.
- Enregistrez le membre.
- Sur le membre enregistré, ouvrez l’onglet API Keys et cliquez sur +.
- Saisissez une description et enregistrez. ConnectWise génère une Public Key et une Private Key.
Restricted Board Access est une cause fréquente d’une liste de tableaux vide. Si le membre d’API est limité à certains tableaux, Palisade ne peut ni énumérer les tableaux ni créer de billets sur ceux qu’il ne voit pas.
Copiez votre Private Key immédiatement après sa génération. Elle ne sera plus affichée.
Saisissez ces quatre valeurs sur la page Intégrations de Palisade, sous Identifiants :
- URL de l’API : selon votre région, d’après le tableau ci-dessus
- Company ID : l’identifiant de votre entreprise ConnectWise
- Public Key et Private Key : celles du membre d’API que vous venez de créer
Cliquez sur Enregistrer. Palisade teste d’abord la connexion et n’enregistre que des identifiants que ConnectWise accepte. Tester la connexion les vérifie sans les enregistrer et signale deux choses distinctes : si les identifiants permettent de s’authentifier, et si le membre d’API peut lire les contacts.
Étape 2 : configurer l’intégration des tâches
Une fois la connexion établie, configurez la façon dont Palisade crée et gère les billets dans ConnectWise. Les paramètres ci-dessous apparaissent sous forme de sections repliables sur la page de l’intégration, à peu près dans cet ordre.
Choisir le tableau de service
Choisissez le Service Board ConnectWise où les billets de Palisade seront créés.
Changer de tableau par la suite efface vos associations d’états, de types et de sous-types. Ces valeurs sont propres à chaque tableau : Palisade les efface donc plutôt que de reporter des identifiants non valides. Associez de nouveau les trois après avoir changé de tableau. Les associations de priorités ne dépendent pas du tableau et sont conservées.
Associer les états PSA
Associez les six états de billet de Palisade à des états du tableau choisi :
| État Palisade | Description |
|---|---|
| Ouvert | Le billet demande une action et peut être traité |
| En attente | Le billet attend une réponse ou une action externe |
| Terminé | Le billet a été réglé et complété |
| Reporté | Le billet est temporairement reporté à plus tard |
| Annulé | Le billet a été annulé et ne sera pas traité |
| Écarté | Le billet a été examiné et volontairement écarté |
Les six doivent être associés. Une tâche dont l’état n’est associé à rien n’est pas envoyée, et l’échec apparaît dans les journaux de l’intégration. Associer plusieurs états de Palisade au même état ConnectWise est permis et courant : la plupart des équipes associent Terminé, Annulé et Écarté à un même état fermé.
Associer les priorités PSA
Associez les quatre niveaux de priorité de Palisade à vos priorités ConnectWise :
| Priorité Palisade | Description |
|---|---|
| Critique | Action immédiate requise : risque de sécurité ou défaillance majeure |
| Élevée | À traiter bientôt : problème d’authentification important |
| Moyenne | À traiter : préoccupation d’authentification modérée |
| Faible | Informatif : amélioration ou optimisation mineure |
Comme pour les états, les quatre doivent être associées.
Choisir les tâches qui créent des billets
Sélectionnez les types de tâches qui ouvrent un billet ConnectWise : configurer un enregistrement DMARC, nettoyer un enregistrement SPF, confirmer une source d’envoi, et ainsi de suite. Tous les types sont sélectionnés au départ : si vous ne touchez à rien, vous obtenez un billet pour tout ce que Palisade ouvre.
Décocher un type arrête les nouveaux billets de ce type. Les billets déjà ouverts dans ConnectWise restent ouverts et continuent de recevoir les mises à jour d’état, et réactiver le type ne rattrape pas les tâches ouvertes pendant qu’il était désactivé. Consultez Choisir les billets que Palisade ouvre.
Choisir le type et le sous-type
Choisissez le Type et le Subtype sous lesquels classer les billets de Palisade. Les deux listes proviennent du tableau choisi, et c’est pourquoi changer de tableau les efface.
Importation des domaines
La section Importation des domaines détermine si Palisade déduit les domaines des adresses courriel figurant dans les fiches des contacts de chaque entreprise.
- Activée (par défaut) : Palisade importe les domaines trouvés dans les adresses courriel des contacts lorsque vous importez des entreprises.
- Désactivée : Palisade n’importe aucun domaine, et vous décidez vous-même quels domaines appartiennent à chaque groupe.
Désactivez-la si vous tenez votre liste de domaines de façon délibérée et ne voulez pas que les adresses des contacts y ajoutent des domaines.
Associer les entreprises PSA
C’est la section qui détermine pour quelle entreprise ConnectWise les billets d’un domaine sont ouverts, et c’est l’endroit où une configuration reste le plus souvent incomplète. Palisade associe des groupes à des companies ConnectWise : un groupe est le regroupement de domaines propre à Palisade, et c’est lui qui porte le lien vers l’entreprise.
Il y a deux façons d’obtenir un groupe associé :
Importer les entreprises depuis ConnectWise. Cliquez sur Importer les entreprises depuis ConnectWise, sélectionnez les entreprises voulues et cliquez sur Importer les groupes. Palisade crée un groupe par entreprise, déjà associé, et, si l’importation des domaines est activée, récupère les domaines qu’il trouve dans les contacts de chaque entreprise. Seules les entreprises dont l’état ConnectWise est Active sont proposées.
Associer les groupes que vous avez déjà. Les groupes que vous avez créés vous-même commencent sans entreprise associée, et il n’est pas possible de définir l’association en créant un groupe. Choisissez l’entreprise ConnectWise de chaque groupe dans le tableau de cette section et cliquez sur Enregistrer les modifications.
Un groupe sans entreprise ConnectWise associée n’ouvre aucun billet, pas plus qu’un domaine qui ne fait partie d’aucun groupe. Si vous utilisiez Palisade avant de connecter ConnectWise, 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.
Étape 3 : configurer l’intégration de la facturation
Palisade peut synchroniser le nombre de domaines surveillés avec les ententes (agreements) ConnectWise.
Préparer d’abord l’entente dans ConnectWise
Palisade ne crée pas l’ajout à l’entente (agreement addition). Il met à jour une ligne qui existe déjà. Pour chaque client à facturer, ajoutez l’article du catalogue que vous allez utiliser comme Agreement Addition sur l’entente de ce client dans ConnectWise, avant d’activer la synchronisation de la facturation. Si l’ajout est absent, chaque synchronisation pour ce client échoue avec le message « Agreement addition not found for this product ».
Choisir le produit ou l’article du catalogue
Choisissez le Catalog Item ConnectWise qui représente les frais par domaine de Palisade. Ce doit être le même article que celui utilisé dans les ajouts aux ententes créés ci-dessus : Palisade retrouve l’ajout en se basant sur cet article.
Associer les clients aux ententes
Pour chaque client, choisissez l’entente ConnectWise qui doit recevoir l’ajout de facturation de Palisade. Seules les ententes actives sont énumérées.
Synchronisation de la facturation
La section Synchronisation de la facturation comporte un interrupteur Active. Tant qu’il est activé, Palisade maintient la quantité de l’ajout à l’entente égale au nombre actuel de domaines facturables de ce groupe.
Palisade fixe la quantité au nombre actuel plutôt que d’en ajouter ou d’en retirer. Si vous ou quelqu’un d’autre modifiez la quantité à la main dans ConnectWise, la synchronisation suivante la remplace par le nombre de Palisade.
Exemple : un client a 15 domaines surveillés, la quantité de l’ajout est donc de 15. Ajoutez 3 domaines et Palisade la fixe à 18. Retirez-en 2 et Palisade la fixe à 16.
Désactiver la synchronisation de la facturation arrête les mises à jour de quantité. Les billets continuent de se synchroniser tant que l’intégration elle-même est active.
Étape 4 : gérer l’intégration
État de l’intégration
La section État de l’intégration comporte un interrupteur Active. Tant qu’elle est inactive :
- Aucun nouveau billet n’est créé dans ConnectWise
- Les billets existants ne sont pas mis à jour
- La synchronisation de la facturation est interrompue
L’importation des domaines n’est pas touchée : elle s’exécute lorsque vous la demandez, que l’intégration soit active ou non.
Mettre à jour les identifiants
Si vos clés d’API changent ou expirent, ouvrez la section Identifiants sur la page de l’intégration, saisissez les nouvelles valeurs et cliquez sur Enregistrer. Laissez le champ Private Key vide pour conserver celle qui est enregistrée. L’enregistrement teste d’abord la connexion : des clés que ConnectWise refuse ne sont donc pas enregistrées, et les anciennes restent en place.
Mettre à jour les associations
Vous pouvez mettre à jour en tout temps les associations d’états, de priorités, de types, de sous-types et d’entreprises. Les modifications prennent effet au prochain envoi. N’oubliez pas que changer de tableau efface les associations d’états, de types et de sous-types.
Consulter les journaux
L’onglet Journaux présente l’historique de ce que Palisade a fait dans ConnectWise (création de billets, mises à jour d’état, synchronisations de domaines et d’entreprises, événements de facturation), 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.
Dépannage
Aucun billet n’apparaît
Vérifiez ces points dans l’ordre; les trois premiers couvrent la plupart des cas :
- Quatre heures se sont-elles écoulées? Les nouvelles tâches sont retenues quatre heures avant d’être envoyées, et une tâche qui se règle à l’intérieur de cette fenêtre ne devient jamais un billet. Consultez Les billets attendent quatre heures.
- Chaque groupe est-il associé à une entreprise? Ouvrez Associer les entreprises PSA et vérifiez. 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.
- Chaque domaine fait-il partie d’un groupe? Un domaine qui ne fait partie d’aucun groupe n’ouvre rien.
- L’intégration est-elle active? Vérifiez la section État de l’intégration.
- Les six états et les quatre priorités sont-ils tous associés? Une association manquante bloque l’envoi et est consignée dans les journaux.
- Le type de tâche est-il toujours sélectionné? Vérifiez Choisir les tâches qui créent des billets.
J’ai associé le groupe, mais les billets ne sont jamais apparus
Associer un groupe n’envoie pas les tâches déjà ignorées, à moins que vous choisissiez Synchroniser les billets lorsque Palisade vous le propose.
La proposition n’est faite qu’une fois, au moment où le groupe reçoit sa première association à une entreprise. Si vous avez choisi Passer, choisir de nouveau la même entreprise ne ramènera pas la question. Pour obtenir de nouveau la proposition, effacez l’association du groupe à l’entreprise, enregistrez, puis associez-le de nouveau et enregistrez : le second enregistrement est traité comme une première association et la question est posée. Sinon, communiquez avec le soutien de Palisade et nous pourrons envoyer les tâches en suspens pour vous.
Les tâches ouvertes avant que le groupe soit associé, et jamais couvertes par un choix Synchroniser les billets, demandent la même démarche.
Problèmes d’authentification
- Identifiants non valides : vérifiez le Company ID, la Public Key et la Private Key, et que l’URL de l’API correspond à votre région.
- 403 Forbidden : il manque une autorisation au rôle de sécurité du membre d’API. Revoyez le tableau des prérequis, et vérifiez que les niveaux Inquire sont réglés à All plutôt qu’à My.
- Délai de connexion dépassé : confirmez l’URL d’API régionale et que votre instance est joignable.
La liste des tableaux de service est vide
Le membre d’API ne peut pas lire la définition des tableaux. Deux causes, souvent combinées :
- System > Table Setup n’est pas accordé, ou sa liste Customize n’autorise pas Service / Service Board.
- Le membre d’API a Restricted Board Access activé sous Service Defaults.
Des états, des types ou des sous-types sont manquants ou incorrects
Ils sont propres à chaque tableau. Si vous avez récemment changé de tableau de service, Palisade les a effacés et ils doivent être associés de nouveau. S’il manque un état précis dans la liste, vérifiez qu’il n’est pas marqué comme inactif dans ConnectWise.
Les domaines ne s’importent pas
- L’importation des domaines est peut-être désactivée dans les paramètres de l’intégration.
- Le membre d’API ne peut peut-être pas lire les contacts. Cliquez sur Tester la connexion : Palisade signale précisément ce problème. Accordez Companies > Contacts Inquire: All.
- Une entreprise dont aucun contact n’a d’adresse courriel ne fournit aucun domaine.
Problèmes de facturation
- « Agreement addition not found for this product » : l’entente n’a aucun ajout qui utilise l’article du catalogue choisi. Ajoutez-le dans ConnectWise; Palisade ne le créera pas.
- Les quantités ne se mettent pas à jour : vérifiez que la synchronisation de la facturation est active et que le client est associé à une entente active.
- La quantité revient sans cesse à sa valeur précédente : c’est normal. Palisade fixe la quantité à son propre nombre de domaines à chaque synchronisation : les modifications manuelles sont donc remplacées.
- Article du catalogue introuvable : l’article du catalogue choisi a été désactivé ou supprimé dans ConnectWise.
Fermer un billet dans ConnectWise ne l’a pas réglé dans Palisade
La synchronisation va dans un seul sens. Consultez La synchronisation va dans un seul sens.
Soutien
Si les problèmes persistent après avoir suivi les étapes de dépannage, communiquez avec le soutien de Palisade en fournissant :
- Votre région ConnectWise et votre Company ID
- Le message d’erreur ou le comportement inattendu que vous observez
- Une copie des entrées pertinentes de l’onglet Journaux