Salesforce
MailInApp n'a pas d'application Salesforce à installer, et vous n'en avez pas besoin. L'API REST de Salesforce répond en JSON simple sur HTTPS. La source de données API de MailInApp, avec l'authentification OAuth2 JWT Bearer, parle directement le flux de connexion serveur à serveur de Salesforce : pas d'écran de consentement, pas de jeton d'actualisation à surveiller, et votre mot de passe Salesforce n'arrive jamais chez MailInApp.
Ce guide met en place une connexion en lecture seule. Elle amène des lignes Opportunity, Account, Contact ou produit dans les balises de fusion, les blocs de répétition et les graphiques liés, et elle peut importer vos contacts Salesforce comme audience. Elle n'écrit rien dans Salesforce.
Comment fonctionne la connexion
- MailInApp signe une assertion JWT de courte durée avec la clé privée de votre application.
- Il envoie cette assertion au point de jeton de Salesforce, qui vérifie la signature avec le certificat que vous avez téléversé et renvoie un jeton d'accès. Aucun identifiant ni mot de passe n'est envoyé.
- MailInApp met le jeton en cache et appelle l'API REST de Salesforce (une requête SOQL) avec lui. Il en génère un nouveau avant son expiration, ou si un appel revient non autorisé.
Tout se passe côté serveur, à chaque récupération. Une fois en place, il n'y a rien à maintenir ni à réautoriser.
Créer une paire de clés
Le flux JWT demande une paire de clés RSA : le certificat va à Salesforce, la clé privée va à MailInApp. Si vous n'en avez pas, générez une paire auto-signée avec OpenSSL :
openssl req -x509 -newkey rsa:2048 -nodes -keyout mailinapp.key -out mailinapp.crt -days 730 -subj "/CN=MailInApp"
Gardez mailinapp.key en lieu sûr. Vous la collez une fois dans MailInApp, puis elle est masquée.
Configurer le côté Salesforce
Salesforce crée désormais les nouvelles intégrations sous forme d'External Client Apps (la création de Connected Apps est désactivée par défaut dans les orgs récentes).
- Dans Setup, ouvrez External Client App Manager et cliquez sur New External Client App.
- Renseignez le nom (par exemple MailInApp JWT), un e-mail de contact, et laissez Distribution State sur Local.
- Ouvrez API (Enable OAuth Settings) et cochez Enable OAuth. Le flux JWT n'utilise jamais la Callback URL, mais elle est obligatoire :
https://login.salesforce.com/services/oauth2/successconvient. - Sous OAuth Scopes, ajoutez Manage user data via APIs (api) et Perform requests at any time (refresh_token, offline_access).
- Sous Flow Enablement, cochez Enable JWT Bearer Flow et téléversez le certificat (
mailinapp.crt). Cliquez sur Create. - Dans l'onglet Policies de l'application, cliquez sur Edit. Sous OAuth Policies, réglez Permitted Users sur Admin approved users are pre-authorized, puis sélectionnez le profil ou le permission set de l'utilisateur avec lequel MailInApp se connecte. C'est ce qui rend le flux non interactif : sans cela, Salesforce attend qu'une personne valide un écran de consentement. Enregistrez.
- Dans l'onglet Settings, ouvrez OAuth Settings et cliquez sur Consumer Key and Secret. Salesforce vous envoie un code par e-mail pour confirmer votre identité, puis affiche la Consumer Key : c'est l'émetteur dont MailInApp a besoin. Le secret n'est pas nécessaire.
L'utilisateur avec lequel MailInApp se connecte voit exactement ce que cet utilisateur voit dans Salesforce. Un utilisateur d'intégration dédié, avec un accès en lecture aux objets que vos e-mails utilisent, est le choix le plus propre. Un champ masqué pour cet utilisateur (par la sécurité au niveau des champs) n'apparaît pas dans les résultats.
La connecter dans MailInApp
Allez dans Sources de données → + Connexion API et renseignez :
- URL de l'endpoint : l'URL de requête de votre org avec une requête SOQL, par exemple
https://yourorg.my.salesforce.com/services/data/v62.0/query?q=SELECT Name, Amount, StageName, CloseDate, Account.Name FROM Opportunity WHERE IsClosed = false. Vous pouvez taper la requête avec de simples espaces : MailInApp l'encode. - Chemin des données :
records. Salesforce place les lignes dans un tableaurecords, à côté detotalSizeetdone. - Authentification : OAuth2 JWT Bearer, avec :
- URL du jeton :
https://login.salesforce.com/services/oauth2/token(ou celle de votre My Domain,https://yourorg.my.salesforce.com/services/oauth2/token) ;https://test.salesforce.com/services/oauth2/tokenpour un sandbox. - Émetteur : la Consumer Key de l'application.
- Sujet : le nom d'utilisateur Salesforce avec lequel MailInApp se connecte.
- Audience :
https://login.salesforce.com(https://test.salesforce.compour un sandbox). - Clé privée : le contenu de
mailinapp.key.
- URL du jeton :
Cliquez sur Tester ces réglages : MailInApp génère un vrai jeton, exécute la requête et affiche les premières lignes telles que vos balises de fusion les verront. Une fois la connexion enregistrée, Tester la connexion enregistrée la vérifie à tout moment sans recoller la clé.
Une connexion correspond à une requête. Créez-en une par usage : les opportunités ouvertes pour un e-mail de pipeline, le catalogue de prix pour un catalogue produits, les contacts pour une audience.
Interroger avec SOQL
La requête est exactement la donnée que vous recevez : sélectionnez seulement les colonnes dont votre e-mail a besoin.
- Les champs liés fonctionnent. Salesforce renvoie un champ de relation comme
Account.Namesous forme d'objet imbriqué ; MailInApp en fait un champ nomméAccount.Name. Écrivez-le{{alias.Account.Name}}dans une balise de fusion, ou{{Account.Name}}dans un bloc de répétition. Cela fonctionne jusqu'à trois niveaux (Account.Owner.Name), et les métadonnéesattributesque Salesforce ajoute à chaque enregistrement sont ignorées. - Triez et limitez dans la requête.
ORDER BY CloseDateetLIMIT 10décident de l'ordre et du nombre de lignes qu'affiche un bloc de répétition. - Jusqu'à 1 000 lignes par récupération, largement assez pour un résumé ou un catalogue.
- Récupéré à chaque rendu. Chaque envoi, y compris chaque exécution d'un envoi récurrent, relance la requête : l'e-mail montre toujours les données actuelles de Salesforce. Seul le jeton OAuth est mis en cache.
Quelques requêtes utiles :
SELECT Name, StageName, Amount, CloseDate, NextStep, Account.Name FROM Opportunity WHERE IsClosed = false ORDER BY CloseDate
SELECT Name, ProductCode, UnitPrice, Product2.Description, Product2.DisplayUrl FROM PricebookEntry WHERE Pricebook2.IsStandard = true AND IsActive = true
SELECT Id, FirstName, LastName, Title, Email, HasOptedOutOfEmail, Account.Name, Account.Industry FROM Contact WHERE AccountId != null
Utiliser les données
Ajoutez la connexion à un e-mail depuis le panneau Données du studio, avec un alias (par exemple pipeline) et un rôle :
- Champs de fusion :
{{pipeline.champ}}se résout à partir de la première ligne. Idéal pour un chiffre clé. - Lignes à répéter : elles alimentent un bloc de répétition, qui reproduit son contenu pour chaque ligne, par exemple une carte par produit.
- Les mêmes lignes alimentent les graphiques KPI, barres, courbes et secteurs : un KPI qui additionne
Amountdonne un chiffre de pipeline ouvert en direct, un graphique en barres groupé parStageNamedonne le pipeline par étape.
Une vue différente pour chaque destinataire
Le Filtrer les lignes d'un bloc de répétition et le filtre d'un graphique peuvent comparer un champ Salesforce aux données du destinataire. Avec une liste d'audience qui a une colonne company, la règle Account.Name égal à {{company}} montre à chaque revendeur uniquement ses propres opportunités, à partir d'une seule requête partagée. La copie de chaque destinataire est rendue à partir de sa propre ligne au moment de l'envoi.
Importer vos contacts Salesforce
Votre audience est une liste de contacts MailInApp. Pour la remplir depuis Salesforce, créez une connexion API avec une requête sur Contact (la troisième ci-dessus), puis allez dans Contacts → Importer des contacts et choisissez Connexion API.
MailInApp lit les lignes avec les identifiants enregistrés, reconnaît les champs Salesforce et propose Utiliser l’association Salesforce : FirstName → first_name, Account.Name → company, Id → salesforce_id, etc. Un contact dont Email Opt Out (HasOptedOutOfEmail) est coché dans Salesforce est signalé à l'étape de vérification, qui propose de l'écarter. Un rapport Salesforce exporté en CSV est reconnu de la même façon. Voir Importer des leads.
L'import est une copie : relancez-le pour ajouter les nouveaux contacts.
Voir E-mail interactif alimenté par des données Salesforce en direct pour un exemple complet : un résumé hebdomadaire du pipeline construit à partir de cette connexion.
