Passer au contenu principal

Salesforce - [ADMIN] Installation et configuration


Prérequis

Avant l'étape 3, assurez-vous d'avoir défini quelles données doivent être mises en correspondance entre les deux systèmes.


Administrateurs Salesforce

1. Installation du widget (une seule fois, 15 min)

⚙️ Installer et configurer le widget (3 min)

​

Rendez-vous à l'URL d'installation :

Choisissez les utilisateurs pour lesquels l'application sera installée :

  • Notre recommandation : installez-la uniquement pour les administrateurs ou pour des profils précis, si tous les administrateurs ne doivent pas accéder à la configuration du widget.

🗒️ Configurer la mise en page (3 min)

Une fois l'installation terminée, choisissez où afficher le composant Tomorro.

Vous pouvez l'ajouter sur les pages Opportunity, Account ou Case.

Nous montrons ici l'installation sur la page Opportunity. Les étapes sont les mêmes pour la page Account :

  • Allez dans Setup > Object Manager > Opportunity > Lightning Record Pages

  • Choisissez la mise en page à modifier et cliquez sur « Edit »

  • Dans le Lightning App Builder, cherchez le composant « Tomorro - Créer et suivre un contrat », glissez-le à l'emplacement voulu sur la page, puis cliquez sur « Save »

✔️ Vérifier les paramètres d'API (3 min)

1. Custom Settings (Setup > Custom Code > Custom Settings)

Vérifiez, sous « Organization Level Value » :

Si ce n'est pas le cas : créez une nouvelle entrée (utilisez toujours la zone verte, jamais la rouge) ⚠️

2. Remote Site Settings (Setup > Security > Remote Site Settings)

Vérifiez, dans la ligne « Tomorro » :

3. Utilisateurs administrateurs qui installent le widget

Assurez-vous que les administrateurs qui installent le widget ont la permission « Approve Uninstalled Connected Apps » dans leur profil.

👨‍👩‍👧‍👧 Configurer les autorisations (3 min)


​Pour que des personnes puissent utiliser Tomorro dans Salesforce, vous devez leur donner des autorisations.

  • Allez dans Setup > Permission Sets.

Tomorro Admin

Ce jeu d'autorisations doit être attribué à toute personne qui doit configurer l'application Tomorro dans Salesforce.

  • Dans la liste des jeux d'autorisations, cliquez sur Tomorro Admin

  • Cliquez sur Manage Assignments > Add Assignments et sélectionnez les utilisateurs qui doivent accéder à la configuration Tomorro
    ​

  • Ne définissez pas de date d'expiration.

Tomorro Nutzer (utilisateur Tomorro)

Ce jeu d'autorisations doit être attribué à tous les utilisateurs qui doivent créer et générer des contrats dans Tomorro depuis Salesforce.

🔌 Connecter Salesforce depuis Tomorro (3 min)

Allez dans Tomorro et connectez-vous à Salesforce avec le bouton vert « Se connecter à Salesforce ».

N'oubliez pas d'activer « Utiliser une instance sandbox » si vous vous connectez à votre environnement sandbox Salesforce.


Administrateurs Tomorro et Salesforce Operations Specialist

2. Configurer le déclencheur

✍️ Configurer la génération manuelle

Dans Salesforce, cherchez Tomorro-Konfiguration (configuration Tomorro) avec l'App Launcher.

Choisissez d'abord les actions que les utilisateurs peuvent réaliser : Démarrer la négociation, Enregistrer le document signé, ou les deux

Choisissez ensuite si vous voulez que les fichiers « Notes & Attachments » soient automatiquement importés dans Tomorro comme pièces jointes du contrat

⚙️ Configurer la génération automatique

Dans Tomorro, ouvrez l'onglet « Création automatique de contrat » et cliquez sur « Créer un nouveau workflow ».

À savoir :

Le compte administrateur qui crée le workflow sera le créateur de chaque nouveau contrat Tomorro généré par ce workflow.

De plus, la configuration ajoute par défaut le propriétaire de l'objet Salesforce (s'il existe) à chaque nouveau contrat Tomorro généré par ce workflow.

Vous pouvez aussi ajouter d'autres membres depuis Salesforce, en mettant des contacts en correspondance (voir la section plus bas).

