Intégrer les activités Showpad dans Salesforce

Grâce à l'intégration Salesforce de Showpad, les utilisateurs peuvent considérablement réduire leurs tâches administratives en enregistrant facilement leurs activités Showpad dans Salesforce. Lorsque c'est configurée, les utilisateurs auront la possibilité d'enregistrer tout partage d'e-mails ou de liens Showpad vers le contact, le prospect, l'opportunité ou le compte correspondant dans Salesforce. Dans Salesforce, nous autorisons d'abord les demandes provenant du domaine Showpad. Ensuite, nous configurons les paramètres dans la plateforme en ligne de Showpad.

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 Unlimited
• Les utilisateurs qui enregistrent leur activité dans Salesforce ont besoin de :
  • Accès à l'API
  • Accès aux enregistrements que vous souhaitez qu'ils enregistrent (tels que Compte, Opportunité, Prospect et Contact)
  • Autorisation pour créer, modifier et afficher des Tâches.
• Avant de suivre ces étapes, assurez-vous que votre instance Salesforce est connectée à la plateforme en ligne de Showpad. Lisez comment procéder ici.

Découvrez comment cela fonctionne

• À Showpad de créer une activité Salesforce chaque fois qu'un utilisateur de l'application Showpad ou de la Web app 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.

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 Contrôles de sécurité > CORS.
3. Ajoutez une nouvelle origine autorisée.
4. Ajoutez https://*.showpad.biz et cliquez sur « Enregistrer ». Là, vous utiliserez un astérisque à la place du nom de votre entreprise.

   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 CORS. Vous pourrez toujours continuer à configurer l'intégration même si vous voyez cet avertissement.

5. Lors de la création d'un partage d'e-mail, Salesforce recherche des entrées suggérées dans toute votre liste de contacts. Il est possible d'influencer et de limiter cette requête dans certains cas d'utilisation. Consultez votre customer success manager pour en savoir plus.

Filtrez les contacts et configurez l'enregistrement des objets

1. Commencez par sélectionner les contacts que les utilisateurs peuvent visualiser dans l'onglet « Filtres ». Ce seront les contacts qui s'afficheront lors de l'envoi d'un partage d'e-mail dans Showpad. Dans la section Données CRM vers Showpad, cliquez sur « Modifier pour Filtrer les contacts et les prospects ».
2. Choisissez si les utilisateurs peuvent visualiser :
   • Tous les contacts (c'est-à-dire tous les contacts auxquels ils ont accès dans Salesforce en fonction de leurs paramètres de profil, d'autorisations et de règles de partage).
   • Uniquement leurs contacts de l'utilisateur (c'est-à-dire uniquement les contacts dont ils sont propriétaires dans Salesforce).
3. Cliquez sur « Enregistrer ».
4. Pour activer l'enregistrement avancé vers des objets personnalisés, accédez à la section « Données Showpad vers CRM » et cliquez sur « Modifier ». « Compte » et « 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 « Associé à ». Ceci permet à vos utilisateurs d’associer des partages à des objets autres que des comptes ou des opportunités lors de l'enregistrement des tâches.
5. Dans Salesforce, les cases « Autoriser les activités » et « Autoriser la recherche » doivent être cochées dans les sections « Fonctions facultatives » et « Rechercher le statut » pour l'objet personnalisé.
6. 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 sont pas en mesure d'enregistrer des réunions dans un objet personnalisé.
7. Il est possible de contrôler quels groupes d'utilisateurs peuvent enregistrer des activités dans l'intégration Salesforce. Dans les paramètres d'administrateur, cliquez sur « Propriétés » dans le menu de gauche. Faites défiler jusqu'à « Connexion d'activité Salesforce » et sélectionnez « Tous les utilisateurs » ou « Sélectionner des groupes ». Si vous le souhaitez, choisissez les groupes auxquels vous souhaitez avoir accès, puis cliquez sur « Appliquer ».
   
8. 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 la tâche. Selon la manière dont vos paramètres sont configurés, cela ressemblera à ceci pour vos utilisateurs.
9. Facultativement, vous pouvez permettre que l'activité de partage d'e-mails de Showpad soit enregistrée vers plusieurs contacts. Pour ce faire, naviguez dans Salesforce jusqu'à « Configuration », « Paramètres fonctionnalité », « Ventes », puis « Paramètres activité ». Activez l'option « Autoriser l'association pour les utilisateurs ».
   Si vous avez déjà connecté votre instance Salesforce à Showpad avant d'activer cette option, revenez au CRM configuré sur la online platform de Showpad. Dans la section d'enregistrement, cliquez sur « Modifier » pour ouvrir puis enregistrez à nouveau vos objets à enregistrer. Cela permettra de resynchroniser le paramètre de contacts multiples de Salesforce.
10.  

Assurez le type de tâche

Lors de la création des activités enregistrées, Showpad peut régler le champ « Type » de Salesforce sur une valeur pertinente basée sur le type spécifique de partage enregistré (partage Showpad, e-mail Showpad, shared space, etc.), ce qui peut faciliter la création de rapports. Pour garantir que les tâches obtiennent ce type, ces valeurs doivent être présentes dans Salesforce avant de connecter votre instance Salesforce à la plateforme en ligne. Pour les ajouter ultérieurement, vous pouvez déclencher une resynchronisation des types de tâches disponibles en ouvrant et en réenregistrant l'onglet des objets personnalisés comme décrit à l'étape 2 ci-dessus.

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 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 « Administrer » de Salesforce.

1. Dans « Configuration », recherchez «Applications connectées ». Ouvrez les options d’utilisation des applications connectées OAuth dans l’onglet « Gérer les applications ».
   
2. Trouvez l'application Showpad intégration pour Salesforce et cliquez sur « Installer ».
3. Depuis la liste « Utilisation OAuth des applications connectées », cliquez sur « Gérer les politiques de l'application ».
4. Cliquez sur « Modifier les politiques ». Cliquez sur le menu déroulant « Relâcher restrictions IP », puis remplacez « Forcer les restrictions IP » par « Relâcher les restrictions IP »
   
5. Cliquez sur « Enregistrer ».

La connexion Salesforce ne fonctionne pas sur la Web app

Assurez-vous que vous travaillez sur un navigateur qui prend entièrement en charge HTML, pour un   aperçu complet de nos exigences en matière de navigateur, cliquez  ici.
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.

1. Allez à « Paramètres », « Options Internet », « Sécurité ».
2. 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.
3. Choisissez « Personnalisé ».
4. Faites défiler jusqu'à ce que vous trouviez ce qui se trouve ci-dessous, assurez-vous que « Accès aux sources de données de 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 configuration CORS est dans votre instance Salesforce.

XMLHttpRequest ne peut pas être chargé, la réponse a un code d'état 401

Pour effectuer des appels d'API Salesforce, il faut disposer 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, parce que nous avons demandé le jeton Salesforce 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 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.

Allez dans « Paramètres de session » et assurez-vous que la case « Verrouiller la session sur l'adresse IP » n'est pas cochée.