Intégrer les activités Showpad pour Salesforce Experience Cloud

Découvrez comment cela fonctionne sur Salesforce Lightning

• Configurer CORS dans Salesforce Lightning
• Configurez une instance Salesforce dans Showpad
• Dépannage de base

Faites-le étape par étape

1. Configurer CORS dans Salesforce Lightning

La première étape de la configuration de 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 autorisant uniquement les demandes provenant de sites connus et en refusant toutes les autres.

Ce paramètre s'appelle CORS (Cross-Origin Resource Sharing) et la configuration est nécessaire pour que Showpad puisse s'intégrer à Salesforce. Les instructions ci-dessous montrent 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 standard Showpad et Salesforce, vous n'avez pas besoin de le refaire.

Ceci permet :

• Showpad pour créer une activité Salesforce lorsqu'un utilisateur de l'application Showpad ou de la Web app partage le contenu avec un prospect ou un client.
• Showpad pour 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 dans Salesforce.com 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. Ajouter une nouvelle origine sur 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 Online Platform de Showpad que nous n'avons pas pu vérifier la configuration CORS. Vous pourrez toujours continuer à configurer l'intégration lorsque vous verrez cet avertissement.

2. Configurer une instance Salesforce dans Showpad

1. Pour connecter Salesforce et Showpad, vous devez configurer votre ou vos instances Salesforce dans Showpad. Vous pouvez configurer plusieurs instances Salesforce si votre entreprise en utilise plusieurs.
   Ouvrez la plateforme Showpad Online et connectez-vous avec vos identifiants d'administrateur.
2. Dans Paramètres, sélectionnez CRM dans la Section d'intégrations, puis sélectionnez Configurer une instance Salesforce. Si vous avez déjà une instance Salesforce connectée, cliquez sur Ajouter une instance Salesforce.
3. Entrez une description pour votre instance Salesforce. Si vous prévoyez de configurer plusieurs instances Salesforce, veillez à choisir les 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 Utiliser un domaine personnalisé et entrez companyxyz.
   • Cochez la case Connexion à Experience Cloud et saisissez l'URL de connexion au site Experience Cloud. Vous pouvez le trouver dans Salesforce en accédant à Configuration, Expériences numériques, puis Tous les sites.
   • Les comptes d'utilisateur Showpad peuvent être créés automatiquement lorsque les utilisateurs se connectent pour la première fois avec leurs informations d'identification Salesforce. En savoir plus sur l'option d'auto-approvisionnement.
4. Cliquez sur Suivant et connectez-vous à Salesforce.
5. Vous devez maintenant entrer vos informations d'identification Salesforce. Ce login sera utilisé comme utilisateur d'intégration pour se connecter à Salesforce.
   Si l'utilisateur utilisé pour configurer cette intégration n'est pas un administrateur complet, les autorisations suivantes sont nécessaires :
   Les paramètres du système
   • API activée
   • Modifier les tâches
   • Modifier les événements
   • Afficher les rôles et la hiérarchie des rôles
   • Afficher l'installation et la configuration
   
   Paramètres de l'objet
   • Lire/Créer/Modifier pour les objets Pistes, Contacts, Opportunités, Comptes.
   • Lire/Créer/Modifier/Supprimer pour les activités Showpad, les éléments d'activités Showpad, le contenu Showpad et les objets de vues de contenu Showpad.
   L'intégration fonctionne avec une communication de serveur à serveur. Le résultat est que l'adresse IP d'origine ne sera pas la plage IP ou l'adresse IP de l'entreprise, mais une adresse IP Showpad. Si vous utilisez des restrictions IP, nous vous conseillons de lire nos recommandations sur l'application OAuth.
   Une fois connecté, Online Platform Showpad rouvrira.
