CC & BCC
Kirim satu email ke penerima To, Cc, dan Bcc, melalui API atau SMTP. Setiap orang mendapat salinannya sendiri, dan penerima Bcc tetap tersembunyi.
https://mail.sendcorex.com/v3.0/send Endpoint dan field yang sama dengan Kirim Email, ditambah cc dan bcc. Mengirim email yang sama ke banyak orang yang tidak boleh saling melihat? Gunakan Kirim Email Massal.
Cara kerja
Setiap alamat mendapat salinan email tersendiri. Header To dan Cc sama di setiap salinan, sehingga percakapan terlihat sama bagi semua orang.
toPenerima utama
Ditampilkan di header To pada setiap salinan.
ccSalinan terlihat
Ditampilkan di header Cc pada setiap salinan, sehingga semua orang melihat siapa lagi yang menerimanya.
bccSalinan tersembunyi
Menerima email yang sama tetapi tidak pernah muncul di header mana pun, bahkan di salinan mereka sendiri.
Apa yang dilihat setiap penerima
Untuk contoh di halaman ini: satu to, dua cc, dan satu bcc.
| Salinan dikirim ke | Field | 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 tidak ada di header mana pun. Ia menerima email, tetapi tidak ada yang tahu bahwa ia menerimanya, dan salinannya sendiri juga tidak menampilkan alamatnya.
Parameter body
Semua field lain bekerja sama seperti di Kirim Email.
tostring | string[]wajibPenerima utama. Ditampilkan di header To pada setiap salinan.
mis.
"ana@example.com"ccstring | string[]opsionalSalinan terlihat. Ditampilkan di header Cc pada setiap salinan.
mis.
["bob@example.com", "carol@example.com"]bccstring | string[]opsionalSalinan tersembunyi. Masing-masing menerima email, tetapi tidak ada header yang menampilkannya.
mis.
"dan@example.com"
Setiap field menerima satu alamat sebagai string atau beberapa alamat sebagai array. Nama field tidak peka huruf besar/kecil: cc, Cc, dan CC semuanya berfungsi.
Dengan 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;Respons
ids berisi satu id per penerima, termasuk cc dan bcc. Gunakan untuk mencocokkan log dan webhook dengan setiap salinan.
{
"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
}Dengan SMTP
Gunakan opsi cc dan bcc dari library Anda. Setiap alamat masuk ke envelope (RCPT TO) dan mendapat salinannya sendiri. Header Cc dipertahankan seperti yang Anda kirim. Penerima di envelope yang tidak ada di To atau Cc adalah penerima Bcc. Pengaturan koneksi ada di Integrasi 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);Menyusun pesan secara manual?Jangan tulis header Bcc:. Masukkan alamat Bcc hanya di envelope, seperti pada contoh Go. Library di atas sudah melakukannya untuk Anda.
Batas dan kredit
Hingga 50 penerima
to, cc, dan bcc bersama-sama bisa berisi hingga 50 alamat unik. Lebih dari itu, permintaan gagal dengan RECIPIENT_LIMIT_EXCEEDED dan tidak ada yang dikirim.
Duplikat mendapat satu salinan
Alamat yang muncul di lebih dari satu field, dengan huruf besar/kecil apa pun, mendapat satu salinan. Alamat dihitung di field pertama tempat ia muncul: to, lalu cc, lalu bcc.
1 kredit per salinan
Setiap penerima adalah satu email: 1 to, 2 cc, dan 1 bcc menggunakan 4 kredit. Jika kredit Anda lebih sedikit dari jumlah penerima, permintaan gagal dengan NO_CREDITS_LEFT dan tidak ada yang dikirim.
Satu email per penerima
Setiap salinan memiliki id, log, webhook, pelacakan open dan klik, serta link berhenti berlangganan sendiri. Bounce pada satu salinan tidak memengaruhi yang lain.
Hard bounce diperiksa untuk setiap alamat
Alamat cc atau bcc yang mengalami hard bounce dalam 90 hari terakhir tidak dihubungi, sama seperti alamat to. Anda menerima event bounced untuk salinan tersebut.
Tanpa cc atau bcc, tidak ada yang berubah
Jika Anda mengirim to sebagai array tanpa cc dan bcc, setiap penerima tetap mendapat email terpisah yang hanya menampilkan alamatnya sendiri.
Salinan yang diblokir karena hard bounce yang sudah diketahui dikembalikan sebagai event bounced hanya untuk penerima tersebut.
Error
Semua kode error →Error yang khusus terkait penerima. Salah satu dari error ini menolak seluruh permintaan, sehingga tidak ada salinan yang dikirim.
- 401
NO_CREDITS_LEFTKredit email tidak cukup untuk semua penerima. Setiap alamat di to, cc, dan bcc memakai 1 kredit.
- 400
INVALID_TOADDRESSSatu atau lebih alamat penerima tidak valid.
- 400
TOADDRESS_LIMIT_EXCEEDEDLebih dari 50 penerima di array to.
- 400
INVALID_CCADDRESSSatu atau lebih alamat cc tidak valid.
- 400
INVALID_BCCADDRESSSatu atau lebih alamat bcc tidak valid.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc, dan bcc jika digabung memiliki lebih dari 50 penerima unik.