Menerima Email: Draf
Simpan draf
Simpan email di Draf tanpa mengirimnya. Draf terbuka di webmail seperti draf lainnya, dan Anda bisa mengirimnya nanti dengan send_draft.
https://g.sendcorex.com/v1command: save_draftDraf boleh belum lengkap: semua field opsional. Yang Anda kirim diperiksa (to yang bukan email akan gagal), yang tidak Anda kirim tidak diperiksa.
Untuk mengedit draf, kirim draft_id-nya. Field yang tidak Anda kirim tetap dipertahankan (isi, penerima, subjek, lampiran, tindak lanjut). Setiap penyimpanan mengembalikan draft_id BARU dan yang lama berhenti berfungsi, jadi selalu simpan yang terakhir.
Jika track_opens atau track_clicks dihilangkan, draf mempertahankan pilihan yang sudah ada. send_draft dan pengiriman terjadwal memakai pilihan itu.
Penerima yang menolak pelacakan di halaman preferensi tidak pernah dilacak, bahkan dengan true.
Argumen
draft_idstringopsionalEdit draf ini, bukan membuat draf baru.
modestringopsionalnew(default),reply, atauforward. Saat diedit, draf mempertahankan mode-nya.idstringopsionalPesan asli, untuk
replydanforward. Subjek default-nya Re: / Fwd: asli.tostring | string[]opsionalPenerima, atau daftar hingga 30 untuk
new(paket berbayar). Diabaikan untukreply: dikirim ke pengirim pesan asli.ccstring[]opsionalSalinan terlihat.
bccstring[]opsionalSalinan tersembunyi.
subjectstringopsionalSubjek.
htmlstringopsionalIsi HTML. Atau
text, atautemplate_id.textstringopsionalIsi teks biasa, diubah menjadi HTML sederhana.
template_idstringopsionalIsi body (dan subjek) dari template.
variablesobjectopsionalNilai untuk variabel template, misalnya
{ "first_name": "Ana" }.followup_after_hoursnumber | nullopsionalMengingatkan Anda jika tidak ada yang membalas sekian jam setelah dikirim (hingga 8760).
nullmenghapusnya.attachmentsobject[]opsionalFile untuk dilampirkan:
[{ file_name, content, content_type }],contentdalam base64. Ditambahkan ke file yang sudah dimiliki draf.compose_uidstringopsionalFile yang sudah diunggah sebelumnya dengan
upload_attachmentatau Unggah file besar.attachment_idsstring[]opsionalFile unggahan mana yang dipakai. Tanpa ini, semuanya.
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: "save_draft",
args: {
to: "ana@client.com",
subject: "Proposal",
html: "<p>Hi Ana, here is the proposal.</p>"
}
}
]
},
{ 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": "save_draft",
"id": "0",
"type": "SUCCESS",
"data": {
"draft_id": "Vj0xRFJBRlQx",
"thread_id": "thr_9a1c4e72"
}
}
]
}Field respons
draft_idDraf. Gunakan untuk mengedit, membaca, mengirim, atau menghapusnya. Berubah setiap kali disimpan.
thread_idPercakapan tempat draf berada.
Edit draf
Di sini hanya subjek yang berubah. Isi, penerima, dan lampiran tetap seperti sebelumnya.
Body request
{
"commands": [
{
"command": "save_draft",
"args": {
"draft_id": "Vj0xRFJBRlQx",
"subject": "Proposal (v2)"
}
}
]
}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
INVALID_ARGSArgumen wajib tidak ada atau tidak valid.
- CMD
PAID_PLAN_REQUIREDLebih dari satu alamat di `to` memerlukan paket berbayar.
- CMD
TOO_MANY_RECIPIENTS`to` berisi lebih dari 30 alamat.
- CMD
DRAFT_NOT_FOUNDDraf sudah tidak ada: sudah dikirim, dihapus, atau disimpan lagi (setiap penyimpanan mengembalikan draft_id baru).
- CMD
MISSING_TARGETReply dan forward memerlukan email asli, dan email itu harus masih ada.
- CMD
INVALID_RECIPIENTPenerima tidak ada atau 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
INTERNALError server. Detailnya hanya ditulis ke log server.