Remarque : Chaque « intégration » est conçue pour 1 type de contrat et 1 valeur de déclencheur dans Salesforce. Vous pouvez en créer plusieurs pour différents cas d'usage.

Exemple :

  • Une pour le type de contrat « NDA » quand le statut = « Nouveau partenaire »

  • Une pour le type de contrat « Conditions générales » quand le statut = « Devis / demande de prix »

Étape 1 : Nommez votre workflow

Étape 2 : Authentifiez-vous avec votre compte administrateur Salesforce

Étape 3 : Choisissez votre type de contrat et le modèle par défaut

Le modèle par défaut ne s'applique que si le champ de langue Salesforce (voir « Champ de langue du modèle » plus bas) est vide ou incorrect.

Étape 4 : Choisissez l'objet Salesforce, le nom du statut et la valeur qui déclenche le workflow

Exemple : Chaque fois qu'une nouvelle phase d'Opportunity est définie sur « Devis / demande de prix », le workflow se déclenche.

Remarque : faites attention au nom d'API, pas aux libellés !

Étape 5 : Saisissez l'e-mail de contact demandé.


Champ de langue du modèle (facultatif) : Le champ TomorroTemplateLanguage__c n'est pas créé par une étape de l'assistant, mais par un traitement préalable distinct.

Ce champ permet aux commerciaux de créer le contrat dans la langue souhaitée !

Le champ est créé automatiquement : il vous suffit de l'ajouter à la page Lightning de votre objet.

⚠️ Ne supprimez pas le champ TomorroTemplateLanguage__c.

Bon à savoir :

  • Le champ doit avoir la bonne valeur avant le déclenchement du workflow

  • Si une valeur est définie mais qu'aucune langue de modèle correspondante n'existe dans Tomorro, la langue par défaut (étape 3) est utilisée

Configuration administrateur : informations complémentaires

  • Les options de la liste de sélection peuvent être supprimées. Les libellés peuvent être renommés

  • Si le champ n'est pas visible dans l'édition de la page Lightning : vérifiez la « Field-Level Security » (sécurité au niveau du champ) et rendez-le visible

  • Pour automatiser ce champ (champ formule), il faut supprimer le champ d'origine et en créer un nouveau :

Détail du champ

Libellé du champ : au choix

Nom du champ : TomorroTemplateLanguage

Nom d'API : TomorroTemplateLanguage__c

Libellés des valeurs : au choix

