Menerima Email: Kirim & kepercayaan
Kirim email
Kirim email baru dari pengirim di balik token Anda. Pesan langsung disimpan di Terkirim dan dikirim di latar belakang.
https://g.sendcorex.com/v1command: send_emailqueued: true berarti tersimpan dan menunggu di antrean, belum terkirim. message_id di respons bersifat sementara: Message-ID SMTP yang asli menggantikannya beberapa detik kemudian dan muncul di get_messages.
Setiap penerima (to + cc + bcc) mendapat salinan sendiri dan memakai 1 kredit. Alamat bcc tidak pernah muncul di header. Isi dibatasi 2 MB, lampiran total 25 MB.
Penerima yang menolak pelacakan di halaman preferensi tidak pernah dilacak, bahkan dengan true.
Email yang dikirim dari mailbox tidak membawa header List-Unsubscribe maupun link berhenti berlangganan kecuali Anda mengirim unsubscribe: true, karena itu email pribadi.
Setiap orang yang menerima email dari mailbox menjadi kontak di daftar “Webmail” akun dan menjadi trusted di mailbox ini: balasannya masuk ke Inbox dan alamatnya muncul di pelengkapan otomatis. Pengirim yang diblokir mailbox tetap diblokir.
Dengan unsubscribe: true, penerima yang sudah berhenti berlangganan dari mailbox ini ditolak dengan RECIPIENT_UNSUBSCRIBED, dan recipients mencantumkan mereka. Balasan tidak pernah diblokir.
Argumen
tostring | string[]wajibAlamat penerima, atau daftar hingga 30 alamat (paket berbayar). Dengan
unsubscribe: truesetiap orang menerima salinannya sendiri; tanpa itu, semua orang ditodanccsaling melihat.to_namestringopsionalNama penerima. Default-nya bagian sebelum
@.subjectstringwajibSubjek email.
htmlstringopsionalIsi HTML. Kirim
htmlatautext.textstringopsionalIsi teks biasa. Diubah menjadi HTML dengan
<br>.ccstring[]opsionalSalinan terlihat. to + cc + bcc hingga 50 alamat.
bccstring[]opsionalSalinan tersembunyi. Tidak pernah muncul di header.
template_idstringopsionalIsi body (dan subjek yang kosong) dari template. Placeholder memakai
to_namedanvariables.variablesobjectopsionalPlaceholder template milik Anda sendiri:
{ "company": "Acme" }mengisi{company}.attachmentsobject[]opsionalFile:
[{ file_name, content, content_type }],contentdalam base64. Hingga 20 file, total 25 MB. Setiap file dipindai.compose_uidstringopsionalLampiran yang sudah diunggah sebelumnya dengan
upload_attachment.attachment_idsstring[]opsionalLampiran unggahan mana yang dikirim. Tanpa ini, semuanya.
followup_atstringopsionalMengingatkan Anda jika tidak ada yang membalas sampai tanggal ini (RFC 3339,
YYYY-MM-DD, atau epoch ms).labelstringopsionalLabel yang dipasang pada pesan terkirim. Menjadi
labels: [label].track_opensbooleanopsionalMelacak kapan setiap penerima membuka email (piksel tak terlihat). Default
true.track_clicksbooleanopsionalMelacak klik pada link (setiap link melewati pengalihan). Default
true.unsubscribebooleanopsionalMenambahkan link berhenti berlangganan. Letakkan
[unsubscribe]di isi email (sebagaihreflink atau teks biasa) di tempat link seharusnya; tanpa itu, baris default ditambahkan di akhir. Defaultfalse.audiencestringopsionalKirim ke audiens alih-alih alamat:
subscribed,opened,clicked,both,seg:<segment_id>, ataumsg:<message_uid>:opened|clicked|not_opened.tomenjadi opsional. Hingga 5.000 orang. Tautan berhenti berlangganan diaktifkan dan email dikirim sebagai marketing. Paket berbayar.
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "send_email",
args: {
to: "client@example.com",
to_name: "Client",
cc: [
"manager@example.com"
],
subject: "Quote",
html: "<p>Here is the quote.</p>",
attachments: [
{
file_name: "quote.pdf",
content: "JVBERi0xLjcKJcfsj6IK…",
content_type: "application/pdf"
}
],
followup_at: "2026-10-29T09:00:00+08:00",
label: "sales"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respons
{
"type": "SUCCESS",
"results": [
{
"command": "send_email",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "<5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90>",
"recipients": 2,
"queued": true
}
}
]
}Field respons
message_uidId pesan terkirim. Langsung muncul di
Sent.thread_idPercakapan dari pesan baru.
message_idMessage-ID sementara. Yang asli dari SMTP menggantikannya tidak lama kemudian.
recipientsBerapa salinan yang masuk antrean (to + cc + bcc), masing-masing 1 kredit.
queuedtrue= tersimpan dan masuk antrean pengiriman. Bukan berarti sudah terkirim.
Pengiriman berulang
Penulisan yang sama (args yang sama) yang diulang dalam 1,5 detik mengembalikan hasil pertama, bukan mengirim lagi. Loop polling yang mengirim email yang sama dua kali tidak menduplikasinya.
Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
TOKEN_EXPIREDAccess token sudah kedaluwarsa. Panggil Refresh Token lalu ulangi request.
- 401
INVALID_TOKENToken salah format, tidak dikenal, atau dicabut.
- 429
RATE_LIMITEDLebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.
- CMD
INVALID_AUDIENCEAudiens tidak valid: grup tidak dikenal, segmen kotak lain, atau pesan yang tidak dikirim kotak ini.
- CMD
AUDIENCE_OVER_LIMITAudiens berisi lebih banyak orang daripada yang bisa Anda kirimi (hingga 5.000 per email dan batas harian Anda). `total` dan `allowed` menunjukkan jumlahnya.
- CMD
EMPTY_AUDIENCEBelum ada orang di audiens ini.
- CMD
RECIPIENT_UNSUBSCRIBEDSatu atau beberapa penerima sudah berhenti berlangganan dari mailbox ini. `recipients` mencantumkan mereka: hapus mereka atau kirim ulang dengan `unsubscribe: false`.
- CMD
PAID_PLAN_REQUIREDLebih dari satu alamat di `to` memerlukan paket berbayar.
- CMD
TOO_MANY_RECIPIENTS`to` berisi lebih dari 30 alamat.
- CMD
INVALID_ARGSArgumen wajib tidak ada atau tidak valid.
- CMD
INVALID_TOADDRESSAlamat to bukan email yang valid.
- CMD
INVALID_CCADDRESSSalah satu alamat cc bukan email yang valid.
- CMD
INVALID_BCCADDRESSSalah satu alamat bcc bukan email yang valid.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc, dan bcc bersama-sama berisi lebih dari 50 alamat.
- CMD
INVALID_ATTACHMENTKonten lampiran bukan base64 yang valid.
- CMD
FILE_BLOCKEDSebuah file diblokir oleh pemindaian keamanan.
- CMD
ATTACHMENTS_TOO_LARGELampiran email totalnya lebih dari 25 MB, atau kotak surat sudah memiliki 500 MB unggahan yang menunggu dikirim.
- CMD
ATTACHMENT_MISSINGLampiran yang diunggah sudah tidak ada (unggahan yang tidak dikirim dalam 48 jam, dan tidak dipakai oleh draf atau email terjadwal, akan dihapus). Unggah lagi.
- CMD
NO_CREDITSAkun memiliki kredit email lebih sedikit daripada jumlah penerima (1 kredit per salinan).
- CMD
SENDER_NOT_FOUNDPengirim di balik token tidak terdaftar.
- CMD
SENDER_NO_DOMAINPengirim di balik token tidak memiliki domain.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.