Remarque :
ce guide couvre les fonctionnalités de la toute dernière version 1.71 de l'intégration de PandaDoc <> Salesforce.
Remarque:
Certaines images et certains liens dans cet article ne sont disponibles qu'en anglais américain.
Passer à :
Disponibilité du forfait :
PandaDoc : forfait Professionnel annuel* et forfait Entreprise annuel*.
Salesforce : forfaits « Professionel », « Entreprise », « Illimité », « Édition Developpeur » et « Performance ».
*Cette intégration est disponible en tant que module complémentaire payant.
Que pouvez-vous faire avec l'intégration ?
Création et envoi de documents à partir des opportunités, leads, contacts, comptes ou enregistrements d'objets personnalisés de Salesforce ;
Extraction des informations des enregistrements Salesforce dans les documents PandaDoc ;
Remplissage automatique des grilles tarifaires avec les produits Salesforce ;
Utilisation des contacts Salesforce comme destinataires de document;
Synchronisation des données entre Salesforce et PandaDoc (pas disponible dans les éditions Groupe et Professionnel)
Connexion de PandaDoc et Salesforce
Remarque :
consultez notre guide de configuration dans le coin inférieur droit de l'onglet Salesforce dans PandaDoc pour une configuration d'intégration rapide et facile.
Dans PandaDoc, allez dans « Paramètres » > « Intégrations » > Cliquez sur « Salesforce » > choisissez où vous souhaitez activer l'intégration : environnement de production ou Sandbox
Vous devrez peut-être vous connecter à Salesforce à ce stade. Cliquez sur « Autoriser » pour permettreà PandaDoc d'accéder à Salesforce.
Votre compte PandaDoc est désormais connecté à Salesforce. Procédez à l'installation du package PandaDoc sur AppExchange comme décrit dans la section suivante.
Cette intégration permet de créer, suivre et transférer les données vers les documents PandaDoc dans plusieurs espaces de travail. Activez l'intégration une fois et connectez-vous à l'espace de travail souhaité. Dans la section Documents connexes, vous ne verrez que les documents créés dans l'intégration et situés dans l'espace de travail où vous vous êtes connecté. La fonctionnalité qui déclenche la synchronisation ne fonctionnera que pour un espace de travail où vous vous êtes déjà connecté.
Installez le package PandaDoc sur AppExchange
Remarque :
Vous devez posséder les droits d'administrateur Salesforce pour installer le module PandaDoc et le configurer.
Connectez-vous à votre compte Salesforce : https://login.salesforce.com/
Vous pouvez trouver notre application dans SFDC AppExchange ;
Cliquez sur « Obtenir maintenant » ;
Cliquez sur « Installer pour tous les utilisateurs » puis cliquez sur « Mettre à jour ou installer » ;
Sélectionnez « Oui, donner accès à ces sites tiers » et cliquez sur « Continuer ».
Le processus d'installation commencera et pourra prendre du temps. Cliquez surTerminéune fois le processus terminé.
Configuration du module PandaDoc dans l'enregistrement Salesforce
Remarque :
les instructions ci-dessous présentent la configuration de l'opportunité, mais vous pouvez utiliser ce guide pour les autres objets (opportunité, lead, compte et contact).
Avertissement :
si vous utilisez le composant Lightning, suivez les instructions de ce guide d'installation..
Si vous souhaitez ajouter le module PandaDoc à un objet personnalisé, cliquez ici pour en savoir plus.
Allez sur n'importe quel enregistrement sous « Opportunité » et cliquez sur « Modifier la mise en page ». Dans le module « Mise en page de l'opportunité » en haut, allez dans « Champs » et recherchez « Sections » ;
Cliquez sur l'élément « Section » et faites-le glisser à l’endroit où vous souhaitez afficher PandaDoc sur la mise en page de l'opportunité. Une fois ajouté, configurez les propriétés de la section. Nommez cette nouvelle section « Documents PandaDoc ».Définissez la mise en page sur « 1-Column » et sélectionnez « OK »;
Revenez au module « Mise en page de l’opportunité » ci-dessus. Repérez lesPages Visualforcesur la gauche et faites glisserPandaDocvers la section précédemment créée.
À droite, cliquez sur « Propriétés » et définissez la « Hauteur (en pixels) » sur au moins 500. Plus le nombre est grand, plus le module est affiché en grand dans Salesforce ;
Dans le module « Mise en page de l'opportunité » ci-dessus, cliquez sur « Enregistrer » et attendez que la mise en page termine l'enregistrement ;
Allez dans n'importe quel objet sous « Opportunités » pour vérifier le module « Documents PandaDoc ».
Remarque :
si vous avez créé un objet personnalisé, référez-vous àce guide pour savoir comment ajouter PandaDoc aux objets personnalisés dans Salesforce.
Étapes de configuration pour les comptes PandaDoc.eu
Pour configurer votre compte PandaDoc.eu, vous devrez effectuer deux changements importants :
Mettre à jour les Paramètres de PandaDoc pour utiliser le domaine pandadoc.eu :
Dans Salesforce, allez dans « Configuration »
Dans la barre de recherche QuickFind, cherchez « Paramètres personnalisés ».
Sélectionnez « Paramètres personnalisés ».
Sélectionnez « Gérer » à côté de « Paramètres de PandaDoc »
Sélectionnez « Modifier » pour PANDADOC_APP_HOST et PANDADOC_DOCSERVICE_HOST.
Changez le domaine «
com
» en «eu
» et cliquez sur « Enregistrer ».
Pour PANDADOC_APP_HOST, vous devez avoir la valeur de domaine https://app.pandadoc.eu/sdk/.
Pour PANDADOC_DOCSERVICE_HOST, vous devez avoir la valeur de domaine https://api.pandadoc.eu/public/v1/documents/.
Ajoutez api.pandadoc.eu aux Paramètres du site distant.
Dans Salesforce, allez dans « Configuration »
Sélectionnez « Paramètres de site distant »
Sélectionnez « Modifier » à côté de PD_API
Changez le domaine «
com
» en «eu
»
Transfert des données de SFDC dans PandaDoc
Pour transférer les données de Salesforce dans le document PandaDoc, vous devez d'abord créer votre modèle, puis le configurer avec des variables (comme pour Fusionner les champs). Pour en savoir plus sur les variables, cliquez ici.
Remarque :
bien que vous puissiez ajouter vos propres variables dans les documents, configurez des variables pour transférer les informations de Salesforce dans un modèle.
Transfert des champs Salesforce dans PandaDoc (via des variables)
Avant de configurer votre modèle avec des variables, créez une liste de variables pour chaque objet avec lequel vous utiliserez PandaDoc.
Remarque :
les variables doivent être configurées pour chaque objet individuellement. Seules les variables figurant dans la liste de cet objet seront disponibles lors de la création d'un document à partir de ce dernier (aucun remplissage instantané d'objets).
Pour cela, cliquez sur « + » et allez dans Configuration de Pandadoc. Faites défiler le menu jusqu'à « Salesforce dans le flux de données PandaDoc » et cliquez sur « Configurer des objets » ;
Ensuite, choisissez un objet pour lequel vous souhaitez modifier la liste des variables. Si vous avez installé PandaDoc dans un autre objet, cliquez sur « Ajouter un objet »;
Vous verrez une liste des variables par défaut à droite. Pour en ajouter plus, vérifiez les champs que vous souhaitez ajouter à la liste des variables et cliquez sur « Enregistrer » ;
Ouvrez votre modèle PandaDoc dans une fenêtre de navigateur séparée, copiez-collez les noms de variables entre crochets dans le modèle.
Avertissement :
le champ de texte crypté ne peut pas être transféré dans une variable !
Lorsque vous créez un document à partir de Salesforce à l'aide de ce modèle, les variables sont remplies avec les informations de la gestion de la relation client (CRM).
Remarque :
Le formatage des variables de date dépend du format de date par défaut défini dans les paramètres de votre espace de travail.
Le formatage des variables monétaires est basé sur les paramètres régionaux d'affichage du destinataire. Les variables monétaires personnalisées seront transférées dans le document sans symbole monétaire ni formatage.
Vous pouvez également passer en revue la liste des variables avec les données qui seront transférées dans un enregistrement Salesforce.
Ouvrez un enregistrement Salesforce, descendez jusqu'à PandaDoc, cliquez sur l'icône d'engrenage en haut à droite du module et choisissez Variables - voici ce que vous pouvez transférer ;
Ouvrez votre modèle PandaDoc dans une fenêtre de navigateur séparée, copiez-collez les noms des variables entre crochets dans le modèle.
Remarque :
la valeur de la variable transférée dans PandaDoc peut être différente de ce à quoi ressemble le champ dans Salesforce, regardez la deuxième capture d'écran ci-dessous. Cela est dû au fait que PandaDoc transfère la valeur du champ racine et non la valeur affichée dans certains cas. Apprenezici à formater les champs de date transférés par Salesforce.
Remarque :
si le champ dans Salesforce est vide, la variable du documentne se remplira pas et vous devrez la remplir manuellement.
Transfert des destinataires de Salesforce vers PandaDoc
Remarque :
le transfert des informations des destinataires fonctionne mieux avec les rôles de PandaDoc. Apprenez à configurer les rôles dans un modèle ici.
Par défaut, Salesforce transmet les informations du destinataire suivantes selon l'objet où votre module PandaDoc est situé :
à partir d'opportunité : les informations du rôle du contact
à partir du compte : les informations du contact + la possibilité de transmettre les informations du compte
à partir du lead : les informations du lead
à partir du contact : les informations du contact
Vous pouvez configurer le champ de Salesforce qui sera mappé à un rôle dans PandaDoc et configurer les champs qui seront envoyés comme paramètres suivants :
Prénom
Nom de famille
E-mail
Champ de l'entreprise
Champ du téléphone
Champ de rôle
Allez dans « Configurer les destinataires de Pandadoc » ;
Vous verrez le mappage par défaut pour les objets par défaut. Vous pouvez les modifier ou ajouter un nouveau mappage pour les objets personnalisés.
Si vous voulez que PandaDoc mappe automatiquement le destinataire à un rôle spécifique, vous avez besoin de 2 choses :
le champ de rôle configuré dans le mappage des destinataires ;
des noms de rôle identiques dans Salesforce et dans le modèle PandaDoc ;
Si vous l'avez bien configuré, PandaDoc insérera le destinataire concerné dans le rôle respectif lorsque vous créerez des documents.
Remarque :
PandaDoc extraittous les contacts associés de Salesforce dans le document. Si vous voulez en supprimer un, supprimez-le dans la fenêtre contextuelle ou dans la section des destinataires du document.
Si vous générez des documents à partir d'un devis ou d'un cas, vous pouvez utiliser un champ de recherche dans un dossier de contact spécifique. Vous pouvez spécifier les champs de recherche à utiliser comme destinataires en allant dans Configuration de PandaDoc > faites défiler jusqu'à Paramètres de personnalisation d'objets. Trouvez l'objet que vous devez configurer et cliquez sur Configuration dans le côté droit.
Ensuite, choisissez le champ à utiliser comme destinataire et cliquez sur Enregistrer. Vous pouvez choisir jusqu'à cinq champs.
Ensuite, configurez le mappage du destinataire. Et c'est fini !
Destinataire de filtres
Vous pouvez filtrer les contacts qui sont transférés dans les documents PandaDoc comme destinataires en fonction des champs oui ou non dans un dossier (c'est-à-dire les champs booléens).
Allez sur « + » > Configurer les destinataires de PandaDoc;
Faites défiler jusqu'à « Filtrage des destinataires »;
Cliquez sur « Activer le filtrage »;
Choisissez un champ à partir duquel la valeur des destinataires sera filtrée ;
Choisissez la valeur du champ à partir duquel les destinataires seront filtrés : vrai pour oui, faux pour non.
Si vous avez configuré le mappage du destinataire pour les comptes, vous pouvez alors le configurer pour transférer les informations du compte (e-mail, numéro de téléphone, etc.) comme destinataire à PandaDoc.
Pour cela, allez dans Configuration de PandaDoc -> Faites défiler jusqu'à Paramètres du constructeur de JSON, à côté du nom de l'objet du compte, cliquez sur « Configurationde l'objet » -> Cochez la case à côté d'« Envoyer le compte comme destinataire » et cliquez sur « Enregistrer ».
Remarque :
les rôles du contact Salesforce et les rôles de modèle PandaDoc ne peuvent pas avoir 2 contacts affectés à un même rôle.
Si vous avez des suggestions concernant les fonctionnalités de PandaDoc -> soumettez une idée dans la boîte à idées ou contactez-nous.
Transfert des informations de Salesforce vers PandaDoc (via les champs)
Vous pouvez transférer les données dans les champs de PandaDoc de la même manière que vous l'avez fait pour les variables. Cependant, contrairement aux variables, tu n'as pas besoin d'inclure des crochets.
Dans la liste des jetons, copie le jeton sans crochets dans le champ Fusionner.
Une fois le document envoyé, le destinataire verra les données préremplies et pourra mettre à jour ce champ, à condition que ce dernier lui ait été attribué.
Transfert des données du produit de Salesforce dans PandaDoc
PandaDoc peut être configuré pour sélectionner les produits à partir d'une opportunité, des leads, des contacts ou d'un compte et les ajouter à une grille tarifaire dans un document.
Vous pouvez mapper les champs du produit d'un objet dans les champs de la grille tarifaire de PandaDoc pour transférer des données avec encore plus de précision.
Allez dans Configuration de PandaDoc > Configurer les éléments de tarification.
Ajoutez un objet dont vous souhaitez transférer les données du produit et sélectionnez les champs que vous souhaitez mapper dans la grille tarifaire PandaDoc, cliquez sur « Enregistrer » une fois que vous avez terminé.
Ci-dessous, sous Triage d'éléments de tarification, vous pouvez configurer l'ordre dans lequel vous voulez lister les produits dans la grille tarifaire de PandaDoc.
Maintenant, assurez-vous que votre opportunité, lead, contact ou compte a des produits ajoutés. Puis ouvrez votre modèle PandaDoc et ajoutez une grille tarifaire. Dans les propriétés de la grille tarifaire, activez le bouton à bascule Fusionner les données.
Transfert des champs du produit personnalisé dans la grille tarifaire
Parfois, vous devez transmettre plus que les champs standard du produit.
D'abord, ajoutez les champs du produit d'opportunité dans la liste des jetons ou des variables en allant dans Configuration de PandaDoc > Configurer les jetons. Sélectionnez le produit d'opportunité et vérifiez les champs que vous devez transférer à droite et ils apparaîtront dans la liste des jetons à gauche.
Cliquez sur Enregistrer. La configuration est finie !
Assurez-vous que l'importation automatique de la grille tarifaire du modèle est activée.
Lorsque vous créez un document à partir du modèle, cliquez sur le signe plus à droite dans la grille tarifaire.
Sélectionnez les champs du produit personnalisé dans Ajouter un champ caché.
Si l'ajout de champs personnalisés à partir des colonnes cachées chaque fois que vous créez un document vous semble trop compliqué, il y a un moyen de contourner la difficulté.
Créez un document et affichez les champs du produit personnalisé.
Ensuite, cliquez sur les ellipses verticales dans le coin supérieur droit et sélectionnez Convertir en modèle. Votre nouveau modèle s'ouvrira dans un nouvel onglet du navigateur.
Dans le modèle, vous pouvez supprimer les produits de la grille tarifaire, mais assurez-vous de conserver les colonnes de champs personnalisés.
La prochaine fois que vous commencerez un document à partir de Salesforce, utilisez ce modèle. Les valeurs du champ du produit personnalisé rempliront les colonnes.
Création et envoi des documents
Maintenant que vous avez créé et configuré votre modèle, vous pouvez procéder à la création et à l'envoi des documents à partir de Salesforce.
Allez dans un enregistrement, faites défiler le menu jusqu'au module PandaDoc, cliquez sur « Nouveau document ».
Choisissez un modèle ou sélectionnez les modèles que vous souhaitez regrouper, puis sélectionnez Ajouter des éléments et attribuez les destinataires aux rôles, le cas échéant ;
Cliquez sur Continuer et vérifiez votre document (variables, contenu, liste des destinataires, rappels) puis envoyez votre document ;
Vous pouvez maintenant retourner au dossier dans Salesforce et suivre l'état de votre document ;
Lorsqu'un document est achevé, son .pdf s'affichera sous Notes et pièces jointes dans l'enregistrement.
Si vous avez plusieurs espaces de travail et que vous créez des documents à partir d'opportunités ou de comptes dans Salesforce, vous pouvez les configurer pour que les documents de TOUS les espaces de travail s'affichent dans le module PandaDoc. Cliquez ici pour en savoir plus.
Lien d'un document à une opportunité dans Salesforce
Si vous avez un document créé dans PandaDoc que vous souhaitez lier à une opportunité dans Salesforce, nous avons tout prévu !
Dans votre onglet PandaDoc, ouvrez le document, cliquez sur l'icône Salesforce à droite.
Cliquez sur « Lier » et vous serez invité à vous connecter à votre compte Salesforce.
Sélectionnez une opportunité dans la liste puis cliquez sur « Lier ».
À droite, sous « Informations concernant l'opportunité », vous pouvez voir la date de création, l'état et le montant total de l'opportunité. Veuillez noter que les informations concernant l'opportunité affichées dans PandaDoc peuvent avoir besoin d'être actualisées pour vous assurer que vous consultez la dernière mise à jour.
Maintenant, allez dans le dossier d'opportunité de Salesforce et le document sera affiché dans le module PandaDoc comme s'il avait été créé via Salesforce.
Pour dissocier un document d'une opportunité ou le lier à un autre, cliquez sur l'action souhaitée dans le panneau intégrations. Si vous avez créé le document à partir d'un autre objet (compte, contact, etc.), vous ne pouvez pas le dissocier de cet objet et le lier à une opportunité ou afficher les informations connexes.
Actualisation d'un document avec les champs de valeur provenant de Salesforce
Remarque :
le document doit être à l'état de brouillon pour cette fonctionnalité.
Si les informations dans un dossier Salesforce sont mises à jour après la création du document à partir de ce dossier, vous pouvez mettre à jour le document avec les valeurs correctes :
Dans PandaDoc, allez dans le panneau intégrations en cliquant sur l'icône Salesforce à gauche dans le document PandaDoc.
Sous Données du document, sélectionnez « Importer de la gestion de la relation client (CRM) ».
Les variables seront mises à jour avec les dernières informations provenant de Salesforce
Vous pouvez utiliser la fonction « Importer de gestion de la relation client (CRM) » dans n'importe quel objet de Salesforce : opportunité, compte, lead, contact, objets personnalisés.
Si le champ dans Salesforce est vide, la variable correspondante ne sera pas actualisée.
Avertissement :
vous ne pouvez pas mettre à jour votre grille tarifaire avec les données du produit provenant de Salesforce, ni mettre à jour les champs PandaDoc ou les variables de rôle.
FAQ
Comment puis-je vérifier ma version d'intégration ?
Ouvrez votre Salesforce, cliquez sur Configurer en haut, saisissez « packages installés » dans la recherche rapide, puis cliquez sur la section Packages installés qui s'affiche dans la recherche. Trouvez PandaDoc parmi les applications installées et regardez la version dans la colonne numéro de version.
Comment puis-je fournir l'accès à mon compte dans Salesforce à l'équipe de support PandaDoc ?
L'équipe de support peut vous demander l'accès à votre compte dans Salesforce pour vous aider à résoudre un problème ou répondre à une question. N'accordez pas l'accès sans la demande de notre équipe de support.
Dans Salesforce Lightning :
Connectez-vous à votre compte Salesforce, cliquez sur votre image (ou avatar) en haut à droite, puis cliquez sur Paramètres
À gauche, dans la petite case de recherche, saisissez « accorder », puis cliquez sur Accorder l'accès au compte
Dans Salesforce Classic :
Connectez-vous à votre compte Salesforce, puis cliquez sur Mes paramètres en haut à droite. (Autrement, cliquez sur votre nom, puis sur Mes paramètres.)
À gauche, dans la petite case de recherche, saisissez « accorder », puis cliquez sur Accorder l'accès au compte
Définissez à 3 jours la « durée d'accès » pour le « support PandaDoc ».
Ensuite, envoyez un e-mail à notre équipe de support pour lui donner votre ID d'organisation de SalesForce qui se trouve sur la page Informations sur l'entreprise. Cliquez sur Configuration > Profil de l'entreprise > Informations sur l'entreprise et trouvez l'ID à côté de l'ID d'organisation de Salesforce.
Résolution de problèmes
Cliquez sur un problème pour dérouler la solution.
Le module PandaDoc est vide ou affiche le message d'erreur suivant : « Tentative de déréférencement d'un objet nul ». Une erreur inattendue s'est produite.
Cela arrive lorsque l'objet pour lequel vous avez configuré les variables, une grille tarifaire ou le mappage des destinataires est supprimé ou renommé.
Vous pouvez résoudre le problème en suivant ces étapes :
Assurez-vous que vous avez installé la dernière version de l'intégration.
Allez dans Configuration de PandaDoc, cliquez sur Configurer les jetons, puis ouvrez l'objet où s'affiche le message d'erreur ou l'objet qui a un écran vide.
Ajoutez un nouveau champ à partir de la colonne de gauche comme jeton ou variable, puis cliquez sur Enregistrer.
Si le problème persiste, allez dans Paramètres de personnalisation de l'objet dans la page Configuration de PandaDoc, puis cliquez sur Configuration à côté de l'objet où l'erreur est affichée.
Si une page vide s'ouvre, retirez l'objet de la liste, puis rajoutez-le.
Le module PandaDoc affiche l'erreur : « Jeton inattendu « PROVENANT » dans l'opportunité »
Si vous voyez ce message, vous n'avez peut-être pas les autorisations pour certains objets Salesforce liées à l'opportunité. Les exemples possibles sont que les fichiers ne sont pas activés pour votre profil ou votre entreprise a peut-être récemment ajouté un nouvel objet qui n'a pas encore été activé pour votre profil.
Pour résoudre ce problème, demandez à votre administrateur Salesforce de vérifier les autorisations pour votre profil et assurez-vous que vous avez accès aux objets connexes.
Les contacts ne sont pas transférés comme destinataires lorsque vous créez un document à partir d'une opportunité.
Vous avez peut-être tout juste commencé à tester l'intégration avec les contacts de test. Il se peut qu'aucune adresse e-mail ne soit associée à ces contacts dans Salesforce. Pour résoudre ce problème, ajoutez les adresses e-mail aux contacts dans Salesforce, puis essayez de nouveau.
Le module PandaDoc ne se charge pas dans Salesforce pour certains utilisateurs de mon compte/ Certains utilisateurs de mon compte voient l'erreur Autorisations insuffisantes dans le module PandaDoc.
Pour commencer, assurez-vous que l'accès à la définition des paramètres personnalisés pour deux objets PandaDoc (paramètres PandaDoc.pandadoc.PandaDoc et mappage JsonBuilder PandaDoc.pandadoc.PandaDoc) est activé. Vous trouverez ce paramétrage sous Configuration > Profils > Sélectionnez le profil en question.
Ensuite, vous devez permettre à cet utilisateur d'avoir un accès complet aux 7 objets mentionnés ci-dessous. Vous pouvez le faire en allant sur le profil en question et en appuyant sur Modifier, puis en faisant défiler vers le bas jusqu'aux Autorisations d'objets personnalisés.
Statut des docs
Jetons d'objets
Document PandaDoc
Journal PandaDoc
Carte des éléments de tarification
Carte des bénéficiaires
Paramètre du déclencheur
Ensuite, vérifiez l'accès aux champs liés aux 7 objets mentionnés à l'étape précédente. Vous pouvez le faire en allant dans le profil en question et en faisantdéfiler vers le bas jusqu'à l'optio Sécurité au niveau du champ (Sécurité au niveau du champ personnalisé), puis en appuyant sur Voir pour chacun des 7 objets, Modifier et autoriser l'accès en lecture seule à tous les champs.