Intégration des e-mails Reconnect

Intégrez votre fournisseur de services de messagerie (ESP) pour envoyer des e-mails à vos utilisateurs. 

Conditions préalables

Pour être intégré à Dynamic Yield, votre fournisseur de services de messagerie doit : 

• Proposer une API RESTful pour l’envoi de messages, soit en utilisant un point de terminaison « Send email », soit en utilisant un service d’événements basé sur l’API.
• Prendre en charge l’une des méthodes d’authentification suivantes : 
  • No Auth (aucune authentification)
  • Basic Auth (authentification basique)
  • OAuth2 (authentification à deux facteurs)
• Prendre en charge le format JSON comme charge utile.

Implémentation de l’intégration

Pour configurer une intégration avec votre ESP :

1. Dans Reconnect, rendez-vous sur l’onglet Intégrations, puis cliquez sur Create Channel Integration (créer une intégration de canal.).
2. Sélectionnez le canal Email, puis complétez les informations suivantes dans l’assistant d’intégration.

Étape 1 : configuration 

• Name : le nom de l’intégration est inclus dans vos campagnes et leurs rapports.  
• HTTP Post URL : le point de terminaison de messagerie de votre ESP.
• HTTP Header Parameters (facultatif, paramètres d’en-tête HTTP) : vous pouvez insérer des paramètres d’en-tête dans un format clé:valeur. Cliquez sur l’icône de verrouillage à côté du champ pour crypter la valeur. La valeur s’affiche comme masquée et est cryptée avant d’être enregistrée dans notre base de données.
• Identifier Type (type d’identifiant) : sélectionnez la méthode d’identification de l’utilisateur requise par votre ESP. La valeur correspondante est incluse dans le JSON du message lorsque vous utilisez la variable User Identifier.
  Par exemple, si vous sélectionnez « Plain Text Email » et que vous insérez la variable « User Identifier » dans la charge utile JSON d’une campagne, elle est remplacée par l’adresse e-mail de l’utilisateur que vous avez fournie dans le cadre du processus d’identification.

Cliquez sur Next.

Étape 2 : authentification

Sélectionnez la méthode d’authentification requise par votre ESP :

• No Auth : aucune autorisation n’est requise, il n’y a donc aucun paramètre supplémentaire à configurer.
• Basic Auth : saisissez un identifiant et un mot de passe valides tels que fournis par votre ESP.
• OAuth2 : saisissez une URL de jeton, un ID client et un secret client, tels que fournis par votre ESP.
  • • Vous pouvez modifier les noms des clés de l’ID client et du secret dans la section des paramètres d’en-tête des informations sur le jeton.
    • Par défaut, la valeur du secret client est cryptée à des fins de sécurité.

Lorsque vous cliquez sur Next, le système valide les informations d’identification que vous avez fournies par rapport à l’URL du jeton. Si elles ne sont pas valides, un message d’erreur apparaît.

Étape 3 : test

Pour tester votre intégration, envoyez un appel API de test à votre ESP :

• Request Headers (en-têtes de la requête) : affiche les paramètres que vous avez saisis dans les étapes précédentes.
• JSON Payload :
  1. Saisissez le corps du message, au format JSON, tel que votre ESP s’attend à le recevoir.
  2. Cliquez sur Test. Un appel API est envoyé au point de terminaison de messagerie ESP que vous avez défini précédemment.
• Request Response (réponse à la demande) : il s’agit de la réponse de votre serveur ESP.

Si tout fonctionne comme prévu, cliquez sur Save. L’intégration apparaît sur l’onglet Integrations.