Le Health Check Monitor est un outil de diagnostic intégré qui vérifie automatiquement si votre organisation Salesforce présente des problèmes courants de configuration de l’intégration Aircall. Il est en lecture seule : rien n’est écrit ni modifié dans votre organisation. Les résultats s’affichent instantanément et peuvent être exportés au format CSV.

Utilisez-le lors de la configuration initiale de l’intégration Aircall, après une mise à niveau du package ou pour résoudre des problèmes tels que des champs qui ne sont pas renseignés ou des appels qui ne sont pas journalisés.

Important: Le Health Check Monitor est disponible uniquement dans Salesforce Lightning. Il n’est pas disponible dans Salesforce Classic.

Qui doit l’exécuter

Les administrateurs Salesforce ou tout autre Utilisateur Salesforce disposant des autorisations nécessaires et responsable de la configuration ou de la maintenance de l’intégration Aircall<>Salesforce dans votre organisation.

Éléments vérifiés

Le moniteur effectue des vérifications dans trois catégories :

Installation du package : vérifie que le package Aircall est correctement installé, que tous les composants requis sont présents et que les paramètres de site distant sont configurés.

Autorisations de l’Utilisateur : vérifie que l’Utilisateur de l’intégration dispose d’un accès à l’API, des autorisations CRUD appropriées sur les objets requis, de l’ensemble d’autorisations requis et de l’autorisation Tout afficher sur les objets clés.

Sécurité au niveau des champs : vérifie que l’Utilisateur de l’intégration peut lire et modifier tous les champs Aircall requis sur les objets clés.

Remarque: Des catégories de vérification supplémentaires sont prévues dans de prochaines versions, notamment l’accessibilité des points de terminaison Apex, les données et les flux, la configuration CTI et vocale, ainsi que la connectivité. Pour le moment, le moniteur couvre uniquement l’intégration V3/CTI. La prise en charge de Service Cloud Voice (SFV) est prévue dans une phase ultérieure.

Configuration du Health Check Monitor

Une fois le package Aircall installé, deux étapes manuelles sont nécessaires pour rendre l’onglet Health Check disponible dans votre application Lightning.

Étape 1 : ajouter l’onglet Health Check à votre application Lightning

Étapes

  1. Accédez à Configuration > Gestionnaire d’applications.
  2. Recherchez votre application Lightning et cliquez sur Modifier.
  3. Accédez à Éléments de navigation et ajoutez l’onglet Health Check.
  4. Enregistrez vos modifications.

Étape 2 : définir l’onglet sur Activé par défaut pour le profil Administrateur système

Étapes

  1. Accédez à Configuration > Profils.
  2. Ouvrez le profil Administrateur système.
  3. Accédez à Paramètres des onglets personnalisés.
  4. Recherchez aircallHealthCheckDashboard et définissez-le sur Activé par défaut.
  5. Enregistrez vos modifications.

Exécution du Health Check

Étapes

  1. Accédez à l’onglet Health Check de votre application Lightning.
  2. Cliquez sur Exécuter le Health Check V3.
  3. Les résultats s’affichent directement dans la page. Développez chaque catégorie pour afficher les détails de chaque vérification.

Dans le coin supérieur droit, le tableau de bord affiche le nom, le rôle, l’adresse e-mail et le profil de l’Utilisateur qui exécute actuellement la vérification. Avant de lancer celle-ci, vérifiez que vous êtes connecté avec le bon compte, car les vérifications reflètent les autorisations de l’Utilisateur qui les exécute.

Remarque: Les résultats ne sont pas enregistrés et disparaissent lors de l’actualisation de la page. Utilisez le bouton Télécharger le rapport pour exporter tous les résultats au format CSV avant de fermer ou d’actualiser la page.
image showing How to run the Health check

Comprendre vos résultats

Chaque vérification renvoie l’un des trois statuts suivants :

StatutSignificationAction à effectuer
RÉUSSITELa vérification a réussi, aucune action n’est requise.Aucune.
ÉCHECUne erreur de configuration a été détectée.Développez la ligne pour afficher le message d’erreur, les étapes de résolution et un lien vers la documentation correspondante.
AVERTISSEMENTInformation qui ne constitue pas un échec, mais mérite d’être examinée.Consultez les informations affichées dans la ligne de vérification.

