Intégrer les activités Showpad dans les communautés Salesforce

Marche à suivre sur Salesforce Lightning

• Configurer le paramètre CORS dans Salesforce Lighting
• Configurer une instance Salesforce dans Showpad
• Conseils de dépannage de base

Procédez étape par étape

1. Configurer le paramètre CORS sur Salesforce Lightning

La première étape pour configurer l'intégration Salesforce consiste à autoriser les demandes provenant du domaine Showpad. Salesforce permet à ses clients de contrôler quels sites Web sont autorisés à utiliser l'API Salesforce. Cela permet de sécuriser votre instance Salesforce en n'autorisant que les requêtes provenant de sites connus et en refusant toutes les autres.

Ce paramètre s'appelle CORS (Cross-Origin Resource Sharing) et il doit être configuré pour permettre à Showpad d'intégrer Salesforce. Les instructions ci-dessous expliquent comment un administrateur Salesforce peut autoriser notre domaine Showpad à envoyer des demandes à votre instance Salesforce. Si vous l'avez déjà fait lors de la configuration de votre intégration Showpad et Salesforce standard, vous n'avez pas besoin de le refaire.

Cette configuration permet :

• À Showpad de créer une activité Salesforce chaque fois qu'un utilisateur de l'application ou de la Web app Showpad partage du contenu avec un prospect ou un client ;
• À Showpad de créer un événement Salesforce chaque fois qu'un utilisateur d'une application mobile souhaite enregistrer une réunion dans Salesforce.

1. Accédez à la page « Configuration » sur Salesforce.com en tant qu'administrateur Salesforce.
2. Dans le menu de gauche, recherchez « CORS ». Vous pouvez également sélectionner manuellement « Contrôles de sécurité > CORS ».
3. Ajoutez une « Nouvelle source » à votre liste blanche.
4. Ajoutez https://*.showpad.biz et cliquez sur « Enregistrer ».

   Remarque : Si l'autorisation « Modifier toutes les données » est désactivée dans Salesforce, nous vous informerons sur la plateforme en ligne de Showpad que nous n'avons pas pu vérifier la configuration du paramètre CORS. Vous pourrez quand même continuer à configurer l'intégration lorsque cet avertissement s'affichera.

2. Configurer une instance Salesforce dans Showpad

1. Pour connecter Salesforce et Showpad, vous devez configurer votre ou vos instance(s) Salesforce dans Showpad. Vous pouvez configurer plusieurs instances Salesforce si votre société en utilise plusieurs.
   Ouvrez la plateforme en ligne de Showpad et connectez-vous avec vos identifiants d'administrateur.
2. Sous « Paramètres », sélectionnez « CRM » dans la section « Intégrations », puis sélectionnez « Configurer une instance Salesforce ». Si vous disposez déjà d'une instance Salesforce connectée, cliquez sur « Ajouter une instance Salesforce ».
3. Ajoutez une description de votre instance Salesforce. Si vous prévoyez de configurer plusieurs instances Salesforce, veillez à choisir des noms appropriés pour chaque instance afin de faciliter leur identification.
   • Si vous utilisez un domaine personnalisé pour accéder à Salesforce, par exemple https://companyxyz.my.salesforce.com, activez l'option « Utiliser un domaine personnalisé » et saisissez « companyxyz ».
   • Cochez la case « Connexion à la communauté » et saisissez l'URL de connexion à la communauté.
   • Un compte utilisateur Showpad peut être créé automatiquement lorsque l'utilisateur se connecte pour la première fois avec ses identifiants Salesforce. En savoir plus sur l'option de provisionnement automatique.
4. Cliquez sur « Suivant » et « Se connecter à Salesforce ». 
5. Vous devrez maintenant saisir votre identifiant Salesforce. Cet identifiant servira d'utilisateur d'intégration pour la connexion à Salesforce.
   Si l'utilisateur utilisé pour configurer cette intégration ne dispose pas de tous les privilège administrateurs, les autorisations suivantes sont nécessaires :
   Paramètres du système
   • Autorisation API
   • Modifier les tâches
   • Modifier les événements
   • Afficher les rôles et la hiérarchie des rôles
   • Afficher les paramètres de configuration
   
   Paramètres d'objet
   • Consulter, créer et modifier les objets Prospects, Contacts, Opportunités et Comptes.
   • Consulter, créer, modifier et supprimer les objets Activités Showpad, Éléments d'activités Showpad, Contenu Showpad et Vues de contenu Showpad.
   L'intégration fonctionne via une communication de serveur à serveur. En conséquence, l'adresse IP d'origine ne sera pas la plage ou l'adresse IP de la société, mais une adresse IP Showpad. Si vous utilisez des restrictions d'IP, nous vous conseillons de lire nos recommandations pour les applications OAuth.
   Une fois identifié, vous serez renvoyé sur la plateforme en ligne de Showpad. 
