CC & BCC
Envoyez un e-mail à des destinataires To, Cc et Bcc, via l'API ou en SMTP. Chacun reçoit sa propre copie, et les destinataires Bcc restent masqués.
https://mail.sendcorex.com/v3.0/send Même endpoint et mêmes champs que Envoyer un e-mail, plus cc et bcc. Vous envoyez le même e-mail à de nombreuses personnes qui ne doivent pas se voir ? Utilisez Envoyer des e-mails en lot.
Fonctionnement
Chaque adresse reçoit sa propre copie de l'e-mail. Les headers To et Cc sont identiques dans chaque copie, la conversation apparaît donc de la même façon pour tout le monde.
toDestinataires principaux
Affichés dans le header To de chaque copie.
ccCopies visibles
Affichés dans le header Cc de chaque copie : tout le monde voit qui d'autre l'a reçu.
bccCopies cachées
Reçoivent le même e-mail mais n'apparaissent dans aucun header, pas même dans leur propre copie.
Ce que voit chaque destinataire
Pour l'exemple de cette page : un to, deux cc et un bcc.
| Copie envoyée à | Champ | Header To | Header Cc |
|---|---|---|---|
| ana@example.com | to | ana@example.com | bob@example.com, carol@example.com |
| bob@example.com | cc | ana@example.com | bob@example.com, carol@example.com |
| carol@example.com | cc | ana@example.com | bob@example.com, carol@example.com |
| dan@example.com | bcc | ana@example.com | bob@example.com, carol@example.com |
dan@example.com n'apparaît dans aucun header. Il reçoit l'e-mail, mais personne ne peut savoir qu'il l'a reçu, et sa propre copie n'affiche pas non plus son adresse.
Paramètres du body
Tous les autres champs fonctionnent comme dans Envoyer un e-mail.
tostring | string[]obligatoireDestinataires principaux. Affichés dans le header To de chaque copie.
ex.
"ana@example.com"ccstring | string[]facultatifCopies visibles. Affichées dans le header Cc de chaque copie.
ex.
["bob@example.com", "carol@example.com"]bccstring | string[]facultatifCopies cachées. Chacun reçoit l'e-mail, mais aucun header ne les affiche.
ex.
"dan@example.com"
Chaque champ accepte une adresse sous forme de string ou plusieurs sous forme de tableau. Les noms de champs ne sont pas sensibles à la casse : cc, Cc et CC fonctionnent tous.
Avec l'API
import axios from 'axios';
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'ana@example.com',
cc: ['bob@example.com', 'carol@example.com'],
bcc: 'dan@example.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Project kickoff',
body: '<p>Hi all, see you on Monday.</p>',
},
{
headers: { Authorization: process.env.SENDCOREX_API_KEY },
}
);
// one id per recipient: ana, bob, carol and dan
const { ids, recipients } = response.data;Réponse
ids contient un id par destinataire, cc et bcc compris. Utilisez-le pour associer les logs et les webhooks à chaque copie.
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"ids": [
{ "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "ana@example.com" },
{ "id": "8b1d4e2a-6c3f-4a9b-9e1d-2f3a4b5c6d7e", "recipient": "bob@example.com" },
{ "id": "c4e7a1b9-2d5f-4c8e-a3b6-7d8e9f0a1b2c", "recipient": "carol@example.com" },
{ "id": "e9f2c5d8-1a4b-4e7c-b0d3-6a7b8c9d0e1f", "recipient": "dan@example.com" }
],
"recipients": 4,
"scheduledAt": null
}Avec SMTP
Utilisez les options cc et bcc de votre bibliothèque. Chaque adresse est placée dans l'enveloppe (RCPT TO) et reçoit sa propre copie. Le header Cc est conservé tel que vous l'avez envoyé. Un destinataire de l'enveloppe qui n'est ni dans To ni dans Cc est un destinataire Bcc. Les paramètres de connexion se trouvent sur Intégration SMTP.
const nodemailer = require('nodemailer');
const transporter = nodemailer.createTransport({
host: 'smtp.emailsbit.com',
port: 588,
secure: false, // STARTTLS: starts as plain text, upgrades to TLS
requireTLS: true,
auth: {
user: process.env.SMTP_USER,
pass: process.env.SMTP_PASS,
},
});
async function main() {
await transporter.sendMail({
from: '"Support" <support@yourdomain.com>',
to: 'ana@example.com',
cc: ['bob@example.com', 'carol@example.com'],
bcc: 'dan@example.com', // sent in the envelope only, never as a header
subject: 'Project kickoff',
html: '<p>Hi all, see you on Monday.</p>',
});
}
main().catch(console.error);Vous construisez le message à la main ?N'écrivez pas de header Bcc:. Placez les adresses Bcc uniquement dans l'enveloppe, comme dans l'exemple Go. Les bibliothèques ci-dessus le font déjà pour vous.
Limites et crédits
Jusqu'à 50 destinataires
to, cc et bcc réunis peuvent contenir jusqu'à 50 adresses uniques. Au-delà, la requête échoue avec RECIPIENT_LIMIT_EXCEEDED et rien n'est envoyé.
Les doublons reçoivent une seule copie
Une adresse présente dans plusieurs champs, quelle que soit la casse, reçoit une seule copie. Elle compte dans le premier champ où elle apparaît : to, puis cc, puis bcc.
1 crédit par copie
Chaque destinataire est un e-mail : 1 to, 2 cc et 1 bcc utilisent 4 crédits. Si vous avez moins de crédits que de destinataires, la requête échoue avec NO_CREDITS_LEFT et rien n'est envoyé.
Un e-mail par destinataire
Chaque copie a son propre id, log, webhooks, suivi des ouvertures et des clics, et lien de désinscription. Un bounce sur une copie n'affecte pas les autres.
Les hard bounces sont vérifiés pour chaque adresse
Une adresse cc ou bcc qui a fait un hard bounce au cours des 90 derniers jours n'est pas contactée, comme une adresse to. Vous recevez un événement bounced pour cette copie.
Sans cc ni bcc, rien ne change
Si vous envoyez to sous forme de tableau sans cc ni bcc, chaque destinataire reçoit toujours un e-mail distinct qui n'affiche que sa propre adresse.
Les copies bloquées par un hard bounce connu reviennent sous la forme d'un événement bounced pour ce destinataire uniquement.
Erreurs
Tous les codes d'erreur →Les erreurs propres aux destinataires. Chacune d'elles rejette toute la requête, aucune copie n'est donc envoyée.
- 401
NO_CREDITS_LEFTCrédits e-mail insuffisants pour tous les destinataires. Chaque adresse dans to, cc et bcc utilise 1 crédit.
- 400
INVALID_TOADDRESSUne ou plusieurs adresses de destinataire sont mal formées.
- 400
TOADDRESS_LIMIT_EXCEEDEDPlus de 50 destinataires dans le tableau to.
- 400
INVALID_CCADDRESSUne ou plusieurs adresses cc sont mal formées.
- 400
INVALID_BCCADDRESSUne ou plusieurs adresses bcc sont mal formées.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc et bcc réunis comptent plus de 50 destinataires uniques.