Quels sont les avantages pour vous ?
Grâce à l'intégration Showpad pour Salesforce, les utilisateurs peuvent réduire considérablement leurs tâches administratives. Dans Salesforce, nous autorisons d'abord les demandes provenant du domaine Showpad. Ensuite, nous configurons l’intégration Salesforce dans Showpad.
C'est ce qu'il vous faut pour réussir
- Privilèges d'administrateur actif sur les plateformes Showpad et Salesforce
- Forfait Showpad Ultimate
- Forfait Salesforce Enterprise ou Illimité
- Pour suivre ce guide, passez à l'affichage de Salesforce Classic si l'affichage de Lightning est activé.
Le moyen rapide d'accéder à la génialité
Procédez étape par étape
1. Configurez CORS dans Salesforce
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 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 sa 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.
Cela permettra :
- À Showpad de créer une activité Salesforce chaque fois qu'un utilisateur de l'application Showpad ou de l'application Web 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.
- D'accéder à la page « Configuration » de Salesforce.com en tant qu'administrateur Salesforce.
- Dans le menu de gauche, recherchez « CORS ». Vous pouvez également sélectionner manuellement Contrôles de sécurité > CORS.
- Ajoutez une nouvelle origine en liste blanche.
- 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 de CORS. Vous pourrez toujours continuer à configurer l'intégration même si vous voyez cet avertissement.
- 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 Showpad et connectez-vous avec vos identifiants d'administrateur.
- Dans « Paramètres », sélectionnez « GRC » dans la section « Intégrations », puis sélectionnez « Configurer une instance Salesforce ».
- Entrez une description pour votre instance Salesforce. Si vous prévoyez de configurer plusieurs instances Salesforce, veillez à choisir des appellations appropriées 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 ».
- Les comptes d'utilisateurs Showpad peuvent être créés automatiquement lorsque les utilisateurs se connectent pour la première fois avec leurs identifiants Salesforce. Apprenez-en plus sur l'option de provisionnement automatique.
- Cliquez sur « Suivant » puis sur « Se connecter à Salesforce ».
- Vous devez alors entrer vos identifiants Salesforce. Ces actions permettront à un utilisateur d'intégration de se connecter à Salesforce et il doit être un administrateur actif dans Showpad et Salesforce.
L'intégration fonctionne grâce à une communication de serveur à serveur. Il en résulte que l'adresse IP d'origine ne sera pas la plage IP ou l'adresse IP de la société, mais une adresse IP de Showpad. Si vous utilisez des restrictions d'adresses IP, nous vous conseillons de lire nos « Recommandations concernant le flux d'authentification OAuth de l'application ».
Une fois connecté, la plateforme en ligne Showpad se rouvrira. Vos utilisateurs verront s'afficher un formulaire lors de la création d'un nouveau prospect dans Salesforce. Vous pouvez configurer le formulaire sur cet écran. Répétez les étapes pour le formulaire de contacts.- Trois champs sont obligatoires. E-mail, nom et prénom sont sélectionnés par défaut.
- Sélectionnez les champs que vous souhaitez inclure.
- Réorganisez les champs en cliquant sur un champ, en maintenant et en faisant glisser ce champ vers une position différente de la liste.
- Vous pouvez maintenant 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 devez installer l'application Showpad pour Salesforce via AppExchange de Salesforce. Cliquez sur « Enregistrer ».
- Le dernier onglet que vous verrez sert à activer la connexion avancée à des objets personnalisés. « Compte » et « opportunités » seront sélectionnés par défaut, mais en activant cette fonction, vous pouvez indiquer d'autres objets pertinents pour le champ « Associé à ». Ceci permet à vos utilisateurs de relier les parts à des objets autres que des comptes ou des opportunités lors de l'enregistrement des tâches.
- Dans Salesforce, la case « Autoriser les activités » doit être cochée dans la section « Fonctions facultatives » pour l'objet personnalisé.
- Sélectionnez les objets personnalisés pour 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 enregistrer les réunions dans un objet personnalisé.
- Il est possible de contrôler quels groupes d'utilisateurs peuvent utiliser l'intégration Salesforce. Cliquez sur les groupes qui ont un onglet d'accès et sélectionnez « Tous les utilisateurs » ou « Groupes sélectionnés ».
- 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 de serveur à serveur. En conséquence, l'adresse IP de l'utilisateur d'origine sera remplacée par l'adresse de Showpad lors du processus de connexion.
Dans les cas où des plages IP de connexion sont utilisées ou lorsque les utilisateurs rencontrent des erreurs de connexion OAuth, nous vous recommandons de changer les paramètres de l'application OAuth de l'option « Forcer les restrictions IP » à l'option « 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 « Administrer » de Salesforce.
- Ouvrez les options d’utilisation des applications connectées OAuth dans l’onglet « Gérer les applications ».
- Trouvez l'application Showpad pour Salesforce et cliquez sur « Installer ».
- Dans l'onglet « Applications connectées », vous pouvez voir les politiques de l'application OAuth et changer les paramètres OAuth de l'option « Forcer les restrictions IP » à l'option « Relâcher les restrictions IP ».
La connexion Salesforce ne fonctionne pas sur l'application Web
Assurez-vous de travailler avec un navigateur compatible avec HTML ; pour un aperçu complet des configurations de navigation nécessaires, 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 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.
- Allez à « Paramètres », « Options Internet », « Sécurité ».
- Vous devriez voir une icône Internet ; assurez-vous qu’elle est sélectionnée. Si l'intranet local est utilisé, assurez-vous d'y appliquer le même changement.
- Choisissez « Personnalisé ».
- Faites défiler jusqu'à ce que vous trouviez ce qui se trouve ci-dessous, assurez-vous que « Accès aux sources de données sur plusieurs domaines » est activé
- Appliquez et sauvegardez.
- Veillez également à appliquer les mêmes paramètres à l'intranet local.
- 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 réponse est 401
Pour effectuer des appels d'API Salesforce, il faut disposer d'un jeton d'accès valide. Le jeton d'accès peut être 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 l'on ne peut envoyer des appels d'API que depuis les serveurs Showpad, car le jeton Salesforce a été demandé sur nos serveurs. Utiliser ce jeton d'accès sur une adresse IP différente (votre navigateur) 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 demandes Salesforce dans l'application web.
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.