6. Vous pourrez à présent activer les recommandations de contenu pour vos collègues commerciaux. Consultez cet article pour plus d'informations. Pour utiliser cette fonctionnalité, vous devrez installer l'application Showpad pour Salesforce via l'AppExchange de Salesforce. Cliquez sur « Enregistrer ».
7. Le dernier onglet que vous verrez sert à activer la journalisation avancée des objets personnalisés. « Compte » et « Opportunité » seront sélectionnés par défaut, et vous pouvez cocher d'autres cases pour indiquer d'autres objets personnalisés pertinents pour le champ « Associé à ». Cela permet à vos utilisateurs d'associer des partages à des objets autres que des comptes ou des opportunités lors de la journalisation des tâches.
8. Dans Salesforce, la case « Autoriser les activités » doit être cochée dans la rubrique « Fonctionnalités facultatives » pour créer ou modifier un objet personnalisé.
9. Sélectionnez les objets personnalisés sur lesquels vous souhaitez enregistrer une activité, puis cliquez sur « Enregistrer ». La liste que vous voyez contient les mêmes objets qui sont disponibles dans l’instance SFDC connectée dans le champ « Associé à » d'une tâche. Les utilisateurs ne peuvent pas enregistrer de réunions sur un objet personnalisé.  
10. Il est possible de contrôler quels groupes d'utilisateurs peuvent utiliser l'intégration Salesforce. Cliquez sur l'onglet « Groupes avec accès » et sélectionnez « Tous les utilisateurs » ou « Sélectionner des groupes ». Si vous choisissez « Sélectionner des groupes », cochez les cases à côté des groupes auxquels vous souhaitez accorder l'accès à l'intégration.
11. Lorsqu'un partage est enregistré, vous verrez le corps de l'e-mail et un lien pour afficher le partage en tant que destinataire en commentaire dans les données de la tâche. Selon la configuration de vos paramètres, voici comment cela s'affichera à vos utilisateurs.

3. Conseils de dépannage de base

Erreur d'authentification OAuth

L'intégration de Showpad et Salesforce fonctionne via une communication de serveur à serveur. En conséquence, l'adresse IP d'origine sera remplacée par l'adresse IP de Showpad lors du processus d'identification.

Si vous utilisez des plages d'adresses IP, ou si les utilisateurs rencontrent des erreurs de connexion OAuth, nous vous recommandons de modifier les paramètres de l'application OAuth en désactivant « Appliquer les restrictions IP » et en activant « Assouplir les restrictions IP ».

Le paramètre « Assouplir les restrictions IP » permet aux utilisateurs d'exécuter l'application Showpad connectée sans restriction au niveau de leur IP. Vous pouvez trouver ces paramètres dans la rubrique « Administrer » de Salesforce.

1. Dans « Configuration », recherchez « Applications connectées ». Ouvrez les options « Utilisation d'applications connectées OAuth » dans l'onglet « Gérer les applications ».
   
2. Trouvez l'application Intégration Salesforce Showpad et cliquez sur « Installer ».
3. Dans la liste « Utilisation d'applications connectées OAuth », cliquez sur « Gérer les stratégies des applications ».
4. Cliquez sur « Modifier les stratégies ». Cliquez sur le menu déroulant « Assouplissement IP », puis désactivez « Appliquer les restrictions IP » et activez « Assouplir les restrictions IP ».
   
5. Cliquez sur « Enregistrer ».

La connexion à Salesforce ne fonctionne pas sur la Web app

Vérifiez que votre navigateur prend entièrement en charge le langage HTML. Cliquez ici pour la liste complète des configurations de navigateur requises.
Pour les utilisateurs d'Internet Explorer, vérifiez que vous êtes sur IE11 ou une version ultérieure. Vérifiez que l'option « Divers » est activée à la fois pour Internet et pour l'intranet dans les paramètres de sécurité. Si ce n'est pas le cas, Internet Explorer n'autorisera pas la page Showpad à se connecter au domaine Salesforce et à obtenir les données des contacts et des prospects.

1. Allez dans « Paramètres > Options Internet > Sécurité ».
2. Vous devriez voir une icône « Internet », assurez-vous qu'elle est sélectionnée. S'ils utilisent un intranet local, assurez-vous d'y appliquer le même changement.
3. Choisissez « Personnalisé ».
4. Faites défiler jusqu'à ce que vous trouviez ce qui suit, assurez-vous que l'accès aux sources de données sur plusieurs domaines est activé.
5. Appliquez et sauvegardez.
6. Veillez également à appliquer les mêmes paramètres à leur intranet local.
7. Vous devrez également vous assurer que votre paramètre CORS est configuré dans votre instance Salesforce.

Impossible de charger la requête XMLHttpRequest, la réponse renvoie le code 401.

Pour effectuer des appels à l'API Salesforce, nous avons besoin d'un jeton d'accès valide. Le jeton d'accès est obtenu sur les serveurs Showpad et non dans le navigateur de l'utilisateur. Si le paramètre de Salesforce « Verrouiller la session à l'adresse IP » est activé, cela signifie que nous ne pouvons envoyer des appels à l'API que depuis les serveurs de Showpad, car nous avons demandé le jeton Salesforce depuis nos serveurs. À cause de ce paramètre Salesforce, vous ne pourrez pas utiliser ce jeton d'accès depuis une adresse IP différente (votre navigateur). Si vous désactivez ce paramètre, le jeton d'accès pourra alors être utilisé depuis votre navigateur et vous pourrez envoyer des requêtes à Salesforce depuis la Web app.
Notez que les applications mobiles n'utilisent pas nos serveurs pour demander un nouveau jeton d'accès. Elles n'ont donc pas ce problème.

Accédez aux « Paramètres de session » et assurez-vous que la case « Verrouiller les sessions à l'adresse IP d'où elles proviennent » n'est pas cochée.