Personnaliser vos templates d'emails transactionnels

L'API SendinBlue vous offre la possibilité d'envoyer des templates d'emails créés sur SendinBlue, en passant par SendinBlue SMTP (emails transactionnels). Cette API supporte uniquement la méthode POST. Le tableau suivant récapitule les différents champs à ajouter dans vos requêtes API.

This API provides functionality to send templates created in SendinBlue through SendinBlue SMTP (as transactional emails). This API supports only the POST method. The following fields may be sent while making API calls.

Parameter Required Requirement

 Description 

User Yes Username

Your SendinBlue username can be found in your SendinBlue account on the My Account "SMTP & API" page on the SMTP tab.

Key Yes API key

Your API key(s) can be found in your SendinBlue account on the My Account "SMTP & API" page

Templateid Yes Please provide a valid campaign ID whose type is template

Should be the ID of the campaign whose type is ‘template’

To Yes At least one recipient

Should contain one or more than one (‘|’ separated) recipients. Must be a valid email address

Cc No Recipient to receive copy

If provided then must be a valid email address

Bcc No Recipient to receive copy

If provided then must be valid email address

Attr_1….n No Attributes should be provided in JSON format.  For example: {"attr1":"value","attr2":"value"}

In the template, this attribute must be provided inside ‘%%’ in capital letters without spaces (non-accented characters are recommended). If the value of this attribute is provided in the request then in the email it will be replaced with the value in the result. If no such attribute is found then no replacement will be done. Additionally, if in the template, for ex: %PASS% is found and the value of PASS is not provided in the request, then no replacement will be done. You can also have attribute variables in the subject - they will also be replaced while sending the email.

Exemple:

Il existe 2 cas distincts pour gérer les attributs de contact :

  • Cas n°1 : par le biais d'une valeur fixe comme par exemple le nom et le prénom, qui est sauvegardée dans la base de données SendinBlue
  • Cas n°2 : par une variable dynamique comme par exemple le montant d'une commande ou un numéro de facture, qui sera alors générée lors d'une transaction et transmise par l'API.

Si l'attribut est fixe et existe dans la base de donnée SendinBlue et que vous souhaitez personnaliser vos templates avec cette typologie d'attribut de contact, le nom de l'attribut devra être mis entre {} .

Ex : Bonjour {FIRSTNAME}

Vous trouverez plus d'informations sur le tutoriel suivant .

Vous pouvez même aller plus loin en utilisant des conditions.

Si au contraire, l'attribut est une valeur dynamique et que celle-ci est passée par l'API, le nom de l'attribut devra être mis entre %%.

Ex : Montant de la commande : %ORDER_AMOUNT%

Dans un même template, vous pouvez utiliser les 2 types d'attributs indifféremment, pour obtenir par exemple une personnalisation de la sorte :  

ATTRIBUTES_FR_1    

Si le template est “Hello %LNAME% %FNAME%, This is the mail sent through SendinBlue smtp to test the template created by you. Regards. ”.   

Le mail envoyé dans la messagerie mail de votre contact apparaîtra comme : “Hello Smith John, This is the mail sent through SendinBlue smtp to test the template created by you. Regards.