Lorsqu’une vérification échoue, développez directement la ligne pour comprendre le problème et savoir comment le résoudre. Chaque vérification ayant échoué comprend un message d’erreur, des étapes de résolution spécifiques et un lien vers la documentation correspondante.

Résolution des problèmes courants

Champs non renseignés dans les enregistrements Salesforce

Les champs concernés comprennent SMS, Résolution de l’appel, Informations de l’IA, Enregistrement des appels et Tags.

Cause probable : absence de sécurité au niveau des champs (FLS) sur les champs Aircall pour l’Utilisateur de l’intégration.

Étapes

  1. Exécutez le Health Check et recherchez les échecs dans la catégorie Sécurité des champs.
  2. Attribuez AirCall_PermissionSet à l’Utilisateur de l’intégration. Cela accorde la sécurité FLS en lecture et en écriture sur tous les champs Aircall requis.
  3. Si l’ensemble d’autorisations est déjà attribué, vérifiez qu’il l’est à un Utilisateur actif.

Échec de la configuration de l’Utilisateur de l’intégration ou appels non journalisés

Cause probable : absence de l’autorisation API activée ou accès CRUD insuffisant aux objets requis (Tâche, Contact, Prospect, Compte, Requête, Opportunité).

Étapes

  1. Exécutez le Health Check et recherchez les échecs dans la catégorie Autorisations de l’Utilisateur.
  2. Attribuez AirCall_PermissionSet et vérifiez que l’option API activée est définie dans le profil de l’Utilisateur.
  3. Si seuls des utilisateurs inactifs disposent de l’ensemble d’autorisations, réattribuez-le à l’Utilisateur actif de l’intégration.

Échec de la mise à niveau du package avec l’erreur « AI Object Permission Error »

Cause probable : AirCall_PermissionSet est attribué à un Utilisateur doté d’une licence Invité. Salesforce bloque les mises à niveau du package dans cet état.

Étapes

  1. Exécutez le contrôle d’intégrité et recherchez les échecs dans la catégorie Installation du package.
  2. Accédez à Configuration > Ensembles d’autorisations > AirCall_PermissionSet > Gérer les attributions.
  3. Retirez de l’attribution tous les utilisateurs disposant d’une licence Invité.
  4. Réessayez de mettre à niveau le package.

FAQ

Le contrôle d’intégrité apporte-t-il des modifications à mon organisation ?

Non. Il est entièrement en lecture seule. Aucune donnée n’est écrite ni modifiée.

Combien de temps faut-il pour l’exécuter ?

Quelques secondes.

Quelles autorisations sont prises en compte par le contrôle ?

Le contrôle prend en compte les autorisations de l’utilisateur qui l’exécute actuellement, et non celles de l’utilisateur de l’intégration. Assurez-vous d’exécuter le contrôle en tant qu’utilisateur approprié. Le nom, le rôle, l’adresse e-mail et le profil de l’utilisateur qui l’exécute sont affichés dans le coin supérieur droit du tableau de bord.

Quelle intégration est concernée ?

Actuellement, uniquement V3/CTI. La prise en charge de Service Cloud Voice (SFV) est prévue pour une phase ultérieure.

Que dois-je faire en cas d’échec d’un contrôle ?

Développez la ligne du contrôle ayant échoué. Elle affiche le message d’erreur, l’élément à corriger et un lien vers la documentation correspondante. Pour les scénarios d’échec courants, consultez la section « Résolution des problèmes courants » ci-dessus.

Si vous devez contacter le support Aircall

Si vous avez exécuté le contrôle d’intégrité sans parvenir à résoudre le problème, rassemblez les éléments suivants avant de contacter le support Aircall :

  • L’exportation CSV du contrôle d’intégrité (cliquez sur Télécharger le rapport).
  • L’ID de votre organisation Salesforce.
  • La version du package Aircall (affichée dans le contrôle Avertissement relatif à la version du package).
  • Le nom du profil de l’utilisateur qui exécute le contrôle (affiché dans l’encadré d’informations utilisateur en haut à droite).
  • Une capture d’écran de tous les contrôles ayant échoué.

Pour les journaux de débogage Salesforce, accédez à Configuration > Journaux de débogage et enregistrez un journal d’exécution Apex pendant l’exécution du contrôle d’intégrité. S’il est disponible, joignez-le à votre ticket de support.