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.
https://mail.sendcorex.com/v3.0/send 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.
toHauptempfänger
Erscheinen im To-Header jeder Kopie.
ccSichtbare Kopien
Erscheinen im Cc-Header jeder Kopie, sodass alle sehen, wer sie sonst noch bekommen hat.
bccVerborgene 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 an | Feld | To-Header | Cc-Header |
|---|---|---|---|
| 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 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[]erforderlichHauptempfänger. Erscheinen im To-Header jeder Kopie.
z. B.
"ana@example.com"ccstring | string[]optionalSichtbare Kopien. Erscheinen im Cc-Header jeder Kopie.
z. B.
["bob@example.com", "carol@example.com"]bccstring | string[]optionalVerborgene 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.
Fehler
Alle Fehlercodes →Die empfängerspezifischen Fehler. Jeder davon lehnt die gesamte Anfrage ab, es wird also keine Kopie gesendet.
- 401
NO_CREDITS_LEFTNicht genug E-Mail-Credits für alle Empfänger. Jede Adresse in to, cc und bcc verbraucht 1 Credit.
- 400
INVALID_TOADDRESSEine oder mehrere Empfängeradressen sind fehlerhaft.
- 400
TOADDRESS_LIMIT_EXCEEDEDMehr als 50 Empfänger im Array to.
- 400
INVALID_CCADDRESSEine oder mehrere cc-Adressen sind fehlerhaft.
- 400
INVALID_BCCADDRESSEine oder mehrere bcc-Adressen sind fehlerhaft.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc und bcc haben zusammen mehr als 50 eindeutige Empfänger.