Importer vos emails dans Pardot

Emailify intègre Pardot : importez vos emails HTML directement depuis le plugin Figma dans vos modèles Pardot.

Pardot s’appelle désormais Account Engagement dans Salesforce Marketing Cloud.

Tutoriel vidéo : importer vos emails dans Pardot

Cette vidéo explique comment importer des emails HTML dans Pardot depuis le plugin Figma Emailify.

Si vous avez besoin de liens AMPscript (par exemple %%=v(@url)=%%) dans vos paragraphes de texte, le champ de lien natif de Figma les bloque comme URL non valides. Pour contourner ce problème, utilisez plutôt le format de lien AMPscript spécial d’Emailify, https://ampscript.invalid/?%%=v(@url)=%% : Emailify écrira la balise AMPscript brute dans le HTML exporté.

1. Créer une Connected App dans Pardot ​

Si vous n’en avez pas encore, vous devez créer une Connected App dans Pardot. Elle vous fournira la Consumer Key et le Consumer Secret à coller dans le plugin à l’étape 3 (S’authentifier auprès de Pardot).

  1. En haut à droite de l’administration Pardot, cliquez sur l’icône des réglages (Settings), puis sur Setup.
  2. Dans la barre de recherche des réglages, recherchez « App Manager » et cliquez sur le résultat App Manager.
  3. Cliquez sur le bouton New Connected App.
  4. Donnez un nom à votre Connected App (par exemple, Emailify Integration).
  5. Ajoutez les coordonnées du propriétaire de la Connected App.
  6. Cochez la case Enable OAuth Flows.
  7. Saisissez https://figma.com/ comme Callback URL.
  8. Sous Selected OAuth Scopes, ajoutez les scopes ci-dessous, qui permettent à l’application d’accéder à Pardot et de s’y authentifier :
  • Access content resources (content)
  • Access the identity URL service (id, profile, email, address, phone)
  • Manage Pardot services (pardot_api)
  • Perform requests at any time (refresh _token, offline_access)
  1. Cochez la case Require Secret for Web Server Flow.
  2. Si elle s’affiche, vérifiez que la case Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows n’est pas cochée.
  3. Cliquez sur Save.

2. Trouver votre Business Unit ID Pardot ​

Votre Business Unit ID est un identifiant de 18 caractères qui commence par « 0Uv ». Pour trouver votre Business Unit ID Pardot, suivez les étapes ci-dessous :

  1. Connectez-vous à Salesforce avec le compte que vous utilisez pour vous connecter à Pardot.
  2. Cliquez sur l’onglet Setup.
  3. Trouvez la liste déroulante Pardot et cliquez sur Pardot Account Setup.
  4. Vous avez peut-être plusieurs business units Pardot : choisissez le Business Unit ID de celle que vous voulez utiliser avec Emailify.

3. S’authentifier auprès de Pardot ​

Dans le panneau d’export d’Emailify, sélectionnez l’option Pardot (API), ou une option de compte de test Pardot, dans la liste déroulante, puis copiez-collez les identifiants et informations Pardot suivants dans les champs des réglages d’export d’Emailify :

  • Pardot Business Unit ID (par exemple, 0UvXXXXXXXXXXXXXXX)
  • Pardot Username, l’identifiant que vous utilisez pour vous connecter (par exemple, [email protected])
  • Pardot Password, le mot de passe que vous utilisez pour vous connecter (par exemple, *********)
  • Consumer Key de votre Connected App (par exemple, y0Zd2jVHJ5Cc1wQg0l5yMJsXpPs...)
  • Consumer Secret de votre Connected App (par exemple, 8C8F8D11A3B7B026A90C5C3...)

Une fois toutes ces informations collées, Emailify s’authentifie auprès de votre instance Pardot.

Les différentes options d’endpoint de l’API Pardot dans Emailify ​

Si vous utilisez une instance de test ou une sandbox, vous pouvez sélectionner d’autres options d’export API Pardot dans les options d’export d’Emailify. Voici les endpoints appelés par chacune :

Option EmailifyDomaine d’autorisationDomaine de contenu
Pardot APIlogin.salesforce.com/services/oauth2/token?grant_type=passwordpi.pardot.com
Pardot Test APItest.salesforce.com/services/oauth2/token?grant_type=passwordpi.demo.pardot.com
Pardot Dev APIlogin.salesforce.com/services/oauth2/token?grant_type=passwordpi.demo.pardot.com

Résoudre les problèmes d’authentification Pardot ​

Si vous n’arrivez pas à vous authentifier avec votre nom d’utilisateur et votre mot de passe Pardot, le problème le plus fréquent est que l’authentification multifacteur (MFA) de Salesforce a été activée pour l’utilisateur Salesforce dont dépend votre intégration.

