Intégrer les activités Showpad dans Salesforce

Grâce à l'intégration Showpad pour Salesforce, les utilisateurs peuvent réduire considérablement leurs tâches administratives en enregistrant facilement leurs activités Showpad dans Salesforce. Une fois la configuration effectuée, les utilisateurs ont 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 sur la online platform 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 Illimité
• Les utilisateurs qui enregistrent leur activité dans Salesforce ont besoin de :
  • Accès API
  • Accès aux enregistrements auxquels vous souhaitez qu'ils se connectent (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 online platform de Showpad. Lisez comment procéder ici.

Regardez comment ça marche

• Configurez 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 CORS

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 permet :

• À 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.

1. D'accéder à 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. D'ajouter 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 de 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 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 (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 peuvent pas enregistrer les réunions dans un objet personnalisé.
7. Il est possible de contrôler quels groupes d'utilisateurs peuvent utiliser l'intégration Salesforce. Dans les paramètres de l'administrateur, cliquez sur « Fonctionnalités » dans le menu latéral gauche. Faites défiler vers le bas jusqu'à « Connexion Salesforce » sélectionnez « Tous les utilisateurs » ou « Groupes sélectionnés ». Si vous le souhaitez, choisissez les groupes auxquels vous souhaitez accorder l'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 des informations relatives à 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 que les tâches aient un type défini, ces valeurs doivent être présentes dans Salesforce avant que vous connectiez votre instance Salesforce à la online platform. Pour les ajouter par la suite, vous pouvez déclencher une re-synchronisation 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 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 en passant 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.

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 pour Salesforce et cliquez sur « Installer ».
3. Dans la liste « Utilisation des applications connectées OAuth », cliquez sur « Gérer les politiques des applications ».
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 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.
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 à l'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 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 depuis 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.

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