Menerima Email: Kirim & kepercayaan
Balas
Balas di dalam percakapan yang sama. Balasan disimpan di Terkirim dan INBOX, dan subjek menjadi Re: asli.
https://g.sendcorex.com/v1command: replyPenerimanya adalah reply_to (atau from) dari pesan asli. Jika id adalah pesan yang Anda kirim, balasan dikirim ke klien terakhir yang menulis di percakapan, bukan ke diri Anda sendiri. Label dari pesan asli dipertahankan.
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
idstringwajibmessage_uiddari pesan yang Anda balas.htmlstringopsionalIsi HTML. Kirim
htmlatautext.textstringopsionalIsi teks biasa.
reply_allbooleanopsionalSemua orang di To dan Cc pesan asli dimasukkan ke Cc, kecuali Anda dan orang yang Anda balas.
ccstring[]opsionalPenerima tambahan di salinan.
bccstring[]opsionalPenerima tambahan di salinan tersembunyi.
template_idstringopsionalIsi body dari template.
attachmentsobject[]opsionalFile dalam base64, format sama seperti Kirim email.
compose_uidstringopsionalLampiran yang sudah diunggah sebelumnya dengan
upload_attachment.followup_atstringopsionalMengingatkan Anda jika tidak ada yang membalas sampai tanggal ini. Tanpa ini, pengingat yang sudah ada di percakapan dihapus (Anda baru saja membalas).
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.recipientstringopsionalHanya untuk email yang dikirim kotak ini: siapa yang menerima tindak lanjut, dalam percakapan yang sama dengan “Re:”. Orang itu harus sudah menerima email tersebut (jika tidak,
INVALID_RECIPIENT). Tanpanya, balasan atas email terkirim dikirim ke penerimanya, tidak pernah kembali ke kotak.
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "reply",
args: {
id: "Vj0xQUJDMTIz",
text: "Received, thank you!",
reply_all: true
}
}
]
},
{ 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": "reply",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "<5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90>",
"queued": true
}
}
]
}Field respons
message_uidId balasan.
thread_idPercakapan yang sama dengan pesan asli.
message_idMessage-ID sementara, digantikan oleh yang asli dari SMTP tidak lama kemudian.
queuedtrue= tersimpan dan masuk antrean, belum terkirim.
Balas email terakhir dari seorang pengirim
Cari berdasarkan pengirim, lalu balas hasil terbaru. Pencarian mengembalikan pesan terbaru lebih dulu.
Node.js
const [s] = await call({
command: 'search',
args: { query: 'ana@client.com', field: 'from', limit: 5 },
});
const last = s.data.messages[0]; // newest first
if (last) {
const [r] = await call({
command: 'reply',
args: { id: last.message_uid, html: '<p>Hi Ana, received!</p>' },
});
console.log(r.data); // { message_uid, thread_id, message_id, queued: true }
}Balas setiap percakapan yang belum dibaca
Balas dan tandai percakapan sebagai dibaca dalam request yang sama, supaya polling berikutnya tidak membalasnya lagi.
Node.js
const [l] = await call({ command: 'list_threads', args: { is_read: false, limit: 20 } });
for (const t of l.data.threads) {
await call([
{ command: 'reply', args: { id: t.last_message_uid, text: 'We got your message and will get back to you.' } },
{ command: 'set_flags', args: { id: t.last_message_uid, is_read: true, scope: 'thread' } },
]);
}Anda juga bisa merangkai list_threads dan reply dalam satu request dengan $ref, memakai last_message_uid dari setiap thread.
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_RECIPIENTPenerima tidak ada atau bukan email yang valid.
- CMD
RECIPIENT_UNSUBSCRIBEDSatu atau beberapa penerima sudah berhenti berlangganan dari mailbox ini. `recipients` mencantumkan mereka: hapus mereka atau kirim ulang dengan `unsubscribe: false`.
- CMD
INVALID_ARGSArgumen wajib tidak ada atau tidak valid.
- CMD
NOT_FOUNDPesan, percakapan, atau folder tidak ada untuk token ini.
- CMD
NO_RECIPIENTPercakapan tidak memiliki penerima untuk dibalas.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc, dan bcc bersama-sama berisi lebih dari 50 alamat.
- 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
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.