Intégrer les activités Showpad dans Salesforce

Avec l'intégration de Showpad à Salesforce, les utilisateurs peuvent réduire considérablement leurs tâches administratives en enregistrant facilement leurs activités Showpad dans Salesforce. Une fois configuré, les utilisateurs auront la possibilité d'enregistrer tout email Showpad, partages de liens, événements de création de Shared Space et invitations de participants au contact, lead, opportunité ou 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.

Vous avez besoin de cela 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)
  • Créer, modifier et afficher les autorisations pour les 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

• Configurez le CORS
• Filtrez les contacts et configurez l'enregistrement des objets
• Assurez-vous que le type de tâche soit approprié
• Dépannage de base

Procédez étape par étape

Configurez le CORS

La première étape pour configurer l'   intégration Salesforce   est d'autoriser les requêtes provenant du domaine Showpad. Salesforce permet à ses clients de contrôler les sites web autorisés à utiliser l'API Salesforce. Cela permet de sécuriser votre instance Salesforce en autorisant uniquement les demandes provenant de sites connus et en refusant toutes les autres.

Ce paramètre est appelé CORS (Cross-Origin Resource Sharing)   et une configuration est nécessaire 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.

Configurer cela permet :

• À 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. Lorsque les utilisateurs composent un partage par e-mail, Salesforce récupérera les entrées suggérées à partir de votre liste de contacts complète. Influencer et limiter cette requête est possible pour certains cas d'utilisation. Si vous souhaitez afficher des valeurs de champ personnalisées de Salesforce liées au Contact ou au Lead dans les résultats de recherche de contacts dans Showpad, veuillez contacter votre CSM.

Filtrez les contacts et configurez l'enregistrement des objets

1. Commencez par sélectionner quels contacts apparaîtront lorsque les utilisateurs envoient un email Share dans Showpad. Dans les intégrations, sélectionnez CRM dans le menu de gauche. Choisissez votre intégration Salesforce et faites défiler jusqu'à la section des données CRM à Showpad. Cliquez sur Modifier à côté de Visibilité des données.
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 la journalisation avancée vers des objets personnalisés, naviguez jusqu'à la section des données Showpad vers CRM et cliquez sur Modifier à côté de Journalisation.
5. Le compte et l'opportunité seront sélectionnés par défaut. Vous pouvez cocher d'autres cases pour indiquer d'autres objets personnalisés pertinents pour le champ "Lié à". Cela permet aux utilisateurs de relier des partages à des objets autres que les comptes ou les opportunités lors de la consignation des tâches.
6. 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é.
7. 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é.
8. Il est possible de contrôler quels groupes d'utilisateurs peuvent enregistrer des activités dans l'intégration Salesforce. Lorsqu'ils sont activés, ces utilisateurs peuvent enregistrer des activités, ainsi qu'accéder aux informations de partage et aux recommandations de contenu en utilisant l'application Showpad Insights dans Salesforce.
   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 ».
9. 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.
10. 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, veuillez revenir à la configuration du CRM dans la plateforme en ligne de Showpad. Dans la section de journalisation, cliquez sur Modifier pour ouvrir, puis enregistrez à nouveau vos objets de journalisation. Cela resynchronisera le paramètre de contacts multiples de Salesforce.
11. Pour les Shared Spaces connectés à un compte ou à une opportunité, nous nous connecterons automatiquement au CRM lorsqu'un participant externe invite un autre participant, afin d'assurer la visibilité des vendeurs dans leur CRM.

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 les paramètres de session et assurez-vous que la case « verrouiller les sessions à l'adresse IP » d'où elles proviennent ne soit pas cochée.