Ce que vous y gagnez
Grâce à l'intégration Salesforce de Showpad, les utilisateurs peuvent réduire considérablement leurs tâches administratives. Dans Salesforce, nous autorisons d'abord les requêtes provenant du domaine Showpad. Ensuite, nous configurons l'intégration Salesforce dans Showpad.
Ce qu'il vous faut pour réussir
- Privilèges d'administrateur actif sur les plateformes Showpad et Salesforce
- Plan Showpad Ultimate
- Forfait Salesforce Enterprise ou Illimité
Sélectionnez votre expérience Salesforce
![]() Classique |
![]() Accéléré |
Découvrez comment cela fonctionne sur Salesforce Classic
- Configurer CORS dans Salesforce Classique
- Configurez une instance Salesforce dans Showpad
- Dépannage de base
Procédez étape par étape.
1. Configurer CORS dans Salesforce Classic
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 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.
Cela 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.
- Accédez à 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.
- Ajouter 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 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.
- Pour connecter Salesforce et Showpad, vous devez configurer votre instance Salesforce dans 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. - Dans Paramètres, sélectionnez CRM 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 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.
- 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.
- Cliquez sur Suivant et Se connecter à Salesforce.
- Vous devrez maintenant entrer 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'est pas un administrateur complet, les autorisations suivantes sont nécessaires :- Accès API
- Lecture / écriture pour tâche, événement, tous les objets Showpad
- Lecture / écriture pour prospect, contact, opportunité, compte
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.
- Vous pouvez maintenant activer les recommandations de contenu pour vos collègues de vente. 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.
- Le dernier onglet que vous verrez sert à activer l'accès avancée aux objets personnalisés. Le compte et l'opportunité seront sélectionnés par défaut et vous pouvez cocher d'autres cases pour indiquer d'autres objets personnalisés pertinents pour le champ « Relatif à ». Cela permet à vos utilisateurs d'associer des partages à des objets autres que des comptes ou des opportunités lors des tâches.
- Dans Salesforce, la case Autoriser les activités doit être cochée dans la Section Fonctions facultatives de l'objet personnalisé.
- 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é.
- 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.
- Lorsqu'un partage est enregistré, vous verrez le corps de l'e-mail et un lien pour afficher les destinataires 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 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 de 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.
- Veuillez ouvrir les options d’utilisation des applications connectées dans l’onglet Gérer les applications.
- Trouvez l'application Salesforce Showpad intégration et cliquez sur Installer.
- Dans l'onglet applications connectées, vous pouvez voir les stratégies OAuth et changer Appliquer des restrictions IP pour assouplir les restrictions IP.
la connexion Salesforce ne fonctionne pas sur le 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.
- Allez dans Paramètres, Options Internet, Sécurité.
- 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.
- Choisissez Personnalisé.
- Faites défiler jusqu'au bas, assurez-vous que l'accès aux sources de données sur plusieurs domaines est activé
- Veuillez appliquer et sauvegarder.
- Veillez également à appliquer les mêmes paramètres à leur 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 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 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.
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.
- Accédez à 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.
- Ajouter 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 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.
- 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. - Dans Paramètres, sélectionnez CRM 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 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.
- Cliquez sur Suivant et Se connecter à Salesforce.
- 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
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.
- 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.
- 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.
- 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.
- 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é.
- 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.
- 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.
- Dans Configuration, recherchez les applications connectées. Ouvrez les options d’utilisation des applications connectées OAuth dans l'onglet Gérer les applications.
- Trouvez l'application intégration Salesforce Showpad et cliquez sur Installer.
- Dans la liste Utilisation des applications Connect OAuth, cliquez sur Gérer les stratégies d'application.
- 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.
- 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.
- Allez dans Paramètres, Options Internet, Sécurité.
- 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.
- Choisissez Personnalisé.
- 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é
- Appliquez et sauvegardez.
- Veillez également à appliquer les mêmes paramètres à leur 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 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.