Intégrer airfocus à Salesforce

Avantages de l'intégration à Salesforce

Notre intégration à Salesforce vous permet de recueillir des commentaires directement à partir de vos dossiers et opportunités Salesforce. Importez et centralisez facilement les données de Salesforce dans airfocus et informez la découverte de produits.

• Importez en toute transparence des cas et des opportunités Salesforce en tant qu'éléments dans airfocus afin de créer des informations pour la découverte de produits et l'établissement de priorités.
• Possibilité de mapper de manière flexible de nombreux champs du système Salesforce à des champs airfocus.

Les exigences

Pour pouvoir utiliser l'intégration Salesforce, les utilisateurs doivent s'assurer qu'ils remplissent les conditions suivantes :

Sur airfocus

• Les utilisateurs doivent avoir un accès "complet" à l'espace de travail.
• airfocus team doit être souscrit au plan "Enterprise".

Sur Salesforce

L'utilisateur utilisé pour mettre en place l'intégration doit être assigné à un profil qui doit avoir :

• Au moins des droits de lecture sur tous les objets/informations qui doivent être synchronisés via l'intégration.
• Les paramètres "API Enabled" et "Manage Connected Apps" sont activés. Les administrateurs de système peuvent le vérifier pour n'importe lequel de leurs profils configurés via Configuration > Administration Configuration > Gérer les utilisateurs > Profils
• Par défaut, lorsque vous créez une application dans Salesforce, l'option "Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows" est activée. Cet indicateur doit être désactivé.

Supplémentaire pour la synchronisation des "cas" :

• L'organisation Salesforce doit être abonnée à Salesforce Service Cloud et doit avoir accès à "Web Services API" qui est actuellement disponible sur les éditions "Professional" (supplément), "Enterprise" et "Unlimited".
  

Supplémentaire pour la synchronisation des "opportunités" :

• L'organisation Salesforce doit être abonnée à Salesforce Sales Cloud et doit avoir accès à l'"API de services Web" qui est actuellement disponible sur les éditions "Professional" (supplément), "Enterprise" et "Unlimited".
  

Mise en place de l'intégration

La mise en place de l'intégration est facile et ne devrait prendre que quelques minutes. Voici comment procéder :

Connectez-vous à airfocus

Tout d'abord, inscrivez-vous à airfocus ou connectez-vous à votre compte existant. Créez un nouvel espace de travail dans airfocus ou sélectionnez celui avec lequel vous souhaitez intégrer Salesforce.

Ajouter une intégration Salesforce à airfocus

Gardez à l'esprit qu'une intégration se connecte toujours à un espace de travail airfocus spécifique. Vous pouvez ajouter plusieurs intégrations Salesforce à un espace de travail donné.

Pour configurer l'intégration, allez sur "Gérer les intégrations" dans vos extensions et connectez-vous à Salesforce.

Sur l'écran suivant, vous devez sélectionner "Connecter une nouvelle instance Salesforce" dans le menu déroulant. Si vous vous êtes déjà connecté à des instances Salesforce au sein de votre équipe, toutes les instances Salesforce disponibles seront affichées dans cette liste déroulante. Vous pouvez créer autant d'intégrations Salesforce que vous le souhaitez vers une seule instance Salesforce.

Ensuite, vous devez donner un nom à votre nouvelle connexion d'instance Salesforce (qui s'affichera ultérieurement dans airfocus). Vous pouvez insérer ci-dessous la clé du consommateur (ID du client) et le secret du consommateur (secret du client) de votre application connectée à Salesforce pour pouvoir vous connecter à Salesforce.

Configurer une application connectée sur Salesforce

1. Connectez-vous à votre organisation Salesforce.
2. Ouvrez la page des paramètres des applications connectées :
   • si vous êtes sur Salesforce Classic via Setup > App Setup > Create > Apps.
     
   • si vous êtes sur Salesforce Lightning via Setup > Platform Tools > Apps > App Manager.
     
     
3. Créez une nouvelle application connectée :
   • si vous êtes sur Salesforce Classic : Dans la section des applications connectées, cliquez sur "Nouveau".
     
   • si vous êtes sur Salesforce Lightning : à côté de "Lightning Experience App Manger" cliquez sur "New Connected App".
     
4. Remplissez la section des informations de base :
   • Nom de l'application connectée : par exemple "airfocus".
   • Nom de l'API : par exemple "airfocus".
   • Email de contact : votre adresse email.
     