Valeurs (nom d'API) :

  • tomorro_at → 🇦🇹

  • tomorro_bg → 🇧🇬

  • tomorro_br → 🇧🇷

  • tomorro_cz → 🇨🇿

  • tomorro_de → 🇩🇪

  • tomorro_dk → 🇩🇰

  • tomorro_ee → 🇪🇪

  • tomorro_es → 🇪🇸

  • tomorro_fi → 🇫🇮

  • tomorro_fr → 🇫🇷

  • tomorro_gb → 🇬🇧

  • tomorro_gr → 🇬🇷

  • tomorro_hi → 🇮🇳

  • tomorro_hr → 🇭🇷

  • tomorro_hu → 🇭🇺

  • tomorro_id → 🇮🇩

  • tomorro_ie → 🇮🇪

  • tomorro_is → 🇮🇸

  • tomorro_it → 🇮🇹

  • tomorro_jp → 🇯🇵

  • tomorro_lt → 🇱🇹

  • tomorro_lv → 🇱🇻

  • tomorro_nl → 🇳🇱

  • tomorro_no → 🇳🇴

  • tomorro_pl → 🇵🇱

  • tomorro_pt → 🇵🇹

  • tomorro_ro → 🇷🇴

  • tomorro_rs → 🇷🇸

  • tomorro_ru → 🇷🇺

  • tomorro_se → 🇸🇪

  • tomorro_si → 🇸🇮

  • tomorro_sk → 🇸🇰

  • tomorro_th → 🇹🇭

  • tomorro_tj → 🇹🇯

  • tomorro_uk → 🇺🇦

  • tomorro_us → 🇺🇸

  • tomorro_uz → 🇺🇿

  • tomorro_vi → 🇻🇳

  • tomorro_zh-cn → 🇨🇳

  • tomorro_zh-tw → 🇹🇼

3. Configurer la correspondance

Mettre des champs personnalisés en correspondance

Allez dans Intégrations, ouvrez dans la zone « Intégrations natives de l'espace de travail » la carte Salesforce avec « Gérer l'intégration », puis choisissez l'onglet « Correspondance des champs ».

1re colonne : Champ Tomorro

Tous les champs personnalisés sont proposés, sauf Langue et Date de création (les champs déjà mis en correspondance ne sont plus proposés).

2e colonne : Champ Salesforce

Les données doivent toujours partir de l'objet auquel le widget est rattaché (ici : Opportunity). Vous pouvez récupérer le chemin des champs voulus directement dans cet objet ou dans des objets imbriqués.

Remarque : si aucune valeur n'est proposée, connectez-vous d'abord à Salesforce (en haut à droite).

3e colonne : Synchronisation

Vous réglez ici le sens de synchronisation de chaque champ (voir « De Tomorro vers Salesforce : synchroniser les champs personnalisés »).

Vous pouvez vérifier la correspondance directement dans l'application.

Utilisez le bouton « Vérifier la correspondance » sous la liste des correspondances (Salesforce doit être connecté). Le bouton apparaît dès qu'au moins un champ est mis en correspondance.

Cela doit vous aider à repérer rapidement les problèmes éventuels et à contrôler la configuration lors des modifications.

Cas particulier : mettre en correspondance les options d'une liste de sélection

Allez dans Composants dynamiques > Champs personnalisés, ouvrez le champ voulu (uniquement les champs de type liste de sélection, pas les champs de base), cliquez sur « Intégration » puis sur « Ajouter une intégration », choisissez Salesforce et saisissez, pour chaque option, l'ID externe.

Mettre des tableaux dynamiques en correspondance (seulement si nécessaire)

⚠️ Prérequis : les tableaux dynamiques doivent d'abord être configurés dans un modèle dans Tomorro.

Dans Salesforce, avec l'App Launcher, cherchez Tomorro-Konfiguration

Allez dans Dynamic Object Mapping Configuration

  • Cliquez sur New

    • Choisissez votre tableau dynamique Tomorro sous « Tomorro Custom Object Name »

      • ici : « Products »

    • Choisissez le « Salesforce Parent Object Name »

      • Là où le flux démarre dans Salesforce

    • Choisissez le « Salesforce Child Object Name »

      • L'élément Salesforce à mettre en correspondance avec les tableaux dynamiques de Tomorro

  • Mettez ensuite en correspondance tous les champs personnalisés voulus

Autres réglages (facultatif)

De Salesforce vers Tomorro : synchroniser les contacts

Allez dans Intégrations, ouvrez l'intégration Salesforce (« Gérer l'intégration ») et choisissez l'onglet « Correspondance des contacts ».

Vous pouvez mettre vos contacts Salesforce en correspondance avec vos contacts Tomorro. Vous pouvez mettre en correspondance les participants comme les signataires (internes et externes).
​

Exemple de correspondance :

1er champ : chemin Salesforce vers l'objet rôle

  • Où le contact ou l'utilisateur est-il stocké dans l'objet Salesforce ?

    • par ex. Opportunity.OpportunityContactRole

2e champ : chemin Salesforce vers le champ e-mail

  • Où l'e-mail est-il stocké ?

    • par ex. Contact.Email ou User.Email

3e champ : chemin Salesforce vers le champ rôle

  • Permet de filtrer pour ne pas tout sélectionner,

    • par ex. Role, Region__c

4e champ : nom du rôle Salesforce

  • Résultat du filtre défini dans le troisième champ,

    • par ex. Decision Maker

Remarque : le champ « Nom du rôle Salesforce » (4e champ) doit être le nom d'API.

De Tomorro vers Salesforce : synchroniser les champs personnalisés

Allez dans l'onglet « Paramètres » de l'intégration Salesforce. Sous « Synchronisation des données de Tomorro vers Salesforce », vous réglez quand les champs sont synchronisés de Tomorro vers Salesforce : « Toujours », « Jamais » ou « Quand le contrat a un statut spécifique » (vous choisissez ensuite les statuts avec « Sélectionner les statuts »). « Jamais » arrête seulement la mise à jour de l'objet Salesforce lié ; l'enregistrement de contrat continue d'être mis à jour. Cette synchronisation ne fonctionne que si votre compte Salesforce est connecté dans Tomorro.

