On this page

Envoyer un email transactionnel

Envoyez des emails transactionnels personnalisés à vos clients pour les mises à jour du programme de fidélité, les confirmations de commande, les notifications de récompenses et les campagnes d’engagement.

Démarrage rapide

Requête d’email de base

POST https://api.brevo.com/v3/smtp/email
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "sender": {
    "name": "Tajo Loyalty",
    "email": "[email protected]"
  },
  "to": [
    {
      "email": "[email protected]",
      "name": "Customer Name"
    }
  ],
  "subject": "Your loyalty points have been updated!",
  "htmlContent": "<h1>Loyalty Update</h1><p>You earned 100 points from your recent purchase!</p>",
  "textContent": "Loyalty Update: You earned 100 points from your recent purchase!"
}

Réponse

{
  "messageId": "<[email protected]>"
}

Cas d’usage du programme de fidélité

Email de bienvenue pour les nouveaux clients

{
  "sender": {
    "name": "Tajo Loyalty Program",
    "email": "[email protected]"
  },
  "to": [
    {
      "email": "{{params.email}}",
      "name": "{{params.name}}"
    }
  ],
  "templateId": 1,
  "params": {
    "name": "John Doe",
    "email": "[email protected]",
    "welcomeBonus": "500",
    "loyaltyTier": "Bronze"
  }
}

Mise à jour du solde de points

{
  "subject": "Points Balance Update - {{params.pointsEarned}} Points Added",
  "params": {
    "customerName": "John Doe",
    "pointsEarned": "150",
    "totalPoints": "1,250",
    "transactionType": "Purchase",
    "orderNumber": "ORD-2024-001"
  }
}

Confirmation d’échange de récompenses

{
  "subject": "Reward Redeemed Successfully",
  "params": {
    "rewardName": "10% Off Next Purchase",
    "pointsUsed": "1000",
    "remainingPoints": "250",
    "couponCode": "SAVE10NOW",
    "expiryDate": "2024-03-15"
  }
}

Paramètres

Paramètre	Type	Requis	Description
`sender`	Object	Oui	Informations sur l’expéditeur
`to`	Array	Oui	Liste des destinataires (max 50)
`subject`	String	Oui	Objet de l’email
`htmlContent`	String	Non	Contenu HTML de l’email
`textContent`	String	Non	Contenu texte de l’email
`templateId`	Integer	Non	ID du modèle (alternative au contenu)
`params`	Object	Non	Paramètres du modèle
`headers`	Object	Non	En-têtes personnalisés
`attachment`	Array	Non	Pièces jointes

Fonctionnalités avancées pour Tajo

Segmentation client

{
  "to": [
    {
      "email": "[email protected]",
      "name": "Premium Customer"
    }
  ],
  "params": {
    "loyaltyTier": "Premium",
    "personalizedOffers": [
      "Exclusive 20% off luxury items",
      "Free premium shipping"
    ]
  }
}

Configuration des tests A/B

{
  "subject": "{{params.subjectVariant}}",
  "params": {
    "subjectVariant": "Limited Time: Double Points Weekend!",
    "contentVariant": "premium",
    "testGroup": "A"
  }
}

Gestion des erreurs

{
  "code": "invalid_parameter",
  "message": "Email address is invalid",
  "details": {
    "field": "to[0].email",
    "value": "invalid-email"
  }
}