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.

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

queued: 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.

i

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.

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

  • tostring | string[]wajib

    Alamat penerima, atau daftar hingga 30 alamat (paket berbayar). Dengan unsubscribe: true setiap orang menerima salinannya sendiri; tanpa itu, semua orang di to dan cc saling melihat.

  • to_namestringopsional

    Nama penerima. Default-nya bagian sebelum @.

  • subjectstringwajib

    Subjek email.

  • htmlstringopsional

    Isi HTML. Kirim html atau text.

  • textstringopsional

    Isi teks biasa. Diubah menjadi HTML dengan <br>.

  • ccstring[]opsional

    Salinan terlihat. to + cc + bcc hingga 50 alamat.

  • bccstring[]opsional

    Salinan tersembunyi. Tidak pernah muncul di header.

  • template_idstringopsional

    Isi body (dan subjek yang kosong) dari template. Placeholder memakai to_name dan variables.

  • variablesobjectopsional

    Placeholder template milik Anda sendiri: { "company": "Acme" } mengisi {company}.

  • attachmentsobject[]opsional

    File: [{ file_name, content, content_type }], content dalam base64. Hingga 20 file, total 25 MB. Setiap file dipindai.

  • compose_uidstringopsional

    Lampiran yang sudah diunggah sebelumnya dengan upload_attachment.

  • attachment_idsstring[]opsional

    Lampiran unggahan mana yang dikirim. Tanpa ini, semuanya.

  • followup_atstringopsional

    Mengingatkan Anda jika tidak ada yang membalas sampai tanggal ini (RFC 3339, YYYY-MM-DD, atau epoch ms).

  • labelstringopsional

    Label yang dipasang pada pesan terkirim. Menjadi labels: [label].

  • 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.

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_uid

    Id pesan terkirim. Langsung muncul di Sent.

  • thread_id

    Percakapan dari pesan baru.

  • message_id

    Message-ID sementara. Yang asli dari SMTP menggantikannya tidak lama kemudian.

  • recipients

    Berapa salinan yang masuk antrean (to + cc + bcc), masing-masing 1 kredit.

  • queued

    true = 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.

  • 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.

  • 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_TOADDRESS

    Alamat to bukan email yang valid.

  • CMDINVALID_CCADDRESS

    Salah satu alamat cc bukan email yang valid.

  • CMDINVALID_BCCADDRESS

    Salah satu alamat bcc bukan email yang valid.

  • CMDRECIPIENT_LIMIT_EXCEEDED

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

  • CMDINVALID_ATTACHMENT

    Konten lampiran bukan base64 yang valid.

  • 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.

  • CMDATTACHMENT_MISSING

    Lampiran yang diunggah sudah tidak ada (unggahan yang tidak dikirim dalam 48 jam, dan tidak dipakai oleh draf atau email terjadwal, akan dihapus). Unggah lagi.

  • CMDNO_CREDITS

    Akun memiliki kredit email lebih sedikit daripada jumlah penerima (1 kredit per salinan).

  • CMDSENDER_NOT_FOUND

    Pengirim di balik token tidak terdaftar.

  • CMDSENDER_NO_DOMAIN

    Pengirim di balik token tidak memiliki domain.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.