Aller au contenu principal

Intégration Autotask

Connectez Palisade à Autotask 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 utilisateur d’API​

  1. Dans Autotask, créez un nouvel API User sous Admin.
  2. Configurez l’utilisateur d’API :
    • Réglez le Security Level à un niveau réservé à l’API.
    • Cliquez sur Generate Key et sur Generate Secret. Ce sont le nom d’utilisateur et le mot de passe avec lesquels Palisade se connecte.
    • Réglez l’API Tracking Identifier au fournisseur d’intégration Palisade.
  3. Enregistrez l’utilisateur d’API.
conseil

Copiez immédiatement la clé (Key) et le secret (Secret). Le secret ne sera plus affiché.

Autorisations nécessaires à l’utilisateur d’API​

Le niveau de sécurité doit permettre de consulter les Companies et les Contacts sous CRM, ainsi que de créer et de modifier des Tickets. 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 accès aux 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.

Pour la synchronisation de la facturation, le niveau de sécurité doit aussi donner accès aux Contracts et à leurs services.

Étape 2 : créer un service pour la facturation​

Sautez cette étape si vous n’utilisez pas la synchronisation de la facturation.

  1. Créez un Service récurrent dans Autotask pour les frais par domaine de Palisade.
  2. Ajoutez ce service au contrat de chaque client que vous voulez facturer.
avertissement

Palisade met à jour un service de contrat qui existe déjà; il n’en crée pas. Si le contrat d’un client associé n’a aucun service, la synchronisation échoue avec le message « Contract has no services ». Si le contrat compte plus d’un service, choisissez le service précis dans les paramètres de Palisade pour que Palisade sache quelle ligne mettre à jour.

Étape 3 : configurer dans Palisade​

  1. Dans Palisade, rendez-vous sur la page Intégrations et choisissez Autotask.

  2. Sous Identifiants, saisissez :

    • Nom d’utilisateur : la clé (Key) générée pour l’utilisateur d’API
    • Mot de passe : le secret (Secret) généré pour l’utilisateur d’API
    • L’URL de l’API est détectée automatiquement à partir de votre compte et n’a normalement pas besoin d’être modifiée.

    Vous n’avez pas à saisir d’API Tracking Identifier. Palisade envoie son propre code de fournisseur enregistré.

  3. Cliquez sur Enregistrer. Palisade teste d’abord la connexion et n’enregistre que des identifiants qu’Autotask accepte. Cliquez sur Tester la connexion seul pour les vérifier sans les enregistrer.

  4. Configurez les paramètres de l’intégration :

    • Choisir la file de billets : la file Autotask dans laquelle les billets de Palisade sont créés.
    • Associer les états PSA : associez les six états de Palisade à vos états Autotask.
    • Associer les priorités PSA : associez les quatre niveaux de priorité de Palisade à vos priorités Autotask.
    • Choisir les tâches qui créent des billets : sélectionnez les types de tâches qui ouvrent un billet. 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 comptes PSA : voir ci-dessous.
    • Configurer le service de facturation : le service récurrent de l’étape 2, et le contrat de chaque client.

Associer les comptes PSA​

Palisade associe des groupes à des clients Autotask. 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 comptes depuis Autotask. 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 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 Autotask de chaque groupe et cliquez sur Enregistrer les modifications.

avertissement

Un groupe sans client Autotask associé n’ouvre aucun billet, pas plus qu’un domaine qui ne fait partie d’aucun groupe. Si vous utilisiez Palisade avant de connecter Autotask, 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 :

  • L’état de la connexion indique Connecté sur la page Intégrations, sans avertissement d’autorisation
  • Chaque groupe est associé à un client Autotask, 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
  • Le service de facturation reflète le bon nombre de domaines
  • Un billet apparaît dans Autotask 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 Autotask 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é?

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’utilisateur d’API ne peut peut-être pas consulter les Contacts sous CRM. Cliquez sur Tester la connexion : Palisade signale précisément ce problème.

Problèmes de facturation​

  • « Contract has no services » : ajoutez le service Palisade au contrat de ce client dans Autotask. Palisade ne le créera pas.
  • « Contract has multiple services » : choisissez le service précis dans les paramètres de facturation de Palisade pour que Palisade sache quelle ligne mettre à jour.

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.