CC & BCC
Envie um email para destinatários em To, Cc e Bcc, pela API ou por SMTP. Cada um recebe a própria cópia, e os destinatários em Bcc ficam ocultos.
https://mail.sendcorex.com/v3.0/send Mesmo endpoint e campos de Enviar email, mais cc e bcc. Vai enviar o mesmo email para muitas pessoas que não devem se ver? Use Enviar emails em lote.
Como funciona
Cada endereço recebe a própria cópia do email. Os headers To e Cc são iguais em todas as cópias, então a conversa aparece igual para todo mundo.
toDestinatários principais
Aparecem no header To de todas as cópias.
ccCópias visíveis
Aparecem no header Cc de todas as cópias, então todos veem quem mais recebeu.
bccCópias ocultas
Recebem o mesmo email, mas nunca aparecem em nenhum header, nem na própria cópia.
O que cada destinatário vê
Para o exemplo desta página: um to, dois cc e um bcc.
| Cópia enviada para | 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 não aparece em nenhum header. Ele recebe o email, mas ninguém consegue saber que ele recebeu, e a própria cópia dele também não mostra o endereço dele.
Parâmetros do body
Todos os outros campos funcionam igual a Enviar email.
tostring | string[]obrigatórioDestinatários principais. Aparecem no header To de todas as cópias.
ex.
"ana@example.com"ccstring | string[]opcionalCópias visíveis. Aparecem no header Cc de todas as cópias.
ex.
["bob@example.com", "carol@example.com"]bccstring | string[]opcionalCópias ocultas. Cada um recebe o email, mas nenhum header os mostra.
ex.
"dan@example.com"
Cada campo aceita um endereço como string ou vários como array. Os nomes dos campos não diferenciam maiúsculas de minúsculas: cc, Cc e CC funcionam.
Com a 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;Resposta
ids tem um id por destinatário, incluindo cc e bcc. Use-o para associar logs e webhooks a cada cópia.
{
"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
}Com SMTP
Use as opções cc e bcc da sua biblioteca. Todo endereço vai no envelope (RCPT TO) e recebe a própria cópia. O header Cc é mantido como você enviou. Um destinatário do envelope que não está em To nem em Cc é um destinatário Bcc. As configurações de conexão estão em Integração 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);Montando a mensagem manualmente?Não escreva um header Bcc:. Coloque os endereços Bcc só no envelope, como no exemplo em Go. As bibliotecas acima já fazem isso por você.
Limites e créditos
Até 50 destinatários
to, cc e bcc juntos podem ter até 50 endereços únicos. Acima disso a requisição falha com RECIPIENT_LIMIT_EXCEEDED e nada é enviado.
Duplicados recebem uma cópia
Um endereço que aparece em mais de um campo, com qualquer combinação de maiúsculas e minúsculas, recebe uma única cópia. Ele conta no primeiro campo em que aparece: to, depois cc, depois bcc.
1 crédito por cópia
Cada destinatário é um email: 1 to, 2 cc e 1 bcc usam 4 créditos. Se você tiver menos créditos que destinatários, a requisição falha com NO_CREDITS_LEFT e nada é enviado.
Um email por destinatário
Cada cópia tem o próprio id, log, webhooks, rastreamento de abertura e clique, e link de descadastro. Um bounce em uma cópia não afeta as outras.
Hard bounces são verificados para todo endereço
Um endereço em cc ou bcc que deu hard bounce nos últimos 90 dias não é contatado, igual a um endereço em to. Você recebe um evento bounced para essa cópia.
Sem cc ou bcc, nada muda
Se você enviar to como array e deixar cc e bcc de fora, cada destinatário continua recebendo um email separado que mostra só o próprio endereço.
Cópias bloqueadas por um hard bounce conhecido retornam como um evento bounced apenas para aquele destinatário.
Os erros específicos de destinatários. Qualquer um deles rejeita a requisição inteira, então nenhuma cópia é enviada.
- 401
NO_CREDITS_LEFTCréditos de email insuficientes para todos os destinatários. Cada endereço em to, cc e bcc usa 1 crédito.
- 400
INVALID_TOADDRESSUm ou mais endereços de destinatário estão malformados.
- 400
TOADDRESS_LIMIT_EXCEEDEDMais de 50 destinatários no array to.
- 400
INVALID_CCADDRESSUm ou mais endereços de cc estão malformados.
- 400
INVALID_BCCADDRESSUm ou mais endereços de bcc estão malformados.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc e bcc juntos têm mais de 50 destinatários únicos.