❗️ Important
L'API v2 et l'ancien langage de template mentionnés dans cet article sont des fonctionnalités obsolètes. Vous pouvez vous en servir pour modifier des templates et des intégrations API existants, mais vous ne devez pas les utiliser pour créer de nouveaux templates ou intégrations.
Consultez cet article pour apprendre à créer et personnaliser vos templates et les envoyer via notre module SMTP API (v3).
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.
| 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 :
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.”