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.
https://mail.sendcorex.com/v3.0/send 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.
toDestinatarios principales
Aparecen en el header To de cada copia.
ccCopias visibles
Aparecen en el header Cc de cada copia, así que todos ven quién más lo recibió.
bccCopias 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 a | Campo | 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 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[]obligatorioDestinatarios principales. Aparecen en el header To de cada copia.
p. ej.
"ana@example.com"ccstring | string[]opcionalCopias visibles. Aparecen en el header Cc de cada copia.
p. ej.
["bob@example.com", "carol@example.com"]bccstring | string[]opcionalCopias 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.
Errores
Todos los códigos de error →Los errores específicos de los destinatarios. Cualquiera de ellos rechaza toda la solicitud, así que no se envía ninguna copia.
- 401
NO_CREDITS_LEFTNo hay créditos de email suficientes para todos los destinatarios. Cada dirección en to, cc y bcc usa 1 crédito.
- 400
INVALID_TOADDRESSUna o más direcciones de destinatario están mal formadas.
- 400
TOADDRESS_LIMIT_EXCEEDEDMás de 50 destinatarios en el array to.
- 400
INVALID_CCADDRESSUna o más direcciones de cc están mal formadas.
- 400
INVALID_BCCADDRESSUna o más direcciones de bcc están mal formadas.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc y bcc juntos tienen más de 50 destinatarios únicos.