Le sens de synchronisation de chaque champ personnalisé se règle dans l'onglet « Correspondance des champs », colonne « Synchronisation ». Choix possibles :

  • Salesforce > Tomorro

  • Tomorro > Salesforce

  • Dans les deux sens

Le champ « Date de signature » est fixé sur « Tomorro > Salesforce » et ne peut pas être modifié.

Avertissement :

Certains champs Salesforce ne peuvent pas, par nature, être resynchronisés depuis Tomorro : ils sont en lecture seule et leur valeur est calculée par Salesforce lui-même.

Quelle que soit la valeur que Tomorro (ou un autre système) y écrit, Salesforce l'écrase immédiatement avec son propre calcul.

Exemples : champs formule, UUID...

De Tomorro vers Salesforce : récupérer les PDF signés

Allez dans l'onglet « Paramètres » de l'intégration Salesforce et activez, sous « Stockage », l'option « Archivage des documents signés dans Salesforce ».

Utiliser l'enregistrement de contrat Tomorro dans Salesforce

Pour chaque contrat lié à un enregistrement Salesforce, un enregistrement correspondant est automatiquement créé dans Salesforce (leeway__LeewayContract__c).

Cet enregistrement offre une vue complète et native du contrat directement dans Salesforce, sans synchronisation manuelle. Il sert de base à toutes les automatisations autour de vos contrats (flows, règles de validation, rapports, tableaux de bord, etc.).

L'enregistrement contient par défaut :

  • Identifiants du contrat : ID, nom, URL

  • Détails du contrat : créateur, nom du type de contrat, etc.

  • Champs du cycle de vie : statut du contrat, phase de négociation, date de création, etc.

  • Parties : nom de la contrepartie, type d'objet lié, etc.

Comme il s'agit d'un objet Salesforce personnalisé, sa mise en page est entièrement personnalisable comme n'importe quel autre objet Salesforce : vous pouvez ajouter ou retirer des champs, réorganiser les sections, ajouter des listes associées, créer des boutons personnalisés et adapter les mises en page selon le profil ou le type d'enregistrement, pour correspondre à la façon de travailler de vos équipes.

💡 Astuce : comme l'enregistrement est créé automatiquement quand un contrat est créé dans Tomorro, vous pouvez déclencher des flows Salesforce à la création du contrat (par ex. prévenir l'AE, mettre à jour la phase de l'opportunité, transmettre des données à un système aval), sans écrire une seule ligne de code.

Suivre l'activité Tomorro

Étape 1 : créer un flow : Setup > Flows > New Flow

Étape 2 : configurer le flow

Deux événements de plateforme Tomorro sont disponibles :

  • Tomorro ContractCreation : quand un nouveau contrat est créé dans Tomorro depuis votre instance Salesforce (automatiquement avec déclencheur, ou manuellement)

  • Tomorro ContractCreationError : quand la création d'un contrat a échoué

Étape 3 : ajouter d'autres actions

Vous pouvez ajouter des actions, par exemple envoyer un e-mail quand une création a échoué, ou mettre à jour d'autres données dans votre instance Salesforce quand le contrat a bien été créé.


​Étape 4 : enregistrer et activer le flow

N'oubliez pas d'enregistrer et d'activer votre flow. Vous pouvez le désactiver à tout moment.


Tous les utilisateurs

Connecter son compte

⚠️ Remarques :

  • Cette étape n'est nécessaire que si la génération manuelle est configurée

  • Cette étape doit être réalisée par chaque utilisateur (impossible au niveau administrateur)

1. Tomorro : récupérer sa clé API Tomorro

Pour connecter votre compte Tomorro à Salesforce, vous avez besoin de votre clé API. Allez dans Intégrations et, sur la carte « API » (zone « Intégrations API personnelles »), cliquez sur « Gérer l'intégration ».

Cliquez ensuite sur « Générer une clé d'API », si vous n'en avez pas encore généré, et copiez-la.

2. Salesforce : aller sur la page où le widget Tomorro est installé

Allez sur la page Opportunity (ou Case, Account, si l'application y est installée). Tous les utilisateurs doivent maintenant voir le composant Tomorro sur cette page.

Dans Salesforce, collez la clé API et cliquez sur « Use Tomorro » (libellé du widget : « Tomorro verwenden » en DE).


Articles à lire ensuite

Avez-vous trouvé la réponse à votre question ?