Les échecs d’authentification auprès de Pardot sont le plus souvent liés à l’authentification à deux facteurs (2FA), mais vous pouvez souvent les résoudre dans Pardot en :

  • passant le réglage IP Relaxation sur Relax IP Restrictions ;
  • passant le réglage Permitted Users sur All users may self-authorize ;
  • activant l’option Allow OAuth Username-Password Flows dans OAuth and OpenID Connect Settings ;
  • utilisant un mot de passe sans caractères spéciaux (par exemple # % &, etc.), composé uniquement de lettres et de chiffres (par exemple mypa55word1234).

Faire fonctionner les utilisateurs d’intégration API avec la MFA de Salesforce ​

La MFA de Salesforce s’applique principalement aux connexions interactives à l’interface utilisateur. Les intégrations basées sur l’API peuvent généralement continuer à fonctionner sans demande de MFA interactive, mais votre administrateur Salesforce doit configurer correctement l’utilisateur d’intégration.

Pour le workflow d’import via l’API Pardot d’Emailify, la bonne pratique consiste à utiliser un compte utilisateur d’intégration Salesforce dédié plutôt qu’un identifiant personnel partagé.

Si votre édition de Salesforce inclut des licences utilisateur Salesforce Integration, attribuez l’une de ces licences à l’utilisateur d’intégration dédié qu’utilise Emailify.

Avantages :

  • Ces utilisateurs sont conçus pour un accès uniquement via l’API.
  • Ils ne peuvent pas se connecter à l’interface de Salesforce et échappent donc par nature aux demandes de MFA de l’interface.
  • Ils permettent de séparer votre intégration des comptes utilisateur classiques.
  • Leur profil réservé à l’API a généralement API Enabled activé par défaut.

Pour vérifier si ces licences sont disponibles :

  1. Dans Salesforce, accédez à Setup.
  2. Recherchez Company Information.
  3. Ouvrez Company Information.
  4. Cherchez Salesforce Integration dans la liste User Licenses.
Autre solution : exempter un utilisateur Salesforce standard de la MFA de l’interface ​

Si vous ne pouvez pas utiliser de licence utilisateur Salesforce Integration et que votre intégration utilise un utilisateur Salesforce standard, votre administrateur Salesforce peut exempter cet utilisateur d’intégration dédié de la MFA de l’interface en lui attribuant un Permission Set doté de l’autorisation système Waive Multi-Factor Authentication for Exempt Users.

Pour le configurer :

  1. Dans Salesforce, accédez à Setup.
  2. Recherchez Permission Sets.
  3. Créez un Permission Set pour votre utilisateur d’intégration.
  4. Ouvrez System Permissions et cliquez sur Edit.
  5. Activez Waive Multi-Factor Authentication for Exempt Users.
  6. Enregistrez le Permission Set.
  7. Attribuez ce Permission Set à l’utilisateur d’intégration dédié.

Si l’intégration utilise une licence utilisateur Salesforce standard, vérifiez aussi que API Enabled est toujours activé dans les System Permissions du profil de l’utilisateur.

Recommandations supplémentaires ​
  • Préférez un utilisateur d’intégration dédié à un compte utilisateur personnel.
  • Si vous utilisez l’authentification par nom d’utilisateur et mot de passe, conservez ces identifiants et tout jeton de sécurité en lieu sûr.
  • Testez votre connexion Pardot dans une sandbox avant d’activer des changements liés à la MFA en production.
  • Si l’authentification se met à échouer après un déploiement de la MFA, consultez l’historique de connexion (Login History) de l’utilisateur Salesforce pour connaître la raison exacte de l’échec.
Références Salesforce ​

4. Importer des modèles d’email dans Pardot ​

Une fois votre connexion à l’API Pardot authentifiée, vous pouvez renseigner les champs obligatoires suivants à l’aide des champs et listes déroulantes qui s’affichent :

  • Sender Name

  • Sender Address

  • Campaign Name

  • Folder Name

  • Domain Tracking Name

Vous pouvez aussi ajouter des tags de régions de contenu Pardot au modèle exporté :

  • Editable Regions permet aux utilisateurs de modifier les textes, les images et les boutons.
  • Repeatable Regions permet aux utilisateurs de copier ou de déplacer les blocs de contenu de premier niveau non verrouillés. Ces blocs partagent un même nom de région répétable (body_content), si bien que des blocs différents peuvent passer les uns devant les autres.
  • Removable Regions permet aux utilisateurs de supprimer les blocs de contenu de premier niveau non verrouillés.

Activez la combinaison d’options de votre choix avant d’importer ou d’exporter le modèle. Lorsque Repeatable Regions et Removable Regions sont toutes deux activées, Emailify place les deux attributs sur le même conteneur pour chaque bloc non verrouillé. Les conteneurs répétables partagent le nom body_content et se suivent, ce qui permet de déplacer différents blocs au sein du groupe. Il n’y a pas de conteneur supprimable distinct autour de chaque bloc répétable.

Garder l’en-tête et le pied de page fixes ​

Dans Figma, avant l’export, verrouillez l’en-tête, le pied de page ou tout autre calque parent placé directement dans le frame de votre email Emailify. Emailify exporte les calques de premier niveau verrouillés sans tags de régions répétables ou supprimables, y compris tous les blocs générés à partir d’un groupe parent verrouillé. Laissez les calques du corps de l’email déverrouillés pour que les utilisateurs puissent les réorganiser lorsque Repeatable Regions est activée.

Verrouillez le calque de premier niveau lui-même : verrouiller seulement un calque de texte ou d’image imbriqué ne verrouille pas son bloc parent. Ce verrouillage contrôle la copie, le déplacement et la suppression de blocs entiers. Editable Regions contrôle toujours la modification des textes, images et boutons qu’ils contiennent. Pour rendre le bloc de nouveau répétable ou supprimable, déverrouillez le calque parent et exportez à nouveau.

Une fois les options souhaitées sélectionnées, et lorsque tout est prêt, cliquez sur le bouton Upload To Pardot pour lancer l’export en HTML des emails sélectionnés dans Figma : ils sont automatiquement importés dans vos modèles d’email dans Pardot.