Email

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.

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

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.

to

Penerima utama

Ditampilkan di header To pada setiap salinan.

cc

Salinan terlihat

Ditampilkan di header Cc pada setiap salinan, sehingga semua orang melihat siapa lagi yang menerimanya.

bcc

Salinan 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 keFieldHeader 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 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[]wajib

    Penerima utama. Ditampilkan di header To pada setiap salinan.

    mis. "ana@example.com"

  • ccstring | string[]opsional

    Salinan terlihat. Ditampilkan di header Cc pada setiap salinan.

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

  • bccstring | string[]opsional

    Salinan 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 yang khusus terkait penerima. Salah satu dari error ini menolak seluruh permintaan, sehingga tidak ada salinan yang dikirim.

  • 401NO_CREDITS_LEFT

    Kredit email tidak cukup untuk semua penerima. Setiap alamat di to, cc, dan bcc memakai 1 kredit.

  • 400INVALID_TOADDRESS

    Satu atau lebih alamat penerima tidak valid.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Lebih dari 50 penerima di array to.

  • 400INVALID_CCADDRESS

    Satu atau lebih alamat cc tidak valid.

  • 400INVALID_BCCADDRESS

    Satu atau lebih alamat bcc tidak valid.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc, dan bcc jika digabung memiliki lebih dari 50 penerima unik.