Destinataires, CC et BCC

Plusieurs adresses par champ, noms affichés, copies visibles et invisibles.

Les quatre champs d'adresses

Paramètre	Obligatoire	Visible par les destinataires	Rôle
`to`	oui	oui	Destinataires principaux.
`cc`	non	oui	Copie « pour information ». Tout le monde voit ces adresses.
`bcc`	non	non	Copie cachée. Ces adresses n'apparaissent dans aucun en-tête du message reçu.
`reply_to`	non	oui	Adresse vers laquelle pointe le bouton « Répondre », si elle diffère de `from`.

Plusieurs adresses dans un même champ

Séparez les adresses par une virgule :

bash

curl -X POST "https://mailer.echange.online/api/send.php" \
  -H "X-API-Key: VOTRE_CLE_API" \
  -d "from=facturation@mondomaine.com" \
  -d "to=alice@example.com, bob@example.com" \
  -d "cc=comptabilite@mondomaine.com" \
  -d "bcc=archives@mondomaine.com" \
  -d "reply_to=support@mondomaine.com" \
  -d "subject=Facture de janvier" \
  -d "body=Bonjour, veuillez trouver le récapitulatif ci-joint."

En JSON, un tableau de chaînes est également accepté — souvent plus pratique à générer :

json

{
  "from": "facturation@mondomaine.com",
  "to": ["alice@example.com", "bob@example.com"],
  "cc": ["comptabilite@mondomaine.com"],
  "bcc": ["archives@mondomaine.com"],
  "reply_to": "support@mondomaine.com",
  "subject": "Facture de janvier",
  "body": "Bonjour, veuillez trouver le récapitulatif ci-joint."
}

Nom affiché

Pour qu'un client mail affiche « Alice Martin » plutôt que l'adresse brute, utilisez la forme Nom <adresse> :

bash

-d "to=Alice Martin <alice@example.com>, Bob <bob@example.com>" \
-d "from=Service client <contact@mondomaine.com>"

Les accents dans le nom sont encodés automatiquement : Frédéric Noël <fred@example.com> fonctionne tel quel.

Attention

Un nom contenant une virgule doit être entre guillemets — "Martin, Alice" <alice@example.com> — faute de quoi la virgule serait comprise comme un séparateur d'adresses.

CC ou BCC : lequel choisir ?

CC quand la transparence est voulue : le client voit que son conseiller est en copie et peut répondre à tous.
BCC pour archiver une copie, ou pour écrire à plusieurs personnes qui ne doivent pas voir les adresses des autres.

Attention

N'utilisez pas BCC pour envoyer un message « personnalisé » à une liste : chaque destinataire reçoit un message identique, non personnalisable, et un BCC massif est un signal fort pour les filtres anti-spam. Faites plutôt un appel API par destinataire, avec un template et des variables.

Limite du nombre de destinataires

Le total to + cc + bcc d'un même envoi est plafonné par votre forfait (5 pour le forfait gratuit, jusqu'à 500 pour Enterprise — voir Quotas et limites). Au-delà, l'API répond :

json · HTTP 422

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "Nombre de destinataires (12) supérieur à la limite de votre abonnement (5)."
  }
}

Attention : un envoi à 10 destinataires compte pour 1 email dans votre quota mensuel, pas pour 10. C'est le nombre d'appels à l'API qui est décompté.

Adresses invalides

Chaque adresse est validée avant tout envoi. Si l'une d'elles est mal formée, aucun email n'est envoyé et rien n'est décompté de votre quota :

json · HTTP 422

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "Adresse email invalide : \"alice@@example.com\""
  }
}

En revanche, une adresse syntaxiquement correcte mais inexistante ne peut pas être détectée à l'envoi : le rejet arrivera plus tard, sous forme de non-remise (bounce) dans la boîte du compte SMTP utilisé.