Intégrer les activités Showpad dans Salesforce

Découvrez comment cela fonctionne sur Salesforce Lightning.

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

Faites ceci é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 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 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 envoyer des demandes à votre instance Salesforce. 

Ceci permet à Showpad de :

• Créer une activité Salesforce chaque fois qu'un utilisateur de l'application Showpad ou de Web app partage du contenu avec un prospect ou un client.
• 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 de 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. 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 que nous n'avons pas pu vérifier la configuration CORS. Vous pourrez 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 vos instance Salesforcedans Showpad. Vous pouvez configurer plusieurs instances Salesforce si votre entreprise en utilise plusieurs.
   Ouvrez la Online Platform Showpad et connectez-vous avec vos informations d'identification d'administrateur.
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, veillez à choisir des noms appropriés pour chaque instance afin de faciliter leur identification.
   • Si vous utilisez un domaine personnalisé pour accéder à Salesforce, tel que 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 informations d'identification Salesforce. En savoir plus sur l'option de provisionnement automatique.
4. Cliquez sur « Suivant » et « Se connecter à Salesforce ».
5. Vous devrez maintenant saisir vos informations d'identification Salesforce. 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'a pas toutes les autorisations administrateur, les autorisations suivantes sont nécessaires :
   Paramètres du système
   • API activé
   • 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 d'objet
   • Lire/Créer/Modifier pour les objets Prospects, Contacts, Opportunités, Comptes.
   • Lire/Créer/Modifier/Supprimer pour les activités Showpad, les éléments d'activités Showpad, les objets Showpad Content & Showpad Content Views.
   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 d'application OAuth.
   Une fois connectée, la Online Platform Showpad s'ouvrira à nouveau. 
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 fonctionnalité, vous devrez installer l'application Showpad pour Salesforce via AppExchange de Salesforce. Cliquez sur Enregistrer.
7. Le dernier onglet que vous verrez permet d'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 dans 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 du SFDC connectée dans le champ « Associé à » d'une tâche. Les utilisateurs ne peuvent pas enregistrer les 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 voir 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 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 par 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 de l'application OAuth de « Appliquer les restrictions IP » à « Assouplir les restrictions IP ».

Le paramètre « Assouplir 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 la 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 d'applications connectées », cliquez sur « Gérer les stratégies d'application ».
4. Cliquez sur « Modifier les politiques ». Cliquez sur le menu déroulant Assouplir IP, puis changez « Appliquer les restrictions IP » à « Assouplir les restrictions IP ».
   
5. Cliquez sur Enregistrer.

La connexion Salesforce ne fonctionne pas sur l'application Web

Assurez-vous que vous travaillez sur un navigateur supporte complètement HTML, pour un aperçu complet des exigences de notre navigateur, cliquez ici.
Pour les utilisateurs d'Internet Explorer, veuillez vous assurer que vous travaillez sur IE11 ou une version plus récente. Veuillez vous assurer que dans les paramètres de sécurité, vous avez défini l'option divers pour activer à la fois Internet et intranet. Si ce n'est pas le cas, Internet Explorer ne permettra pas à la page Showpad de se connecter au domaine Salesforce et d'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 l'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 enregistrez.
6. Assurez-vous également d'appliquer les mêmes paramètres pour leur intranet local.
7. Vous devrez également vous assurer que votre CORS est configuration dans votre instance Salesforce.

XMLHttpRequest ne peut pas se charger, la réponse a le code de statut 401

Pour faire appel à 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 « Verrouiller la session sur 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 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 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, 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 d'où elles proviennent » n'est pas cochée.