5. Dans la section API (Enable OAuth Settings) :
   • Cochez la case "Activer les paramètres OAuth".
   • En fonction de votre serveur airfocus (voir note ci-dessous) - copiez cette URL de rappel :
     • Serveur européen : https://app.airfocus.com/api/integration-providers/salesforce/callback et collez-le dans le champ "Callback URL".
     • US Serveur : https://app.airfocus.com/api/integration-providers/salesforce/callback et collez-le dans le champ "Callback URL".
     • Nouveau serveur américain (si vous êtes situé aux États-Unis ou dans la région APAC et que votre compte a été créé après septembre 2025) : https://app.airfocus.app/api/integration-providers/salesforce/callback et collez-le dans le champ "Callback URL".
   • Dans Selected OAuth Scopes, ajoutez les scopes suivants :
     • Gérer les données des utilisateurs via les API (api).
     • Effectuez des demandes à tout moment (refresh_token, offline_access).
       
     • Note : pour connaître l'emplacement de votre serveur airfocus, vérifiez votre URL airfocus, si elle contient us.airfocus, c'est qu'il se trouve aux États-Unis, sinon, c'est qu'il se trouve en Europe. Par exemple : teamname.us.airfocus.com au lieu de teamname.airfocus.com
     • Veuillez noter que si vous êtes situé aux États-Unis ou dans la région APAC et que votre compte a été créé après septembre 2025, l'URL sera teamname.airfocus.app.
6. Cliquez sur "Enregistrer". L'écran suivant vous indique que vous devrez peut-être attendre jusqu'à 10 minutes pour que les modifications soient appliquées. Cliquez sur "Continuer". Attendez 10 minutes.
   

Remarque : vous serez redirigé vers la page de gestion de votre application connectée, de sorte que vous pourrez passer directement à la section suivante de ce guide.

Connecter airfocus à Salesforce

1. Connectez-vous à votre organisation Salesforce.
2. Ouvrez la page des paramètres des applications connectées :
   • si vous êtes sur Salesforce Classic via Setup > App Setup > Create > Apps.
     
   • si vous êtes sur Salesforce Lightning via Setup > Platform Tools > Apps > App Manager.
     
3. Ouvrez la vue d'ensemble de votre application connectée :
   • si vous êtes sur Salesforce Classic, dans la section "Apps connectées", cliquez sur le nom de votre application connectée pour airfocus.
     
   • Si vous êtes sur Salesforce Lightning, dans le tableau, cliquez sur la flèche déroulante de votre application et cliquez sur "View".
     
4. Dans la section "API (Enable OAuth Settings)", cliquez sur "Manage Consumer Details".
   
5. Il se peut que vous deviez vérifier votre identité auprès de Salesforce.
6. Copiez la "Consumer Key" et "Consumer Secret" et collez-les dans les champs correspondants de la configuration de l'intégration airfocus Salesforce.
   
   
7. Cliquez sur "Connect" sur airfocus.
8. Vous serez redirigé vers un écran de confirmation Salesforce. Cliquez sur "Allow".
   

Configurez votre intégration

Vous pouvez nommer l'intégration en saisissant un nom dans le champ "Name" situé en haut de la page des paramètres d'intégration Salesforce. Ce nom sera affiché dans la vue d'ensemble des intégrations et dans la fenêtre contextuelle des extensions pour faciliter l'identification.

Filtres

Sélectionnez le type d'objet Salesforce que vous souhaitez importer/synchroniser avec airfocus. L'intégration prend actuellement en charge les cas et les opportunités de Salesforce. Si vous souhaitez synchroniser les deux types d'objets, vous devez configurer une intégration pour chacun d'entre eux (ils peuvent tous deux se connecter via la même instance Salesforce, vous n'avez donc pas besoin de créer une application connectée pour chaque type d'objet).

Sélectionnez une date dans le sélecteur de date du champ "Importer les objets créés après" pour n'importer que les objets créés après la date sélectionnée. Si vous ne spécifiez pas de date ici, l'intégration importera tous les objets Salesforce du type que vous avez sélectionné.

Vous pouvez filtrer davantage les objets à synchroniser en saisissant une condition WHERE pour le Salesforce Object Query Language (SOQL). Combinez plusieurs conditions avec AND ou OR. Si vous sélectionnez une date de début dans le champ ci-dessus, elle sera implicitement ajoutée à la clause WHERE. Tous les champs référencés ici doivent avoir une correspondance définie dans la section "Correspondance des champs" ci-dessous. En savoir plus.

Cartographie de terrain

