Intégrer des activités Showpad dans Salesforce

Découvrez comment cela fonctionne sur Salesforce Lightning

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

Procédez é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 de Salesforce. Cela permet de sécuriser votre instance Salesforce en n'autorisant que les demandes 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. 

Ceci permet :

• à Showpad de 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 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 de 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. Ajouter une nouvelle origine en 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 Showpadde Online Platform que nous n'avons pas pu vérifier la configuration de CORS. Vous pourrez toujours continuer à configurer l'intégration lorsque vous verrez cet avertissement.

2. Configurez 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 société en utilise plusieurs.
   Ouvrez l'Online Platform de Showpad et connectez-vous avec vos identifiants d'administrateur.
2. Dans Paramètres, sélectionnez CRM dans la Section intégrations, puis sélectionnez Configurer 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, veuillez activer Utiliser un domaine personnalisé et entrez companyxyz.
   • 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 Se connecter à Salesforce.
5. Vous devrez maintenant entrer vos informations d'identification Salesforce. Ces informations seront utilisées en tant qu'utilisateur d'intégration pour se connecter à Salesforce.
   Si le profil utilisé pour configurer cette intégration n'est pas celui d'un administrateur total, les autorisations suivantes seront nécessaires :
   • Accès API
   • Lecture / écriture pour tâche, événement, tous les objets Showpad
   • Lecture / écriture pour prospect, contact, opportunité, compte
   L'intégration fonctionne avec une communication de serveur à serveur. Il en résulte que 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 IP, nous vous conseillons de lire nos recommandations de l'application OAuth.
   Une fois connecté, l'Online Platform de Showpad se ré-ouvrira. 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, Email, Nom et Prénom sont sélectionnés.
   • Sélectionnez les champs que vous souhaitez inclure.
   • Réorganisez les champs en cliquant dessus, en maintenant et en faisant glisser un champ vers une position différente de la liste.
   
6. Vous pouvez maintenant activer les recommandations de contenu pour vos collègues commerciaux. Veuillez vous reporter à cette page si vous souhaitez avoir 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 sert à activer la journalisation avancée d’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 d'un objet personnalisé, la case Autoriser les activités doit être cochée dans la Section Fonctionnalités facultatives.
9. Veuilez sélectionner 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é à une tâche. Les utilisateurs ne peuvent pas enregistrer les réunions dans un objet personnalisé.  
10. Il est possible de contrôler les groupes d'utilisateurs pouvant 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 de l'information de tâche. Selon la manière 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 d'un serveur à l'autre. En conséquence, 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 de connexion IP 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 en appliquant des restrictions d'application IP à des restrictions d'assouplissement IP.

Le paramètre de restrictions Relax 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 les applications connectées. Ouvrez les options d’utilisation des 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 des applications Connect OAuth, cliquez sur Gérer les stratégies d'application.
4. Cliquez sur Modifier les politiques. Cliquez sur le menu déroulant Relaxation IP, puis modifiez l'option Appliquer les restrictions IP en Assouplir les restrictions IP.
   
5. Cliquez sur Enregistrer.

La connexion Salesforce ne fonctionne pas sur la Web app

Assurez-vous de travailler sur un navigateur qui supporte pleinement le langage HTML. Pour un aperçu complet de nos exigences de 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é, vous avez l'option Divers définie sur Activer 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 l'intranet local, assurez-vous d'y appliquer le même changement.
3. Choisissez Personnalisé.
4. Faites défiler jusqu'à ce que vous trouviez le bas, 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 système CORS est configuré 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 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 de l'adresse IP » est activé, cela signifie que nous ne pouvons envoyer que des appels d'API à 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 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'origine n'a pas été cochée.