Email interactif alimenté par des données Salesforce en direct

Salesforce authentifie les intégrations serveur à serveur avec un JWT signé, pas un mot de passe — et la source de données API de MailInApp parle nativement ce flux. Connectez-vous une fois, et une carte de score KPI ou un bloc graphique peuvent se lier directement à des lignes Opportunity, Account ou Contact en direct, sans jeton de rafraîchissement à surveiller ni CSV à réexporter avant chaque envoi.

La plupart des emails de « pipeline hebdomadaire » sont une capture d'écran d'un rapport, obsolète dès qu'on la colle. Lier un bloc graphique directement à une source de données adossée à Salesforce fait que le propre chiffre du bloc vient d'une vraie requête SOQL — et un envoi récurrent réexécute cette requête à neuf à chaque envoi, si bien que la synthèse du lundi reflète réellement le pipeline du lundi.

Comment fonctionne la connexion

C'est le même flux JWT Bearer que Salesforce documente pour ses propres intégrations serveur à serveur, intégré aux modes d'authentification OAuth2 déjà existants de MailInApp pour les sources de données API, plutôt qu'une intégration sur mesure exclusivement pour Salesforce.

Configurez un Connected App une fois

Dans Salesforce Setup, créez un Connected App, activez les paramètres OAuth, et téléversez un certificat auto-signé sous Use digital signatures — le certificat va à Salesforce, la clé privée RSA associée va à MailInApp. Réglez Permitted Users sur Admin approved users are pre-authorized, ce qui rend l'échange non interactif : il n'y a aucun écran de consentement sur lequel un script devrait cliquer. Notez le Consumer Key du Connected App et l'URL My Domain de votre org — les deux entrent dans la connexion côté MailInApp.

Dirigez-la vers une requête SOQL

L'Endpoint de la source de données est une URL de requête REST, et la chaîne de requête est la vraie donnée que vous récupérez :

SELECT Name, Amount, StageName, CloseDate FROM Opportunity WHERE IsClosed = false

Réglez Data path sur records — Salesforce enveloppe ses résultats de requête dans un tableau records. Les champs de relation comme Owner.Email reviennent imbriqués et sont abandonnés par l'analyseur de lignes de MailInApp, donc gardez la requête plate ; sélectionnez plutôt OwnerId si vous avez besoin d'un identifiant de propriétaire à filtrer ou fusionner plus tard.

Liez les blocs directement à elle, pas des balises de fusion

Ajoutez la connexion à un projet depuis le panneau Données du studio avec un rôle collection — la même liaison qu'utilise un bloc de répétition. À partir de là, les blocs carte de score KPI, barres, lignes et camembert peuvent s'y lier directement depuis leur propre Inspecteur :

• Une carte de score KPI réglée sur Amount avec un agrégat Somme devient un chiffre « pipeline ouvert total » en direct.
• Un graphique à barres groupé par StageName, avec Amount comme série (agrégat Somme à nouveau), devient une répartition du pipeline par étape.

Aucun des deux blocs n'a besoin d'une seule balise de fusion tapée à la main — la liaison fait le travail, et les deux restent exacts à mesure que les affaires changent d'étape ou se closent.

Envoyez-le sur une programmation

Un envoi récurrent hebdomadaire réexécute la requête SOQL et re-rend les deux blocs par rapport aux lignes actuelles de Salesforce à chaque déclenchement — la même structure de synthèse, des chiffres frais chaque lundi, sans que personne ne la reconstruise à la main. Un bloc Bouton pointant vers l'URL Salesforce de chaque Opportunity donne à quiconque lit la synthèse un moyen en un clic d'ouvrir l'enregistrement derrière un chiffre qui attire son attention.

Pour commencer

Créez un Connected App Salesforce avec un certificat pour le flux JWT Bearer, connectez-le dans l'onglet Data Sources de MailInApp avec votre Consumer Key, le nom d'utilisateur d'intégration, et la clé privée, dirigez l'endpoint vers une requête SOQL avec records comme data path, puis liez une carte de score KPI et un graphique à barres à celle-ci depuis le panneau Données du studio. Voir le guide d'intégration Salesforce pour la configuration complète champ par champ.