Menerima Email: Jadwal

Jadwalkan kirim

Tulis email sekarang dan kirim nanti. Email menunggu di folder Scheduled sampai waktu yang Anda pilih.

POSThttps://g.sendcorex.com/v1command: schedule_send
i

Semua yang bisa diperiksa langsung diperiksa sekarang (penerima, subjek, email asli, lampiran), jadi Anda tahu sebelum waktunya tiba. Kredit dan batas harian diperiksa saat dikirim.

i

Jika pengiriman ditolak pada saat itu (kredit habis, batas harian, spam), tidak ada yang hilang: email kembali ke Draf beserta alasannya.

i

Penerima yang menolak pelacakan di halaman preferensi tidak pernah dilacak, bahkan dengan true.

i

Email yang dikirim dari mailbox tidak membawa header List-Unsubscribe maupun link berhenti berlangganan kecuali Anda mengirim unsubscribe: true, karena itu email pribadi.

i

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.

i

Dengan unsubscribe: true, penerima yang sudah berhenti berlangganan dari mailbox ini ditolak dengan RECIPIENT_UNSUBSCRIBED, dan recipients mencantumkan mereka. Balasan tidak pernah diblokir.

Argumen

  • send_atstringwajib

    RFC 3339, YYYY-MM-DD, atau epoch ms. Minimal 1 menit dari sekarang dan maksimal 1 tahun.

  • modestringopsional

    new (default), reply, atau forward.

  • idstringopsional

    Pesan asli, untuk reply dan forward.

  • tostring | string[]opsional

    Penerima. Wajib untuk new dan forward. Untuk new bisa berupa daftar hingga 30 (paket berbayar).

  • ccstring[]opsional

    Salinan terlihat.

  • bccstring[]opsional

    Salinan tersembunyi.

  • subjectstringopsional

    Wajib untuk new. Reply dan forward default-nya Re: / Fwd: asli.

  • htmlstringopsional

    Isi HTML. Atau text, atau template_id.

  • template_idstringopsional

    Isi body (dan subjek email baru) dari template.

  • followup_after_hoursnumberopsional

    Mengingatkan Anda jika tidak ada yang membalas sekian jam setelah dikirim.

  • scheduled_idstringopsional

    Jadwal ulang: email terjadwal yang lama diganti.

  • attachmentsobject[]opsional

    File untuk dilampirkan: [{ file_name, content, content_type }], content dalam base64. Hingga 20 file dan total 25 MB. Setiap file dipindai; file berbahaya gagal dengan FILE_BLOCKED.

  • compose_uidstringopsional

    Lampiran yang sudah Anda unggah sebelumnya dengan upload_attachment.

  • attachment_idsstring[]opsional

    Lampiran unggahan mana yang dikirim. Tanpa ini, semuanya.

  • track_opensbooleanopsional

    Melacak kapan setiap penerima membuka email (piksel tak terlihat). Default true.

  • track_clicksbooleanopsional

    Melacak klik pada link (setiap link melewati pengalihan). Default true.

  • unsubscribebooleanopsional

    Menambahkan link berhenti berlangganan. Letakkan [unsubscribe] di isi email (sebagai href link atau teks biasa) di tempat link seharusnya; tanpa itu, baris default ditambahkan di akhir. Default false.

  • audiencestringopsional

    Kirim ke audiens alih-alih alamat: subscribed, opened, clicked, both, seg:<segment_id>, atau msg:<message_uid>:opened|clicked|not_opened. to menjadi opsional. Hingga 5.000 orang. Tautan berhenti berlangganan diaktifkan dan email dikirim sebagai marketing. Paket berbayar.

  • best_timebooleanopsional

    Kirim ke setiap orang pada jam saat ia biasanya membuka atau mengeklik, sepanjang hari send_at. Memerlukan audience dan mode: new. send_at adalah pukul 00:00 hari itu di zona waktu Anda, dalam UTC.

  • best_fallback_atstring | numberopsional

    Waktu untuk orang tanpa riwayat (RFC 3339 atau epoch ms). Harus di hari yang sama dengan send_at.

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "schedule_send",
        args: {
          to: "ana@client.com",
          subject: "Proposal",
          html: "<p>Hi Ana, here is the proposal.</p>",
          send_at: "2026-10-27T09:00:00+08:00"
        }
      }
    ]
  },
  { 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": "schedule_send",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "scheduled_id": "Vj0xQUJDMTIz",
        "thread_id": "thr_9a1c4e72",
        "send_at": "2026-10-27T01:00:00Z"
      }
    }
  ]
}

Field respons

  • scheduled_id

    Pesan di Scheduled. Gunakan untuk membatalkan, menjadwalkan ulang, atau mengirim sekarang.

Tampilkan yang terjadwal

Email terjadwal ada di folder Scheduled, diurutkan berdasarkan waktu kirim.

Body request

{
  "commands": [
    {
      "command": "list_messages",
      "args": {
        "folder": "Scheduled"
      }
    }
  ]
}

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 401TOKEN_EXPIRED

    Access token sudah kedaluwarsa. Panggil Refresh Token lalu ulangi request.

  • 401INVALID_TOKEN

    Token salah format, tidak dikenal, atau dicabut.

  • 429RATE_LIMITED

    Lebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.

  • CMDINVALID_AUDIENCE

    Audiens tidak valid: grup tidak dikenal, segmen kotak lain, atau pesan yang tidak dikirim kotak ini.

  • CMDAUDIENCE_OVER_LIMIT

    Audiens berisi lebih banyak orang daripada yang bisa Anda kirimi (hingga 5.000 per email dan batas harian Anda). `total` dan `allowed` menunjukkan jumlahnya.

  • CMDEMPTY_AUDIENCE

    Belum ada orang di audiens ini.

  • CMDBEST_TIME_NEEDS_AUDIENCE

    `best_time` memerlukan `audience` dan `mode: new`.

  • CMDRECIPIENT_UNSUBSCRIBED

    Satu atau beberapa penerima sudah berhenti berlangganan dari mailbox ini. `recipients` mencantumkan mereka: hapus mereka atau kirim ulang dengan `unsubscribe: false`.

  • CMDPAID_PLAN_REQUIRED

    Lebih dari satu alamat di `to` memerlukan paket berbayar.

  • CMDTOO_MANY_RECIPIENTS

    `to` berisi lebih dari 30 alamat.

  • CMDINVALID_ARGS

    Argumen wajib tidak ada atau tidak valid.

  • CMDINVALID_TIME

    send_at tidak ada, kurang dari 1 menit lagi, atau lebih dari 1 tahun lagi.

  • CMDINVALID_RECIPIENT

    Penerima tidak ada atau bukan email yang valid.

  • CMDMISSING_SUBJECT

    Email baru memerlukan subjek.

  • CMDMISSING_TARGET

    Reply dan forward memerlukan email asli, dan email itu harus masih ada.

  • CMDRECIPIENT_LIMIT_EXCEEDED

    to, cc, dan bcc bersama-sama berisi lebih dari 50 alamat.

  • CMDFILE_BLOCKED

    Sebuah file diblokir oleh pemindaian keamanan.

  • CMDATTACHMENTS_TOO_LARGE

    Lampiran email totalnya lebih dari 25 MB, atau kotak surat sudah memiliki 500 MB unggahan yang menunggu dikirim.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.