E-mail

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.

POSThttps://mail.sendcorex.com/v3.0/send
i

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.

to

Destinataires principaux

Affichés dans le header To de chaque copie.

cc

Copies visibles

Affichés dans le header Cc de chaque copie : tout le monde voit qui d'autre l'a reçu.

bcc

Copies 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 àChampHeader ToHeader Cc
ana@example.comtoana@example.combob@example.com, carol@example.com
bob@example.comccana@example.combob@example.com, carol@example.com
carol@example.comccana@example.combob@example.com, carol@example.com
dan@example.combccana@example.combob@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[]obligatoire

    Destinataires principaux. Affichés dans le header To de chaque copie.

    ex. "ana@example.com"

  • ccstring | string[]facultatif

    Copies visibles. Affichées dans le header Cc de chaque copie.

    ex. ["bob@example.com", "carol@example.com"]

  • bccstring | string[]facultatif

    Copies 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.

Les erreurs propres aux destinataires. Chacune d'elles rejette toute la requête, aucune copie n'est donc envoyée.

  • 401NO_CREDITS_LEFT

    Crédits e-mail insuffisants pour tous les destinataires. Chaque adresse dans to, cc et bcc utilise 1 crédit.

  • 400INVALID_TOADDRESS

    Une ou plusieurs adresses de destinataire sont mal formées.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Plus de 50 destinataires dans le tableau to.

  • 400INVALID_CCADDRESS

    Une ou plusieurs adresses cc sont mal formées.

  • 400INVALID_BCCADDRESS

    Une ou plusieurs adresses bcc sont mal formées.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc et bcc réunis comptent plus de 50 destinataires uniques.