Utilisez le mappage pour définir comment les informations de Salesforce doivent être mappées dans airfocus. Les noms et les descriptions des articles sont toujours mappés par défaut lors de la mise en place d'une nouvelle intégration et peuvent être supprimés ou modifiés.

Comment ajouter une nouvelle cartographie de champ

Lorsque vous sélectionnez un champ dans la liste déroulante, seuls les champs correspondant au type de champ seront affichés dans la liste déroulante du côté de l'airfocus. Notre intégration vous permet de mapper les champs du type d'objet principal (sélectionné ci-dessus) ainsi que les champs des objets directement connectés.

Dans l'exemple ci-dessous, l'utilisateur a sélectionné "Case" comme type d'objet Salesforce à importer/synchroniser. Le champ "Priority" (marqué en rouge) est un champ système de l'objet "Case". Le champ "Case ID" (marqué en vert) est un champ système de l'objet "MasterRecord" qui est un objet directement lié à "Case".

Pour simplifier : si un champ se trouve à un clic maximum de votre objet synchronisé dans Salesforce, vous pouvez le mapper à votre élément airfocus (les conditions décrites dans cet article s'appliquent).

L'intégration ne vous permet actuellement que de synchroniser les informations "à sens unique" de Salesforce à airfocus.

Après avoir sélectionné les deux champs que vous souhaitez mapper, vous pouvez choisir les options de champ et la manière dont ils doivent être mappés. Vous pouvez également associer plusieurs options de champ Salesforce à une seule option de champ airfocus.

Types de champs disponibles pour le mappage

L'intégration ne vous permet actuellement que de synchroniser les champs du système "à sens unique" de Salesforce à airfocus. Voici une liste des correspondances possibles entre les champs que vous pouvez configurer :

Comment déterminer le type de vos champs Salesforce ?

Vous pouvez trouver une liste de tous les champs disponibles / configurés sur votre type d'objet Salesforce (comme "Case" ou "Opportunity") dans vos paramètres Salesforce :

1. Connectez-vous à l'organisation Salesforce que vous connectez à airfocus.
2. Sur votre tableau de bord Salesforce principal, cliquez sur la roue des paramètres à côté de l'avatar de votre profil et cliquez sur "Configuration".
   
3. Dans la barre latérale de configuration, cliquez sur Platform Tools > Objects and Fields > "Object Manager".
   
4. Recherchez le type d'objet pour lequel vous voulez voir les types de champs et cliquez sur son "étiquette" d'objet.
   
5. Dans la barre latérale du type d'objet (par exemple "Cas"), cliquez sur "Champs & Relations" et consultez la colonne "Type de données" du tableau pour déterminer le type de champ que vous avez configuré pour ce type d'objet.
   
6. Vous pouvez déterminer si un champ est un champ personnalisé ou un champ système en consultant la colonne "Nom du champ" de la table. Si le nom d'un champ se termine par "__c", il s'agit d'un champ personnalisé.
   

Réglages supplémentaires

Lorsque l'option "Archiver les éléments inconnus" est activée, les éléments précédemment importés seront archivés dans airfocus, s'ils ne sont plus présents dans Salesforce ou s'ils ne correspondent plus aux filtres définis pour l'intégration.

Lorsque "Synchronisation automatique" est activé, votre intégration se synchronisera automatiquement toutes les 10 minutes et chaque fois que vous accéderez à l'espace de travail.

Lorsque vous cliquez sur "View logs", vous pouvez afficher les journaux d'activité de votre intégration Salesforce et voir quelles modifications ont été apportées avant la dernière synchronisation.

Pour sauvegarder vos paramètres et importer vos éléments dans airfocus, "Mettre à jour et synchroniser".

Remarques importantes

Le compte utilisateur Salesforce utilisé pour configurer l'intégration ne doit pas nécessairement être utilisé pour utiliser l'intégration. Tant que les utilisateurs d'airfocus disposent de clés et de secrets de consommateurs valides, ils peuvent configurer autant d'intégrations qu'ils le souhaitent vers ce lieu Salesforce connecté.

L'intégration est actuellement limitée à la synchronisation maximale. 2000 objets Salesforce.

Votre application connectée est considérée comme une application "Non-SDFC" par Salesforce. Veuillez lire le contrat de service principal de Salesforce si vous souhaitez prendre connaissance de ses politiques relatives à l'utilisation d'applications non-SDFC et à l'utilisation de ces applications pour des services d'intégration.

Donnez votre avis sur cet article