6. Vous pouvez maintenant activer les recommandations de contenu pour vos collègues commerciaux. Référez-vous à cette page si vous voulez plus d'informations. Pour utiliser cette fonctionnalité, vous devez installer l' application Showpad pour Salesforce via AppExchange de Salesforce. Cliquez sur « Enregistrer ».
7. Le dernier onglet que vous verrez est pour activer la journalisation avancée des objets personnalisés. Le compte et l'opportunité seront sélectionnés par défaut, et vous pouvez indiquer d'autres objets pertinents en cochant leurs cases pour le champ « Lié à ». 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, lors de la modification ou de la création de l'objet personnalisé, la case Autoriser les activités doit être cochée dans la Section Fonctionnalités facultatives.
9. Sélectionnez les objets personnalisés sur lesquels vous souhaitez enregistrer l'activité, puis cliquez sur Enregistrer. La liste que vous voyez contient les mêmes objets que ceux disponibles dans l'instance de SFDC connectée dans le champ Associé à d'une tâche. Les utilisateurs ne peuvent pas enregistrer les réunions dans 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 Groupes sélectionnés. Si vous choisissez Sélectionner des groupes, cochez les cases 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 dans les commentaires des informations sur la tâche. Selon la façon dont vos paramètres sont configurés, cela ressemblera à ceci pour vos utilisateurs.

3. Dépannage de base

Erreur d'authentification OAuth

L'intégration de Showpad et de Salesforce fonctionne avec une communication de serveur à serveur. Une conséquence de ceci est que l'adresse IP de l'utilisateur d'origine sera modifiée pour l'adresse de Showpad lors du processus de connexion.

Dans les cas où des plages d'adresses IP de connexion sont utilisées, ou lorsque les utilisateurs rencontrent des erreurs de connexion OAuth, nous recommandons de modifier les paramètres de l'application OAuth pour passer de "Enforce IP restrictions" à "Relax IP restrictions".

Le paramètre "Relaxer les restrictions IP" permet aux utilisateurs d'exécuter l'application Showpad connectée sans restrictions IP. Vous pouvez trouver ces paramètres dans la Section Administration de Salesforce.

1. Dans Configuration, recherchez applications connectées. Ouvrez les options d'utilisation OAuth des applications connectées dans l'onglet Gérer les applications.
   
2. Trouvez l'application Salesforce Showpad intégration et cliquez sur Installer.
3. Dans la liste Connect applications OAuth Usage, cliquez sur Gérer les politiques application.
4. Cliquez sur Modifier les politiques. Cliquez sur le menu déroulant Relaxation IP, puis remplacez Appliquer les restrictions IP par Relaxer les restrictions IP.
   
5. Cliquez sur « Enregistrer ».

La connexion Salesforce ne fonctionne pas sur l'app Web

Assurez-vous que vous travaillez sur un navigateur qui prend entièrement en charge HTML, pour un aperçu complet des exigences de notre navigateur, cliquez ici.
Pour les utilisateurs d'Internet Explorer, assurez-vous de travailler sur IE11 ou une version ultérieure. Assurez-vous que, dans les paramètres de sécurité, l'option Divers est activée pour l'Internet et l'intranet. 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 intranet local, assurez-vous d'y appliquer également la même modification.
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 entre les 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 d'avoir configuré votre CORS dans votre instance Salesforce.

Impossible de charger XMLHttpRequest, le code de statut de la réponse est 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 Salesforce "verrouille la session à l'adresse IP" est activé, cela signifie que nous ne pouvons envoyer des appels API qu'à partir des serveurs Showpad, car nous avons demandé le jeton Salesforce sur nos serveurs. En utilisant ce jeton d'accès sur une adresse IP différente (votre navigateur), cela ne fonctionnera pas à cause de ce paramètre de Salesforce. Si vous désactivez ce paramètre, le jeton d'accès peut également être utilisé dans le navigateur et vous pourrez effectuer des requêtes Salesforce dans la Web app.
Notez que les applications mobiles n'utilisent pas nos serveurs pour demander un nouveau jeton d'accès, et qu'elles n'ont donc pas ce problème.

Allez dans 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.