Email

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.

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

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.

to

Destinatários principais

Aparecem no header To de todas as cópias.

cc

Cópias visíveis

Aparecem no header Cc de todas as cópias, então todos veem quem mais recebeu.

bcc

Có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 paraCampoHeader 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ã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ório

    Destinatários principais. Aparecem no header To de todas as cópias.

    ex. "ana@example.com"

  • ccstring | string[]opcional

    Cópias visíveis. Aparecem no header Cc de todas as cópias.

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

  • bccstring | string[]opcional

    Có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.

  • 401NO_CREDITS_LEFT

    Créditos de email insuficientes para todos os destinatários. Cada endereço em to, cc e bcc usa 1 crédito.

  • 400INVALID_TOADDRESS

    Um ou mais endereços de destinatário estão malformados.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Mais de 50 destinatários no array to.

  • 400INVALID_CCADDRESS

    Um ou mais endereços de cc estão malformados.

  • 400INVALID_BCCADDRESS

    Um ou mais endereços de bcc estão malformados.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc e bcc juntos têm mais de 50 destinatários únicos.