Email

CC & BCC

Envía un email a destinatarios en To, Cc y Bcc, con la API o por SMTP. Cada uno recibe su propia copia y los destinatarios en Bcc permanecen ocultos.

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

Mismo endpoint y campos que Enviar email, más cc y bcc. ¿Vas a enviar el mismo email a muchas personas que no deben verse entre sí? Usa Enviar emails en lote.

Cómo funciona

Cada dirección recibe su propia copia del email. Los headers To y Cc son iguales en todas las copias, así que la conversación se ve igual para todos.

to

Destinatarios principales

Aparecen en el header To de cada copia.

cc

Copias visibles

Aparecen en el header Cc de cada copia, así que todos ven quién más lo recibió.

bcc

Copias ocultas

Reciben el mismo email pero nunca aparecen en ningún header, ni siquiera en su propia copia.

Qué ve cada destinatario

Para el ejemplo de esta página: un to, dos cc y un bcc.

Copia enviada aCampoHeader 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 no aparece en ningún header. Recibe el email, pero nadie puede saber que lo recibió, y su propia copia tampoco muestra su dirección.

Parámetros del body

Todos los demás campos funcionan igual que en Enviar email.

  • tostring | string[]obligatorio

    Destinatarios principales. Aparecen en el header To de cada copia.

    p. ej. "ana@example.com"

  • ccstring | string[]opcional

    Copias visibles. Aparecen en el header Cc de cada copia.

    p. ej. ["bob@example.com", "carol@example.com"]

  • bccstring | string[]opcional

    Copias ocultas. Cada uno recibe el email, pero ningún header los muestra.

    p. ej. "dan@example.com"

Cada campo acepta una dirección como string o varias como array. Los nombres de los campos no distinguen entre mayúsculas y minúsculas: cc, Cc y CC funcionan.

Con la 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;

Respuesta

ids tiene un id por destinatario, incluidos cc y bcc. Úsalo para asociar logs y webhooks a cada copia.

{
  "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
}

Con SMTP

Usa las opciones cc y bcc de tu librería. Cada dirección va en el sobre (RCPT TO) y recibe su propia copia. El header Cc se mantiene tal como lo enviaste. Un destinatario del sobre que no está en To ni en Cc es un destinatario Bcc. La configuración de conexión está en Integración 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);
!

¿Construyes el mensaje a mano?No escribas un header Bcc:. Pon las direcciones Bcc solo en el sobre, como en el ejemplo de Go. Las librerías de arriba ya lo hacen por ti.

Límites y créditos

Hasta 50 destinatarios

to, cc y bcc juntos pueden tener hasta 50 direcciones únicas. Por encima de eso la solicitud falla con RECIPIENT_LIMIT_EXCEEDED y no se envía nada.

Los duplicados reciben una copia

Una dirección que aparece en más de un campo, con cualquier combinación de mayúsculas y minúsculas, recibe una sola copia. Cuenta en el primer campo donde aparece: to, luego cc, luego bcc.

1 crédito por copia

Cada destinatario es un email: 1 to, 2 cc y 1 bcc usan 4 créditos. Si tienes menos créditos que destinatarios, la solicitud falla con NO_CREDITS_LEFT y no se envía nada.

Un email por destinatario

Cada copia tiene su propio id, log, webhooks, seguimiento de aperturas y clics, y enlace de baja. Un bounce en una copia no afecta a las demás.

Los hard bounces se comprueban para cada dirección

Una dirección en cc o bcc que dio hard bounce en los últimos 90 días no se contacta, igual que una dirección en to. Recibes un evento bounced para esa copia.

Sin cc ni bcc, nada cambia

Si envías to como array y no incluyes cc ni bcc, cada destinatario sigue recibiendo un email separado que muestra solo su propia dirección.

Las copias bloqueadas por un hard bounce conocido vuelven como un evento bounced solo para ese destinatario.

Los errores específicos de los destinatarios. Cualquiera de ellos rechaza toda la solicitud, así que no se envía ninguna copia.

  • 401NO_CREDITS_LEFT

    No hay créditos de email suficientes para todos los destinatarios. Cada dirección en to, cc y bcc usa 1 crédito.

  • 400INVALID_TOADDRESS

    Una o más direcciones de destinatario están mal formadas.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Más de 50 destinatarios en el array to.

  • 400INVALID_CCADDRESS

    Una o más direcciones de cc están mal formadas.

  • 400INVALID_BCCADDRESS

    Una o más direcciones de bcc están mal formadas.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc y bcc juntos tienen más de 50 destinatarios únicos.