Configurer votre clé API Emarsys

Pour importer vos campagnes d’emailing à partir de designs Figma Emailify, vous devez créer une clé WSSE dans Emarsys, définir ses autorisations, puis utiliser les identifiants d’API générés pour connecter Emailify à votre compte Emarsys.

Créer votre clé WSSE Emarsys

La première étape consiste à créer votre clé WSSE dans Emarsys (vous devez être propriétaire du compte pour disposer de cette autorisation) : rendez-vous dans Management -> Security Settings -> API Credentials pour créer votre clé WSSE.

Définir les autorisations de votre clé API

Après avoir créé votre clé et conservé en lieu sûr votre nom d’utilisateur et votre clé (à coller dans le plugin Figma Emailify à l’étape suivante), vous devez également activer les autorisations de points de terminaison d’API ci-dessous pour que l’intégration d’API fonctionne comme prévu :

• campaign.create
• campaign.update
• contactlist.list

Importer votre HTML depuis Emailify

Dans le panneau d’export d’Emailify, sélectionnez l’option Emarsys dans la liste déroulante, puis collez des identifiants d’API Emarsys valides (obtenus à l’étape précédente). Une fois Emarsys authentifié dans le plugin, sélectionnez la Contact List à laquelle la campagne sera envoyée plus tard, ainsi que le From Name et l’adresse From Email depuis lesquels elle sera envoyée.

Quand vous êtes prêt, cliquez sur le bouton Upload To Emarsys pour exporter en HTML les emails sélectionnés dans Figma et les importer automatiquement dans vos campagnes Emarsys.

Mettre à jour les modèles Emarsys importés depuis Emailify

Si vous souhaitez que vos modèles Emarsys soient automatiquement mis à jour au lieu d’être recréés à chaque fois, vous pouvez activer l’option Enable Updatable Templates dans les réglages d’export du plugin (lorsque l’option Emarsys est sélectionnée).

Une valeur emarsysTemplateId est alors automatiquement ajoutée au nom du calque du frame Figma importé, puis réutilisée lorsque ce même frame est de nouveau importé dans Emarsys via l’API lors du prochain export depuis le plugin.

Remarque : pour que cela fonctionne, vous devez activer l’autorisation campaign.update sur votre clé WSSE Emarsys.

Remarque : vous devez vérifier que l’option Enable Updatable Templates est activée avant d’importer votre modèle initial, car c’est ainsi que l’ID du modèle Emarsys (Emarsys Template ID) d’origine est ajouté au nom de votre frame Figma. Cet ID servira ensuite à chaque nouvel import pour mettre à jour ce même modèle dans votre compte Emarsys (au lieu d’en créer un nouveau à chaque fois), à condition que l’option Enable Updatable Templates reste elle aussi activée.