Intégrer les activités de Showpad dans Salesforce

Découvrez comment cela se fait sur Salesforce Lightning

• Configurez 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 de Salesforce consiste à autoriser les demandes provenant du domaine Showpad. Salesforce permet à ses clients de contrôler les sites Web 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 tous les autres.

Ce paramètre est appelé CORS (Cross-Origin Resource Sharing) et une configuration est requise pour que Showpad s'intègre à Salesforce. Les instructions ci-dessous montrent comment un administrateur Salesforce peut activer notre domaine Showpad pour effectuer des demandes auprès de votre instance Salesforce. 

Ceci permet :

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

1. Accédez à la page Configuration dans Salesforce.com en tant qu'administrateur Salesforce.
2. Dans le menu de gauche, recherchez CORS. Vous pouvez également sélectionner manuellement les contrôles de sécurité > CORS.
3. Ajoutez 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 la Online Platform de Showpad que nous n'avons pas pu vérifier la configuration CORS. Vous pourrez toujours continuer de 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 vos instance Salesforce dans Showpad. Vous pouvez configurer plusieurs instances Salesforce si votre entreprise en utilise plusieurs.
   Ouvrez la Online Platform de Showpad et connectez-vous avec votre administrateur identifiants.
2. Dans Paramètres, sélectionnez CRM dans la Section intégrations, puis sélectionnez Configurer une instance Salesforce.
3. Saisissez une description pour votre instance Salesforce. Si vous prévoyez de configurer plusieurs instances Salesforce, assurez-vous de choisir les noms appropriés pour chaque instance afin de les identifier plus facilement.
   • Si vous utilisez un domaine personnalisé pour accéder à Salesforce, comme https://companyxyz.my.salesforce.com, activez Utiliser un domaine personnalisé et entrez companyxyz.
   • Les comptes utilisateur Showpad peuvent être créés automatiquement lorsque les utilisateurs se connectent pour la première fois avec leurs identifiants Salesforce. En savoir plus sur l'option d'approvisionnement automatique.
4. Cliquez sur Suivant et sur Se connecter à Salesforce.
5. Vous devrez entrer vos identifiants Salesforce maintenant. Cette connexion sera utilisée en tant qu'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 :
   • Accès API
   • Lecture/écriture pour la tâche, l'événement, tous les objets Showpad
   • Lecture/Écriture pour Prospect, Contact, Opportunité, Compte
   L'intégration fonctionne avec une communication 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ée, la Online Platform de Showpad va se rouvrir. Vos utilisateurs verront un formulaire lors de la création d'un nouveau prospect dans Salesforce. Vous pouvez configurer le formulaire dans cet écran. Répétez les étapes pour le formulaire Contacts.
   • Trois champs sont obligatoires. Par défaut, E-mail, Nom de famille et Prénom sont sélectionnés.
   • Sélectionnez les champs que vous souhaitez inclure.
   • Réorganisez les champs en cliquant, en maintenant et en faisant glisser un champ vers une position différente dans la liste.
   
6. Vous pouvez désormais activer les recommandations de contenu pour vos collègues commerciaux. Reportez-vous à cette page si vous souhaitez plus d'informations. Pour utiliser cette fonction, vous devrez 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 "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, 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 SFDC connectée dans le champ Associé à d'une tâche. Les utilisateurs ne peuvent pas consigner des 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 Groupes sélectionnés.
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, voici à quoi cela ressemblera pour vos utilisateurs.

3. Dépannage de base

Erreur d'authentification OAuth

L'intégration de Showpad et Salesforce fonctionne avec une communication serveur à serveur. Une conséquence de cela est que l'adresse IP de l'utilisateur d'origine sera modifiée avec l'adresse de Showpad pendant le 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 vous recommandons de modifier les paramètres dans l'application OAuth de Appliquer les restrictions IP à Relâcher les restrictions IP.

Le paramètre Relâcher 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 d' intégration Salesforce Showpad et cliquez sur Installer.
3. Dans la liste Utilisation OAuth des applications Connectées, cliquez sur Gérer les stratégies d' application.
4. Cliquez sur Modifier les stratégies. Cliquez sur le menu déroulant Relaxation IP, puis remplacez Appliquer les restrictions IP par Relâcher les restrictions IP.
   
5. Cliquez sur Enregistrer.

La connexion Salesforces ne fonctionne pas sur l'application Web

Assurez-vous que vous travaillez sur un navigateur qui supporte entièrement HTML, pour un aperçu complet des exigences de notre navigateur, cliquez ici.
Pour les utilisateurs d' Internet Explorer, assurez-vous que vous utilisez IE11 ou supérieur. Assurez-vous que dans les paramètres de sécurité, vous disposez de l'option Divers pour activer à la fois Internet et intranet. Si ce n'est pas le cas, l' Internet Explorer ne permettra pas à la page Showpad de se connecter au domaine Salesforce et d'obtenir les données des contacts et des pistes.

1. Accédez à Paramètres, Options d' Internet, Sécurité.
2. Vous verrez une icône Internet, assurez-vous qu'elle est sélectionnée. S'ils utilisent l'intranet local, veillez également à y appliquer 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 enregistrez.
6. Veillez à appliquer les mêmes paramètres pour leur intranet local.
7. Vous devrez également vous assurer d'avoir votre configuration CORS initialisée dans votre instance Salesforce.

XMLHttpRequest ne peut pas se charger, la réponse a le code d'état 401

Pour effectuer des appels 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 sur l'adresse IP" est activé, cela signifie que nous ne pouvons envoyer des appels API que depuis les 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 en raison de ce paramètre 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 demandes Salesforce dans le Web application.
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 sur l'adresse IP à partir de laquelle elles sont originaires n'est pas cochée.