E-Mail

CC & BCC

Senden Sie eine E-Mail an To-, Cc- und Bcc-Empfänger, per API oder per SMTP. Jeder erhält eine eigene Kopie, und Bcc-Empfänger bleiben verborgen.

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

Derselbe Endpoint und dieselben Felder wie E-Mail senden, plus cc und bcc. Sie senden dieselbe E-Mail an viele Personen, die sich gegenseitig nicht sehen sollen? Verwenden Sie Batch-E-Mails senden.

So funktioniert es

Jede Adresse erhält ihre eigene Kopie der E-Mail. Die Header To und Cc sind in jeder Kopie gleich, sodass die Konversation für alle gleich aussieht.

to

Hauptempfänger

Erscheinen im To-Header jeder Kopie.

cc

Sichtbare Kopien

Erscheinen im Cc-Header jeder Kopie, sodass alle sehen, wer sie sonst noch bekommen hat.

bcc

Verborgene Kopien

Erhalten dieselbe E-Mail, erscheinen aber in keinem Header, nicht einmal in ihrer eigenen Kopie.

Was jeder Empfänger sieht

Für das Beispiel auf dieser Seite: ein to, zwei cc und ein bcc.

Kopie gesendet anFeldTo-HeaderCc-Header
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 steht in keinem Header. Er erhält die E-Mail, aber niemand kann erkennen, dass er sie bekommen hat, und auch seine eigene Kopie zeigt seine Adresse nicht.

Body-Parameter

Alle anderen Felder funktionieren genauso wie bei E-Mail senden.

  • tostring | string[]erforderlich

    Hauptempfänger. Erscheinen im To-Header jeder Kopie.

    z. B. "ana@example.com"

  • ccstring | string[]optional

    Sichtbare Kopien. Erscheinen im Cc-Header jeder Kopie.

    z. B. ["bob@example.com", "carol@example.com"]

  • bccstring | string[]optional

    Verborgene Kopien. Jeder erhält die E-Mail, aber kein Header zeigt sie an.

    z. B. "dan@example.com"

Jedes Feld akzeptiert eine Adresse als String oder mehrere als Array. Bei Feldnamen wird die Groß-/Kleinschreibung nicht beachtet: cc, Cc und CC funktionieren alle.

Mit der 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;

Antwort

ids enthält eine id pro Empfänger, cc und bcc eingeschlossen. Damit ordnen Sie Logs und Webhooks den einzelnen Kopien zu.

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

Mit SMTP

Verwenden Sie die cc- und bcc-Optionen Ihrer Bibliothek. Jede Adresse kommt in den Envelope (RCPT TO) und erhält ihre eigene Kopie. Der Cc-Header bleibt so, wie Sie ihn gesendet haben. Ein Empfänger im Envelope, der weder in To noch in Cc steht, ist ein Bcc-Empfänger. Die Verbindungseinstellungen finden Sie unter SMTP-Integration.

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);
!

Bauen Sie die Nachricht selbst zusammen?Schreiben Sie keinen Bcc:-Header. Tragen Sie die Bcc-Adressen nur in den Envelope ein, wie im Go-Beispiel. Die Bibliotheken oben erledigen das bereits für Sie.

Limits und Credits

Bis zu 50 Empfänger

to, cc und bcc zusammen können bis zu 50 eindeutige Adressen enthalten. Darüber schlägt die Anfrage mit RECIPIENT_LIMIT_EXCEEDED fehl und nichts wird gesendet.

Duplikate erhalten eine Kopie

Eine Adresse, die in mehr als einem Feld vorkommt, egal in welcher Groß-/Kleinschreibung, erhält eine einzige Kopie. Sie zählt in dem ersten Feld, in dem sie vorkommt: to, dann cc, dann bcc.

1 Credit pro Kopie

Jeder Empfänger ist eine E-Mail: 1 to, 2 cc und 1 bcc verbrauchen 4 Credits. Haben Sie weniger Credits als Empfänger, schlägt die Anfrage mit NO_CREDITS_LEFT fehl und nichts wird gesendet.

Eine E-Mail pro Empfänger

Jede Kopie hat ihre eigene id, ihr eigenes Log, eigene Webhooks, Öffnungs- und Klick-Tracking sowie einen eigenen Abmeldelink. Ein Bounce bei einer Kopie wirkt sich nicht auf die anderen aus.

Hard Bounces werden für jede Adresse geprüft

Eine cc- oder bcc-Adresse, die in den letzten 90 Tagen einen Hard Bounce hatte, wird nicht kontaktiert, genau wie eine to-Adresse. Sie erhalten für diese Kopie ein bounced-Event.

Ohne cc oder bcc ändert sich nichts

Wenn Sie to als Array senden und cc und bcc weglassen, erhält jeder Empfänger weiterhin eine separate E-Mail, die nur seine eigene Adresse zeigt.

Kopien, die durch einen bekannten Hard Bounce blockiert werden, kommen als bounced-Event nur für diesen Empfänger zurück.

Die empfängerspezifischen Fehler. Jeder davon lehnt die gesamte Anfrage ab, es wird also keine Kopie gesendet.

  • 401NO_CREDITS_LEFT

    Nicht genug E-Mail-Credits für alle Empfänger. Jede Adresse in to, cc und bcc verbraucht 1 Credit.

  • 400INVALID_TOADDRESS

    Eine oder mehrere Empfängeradressen sind fehlerhaft.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Mehr als 50 Empfänger im Array to.

  • 400INVALID_CCADDRESS

    Eine oder mehrere cc-Adressen sind fehlerhaft.

  • 400INVALID_BCCADDRESS

    Eine oder mehrere bcc-Adressen sind fehlerhaft.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc und bcc haben zusammen mehr als 50 eindeutige Empfänger.