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.

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

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

i

Jika track_opens atau track_clicks dihilangkan, draf mempertahankan pilihan yang sudah ada. send_draft dan pengiriman terjadwal memakai pilihan itu.

i

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

Argumen

  • draft_idstringopsional

    Edit draf ini, bukan membuat draf baru.

  • modestringopsional

    new (default), reply, atau forward. Saat diedit, draf mempertahankan mode-nya.

  • idstringopsional

    Pesan asli, untuk reply dan forward. Subjek default-nya Re: / Fwd: asli.

  • tostring | string[]opsional

    Penerima, atau daftar hingga 30 untuk new (paket berbayar). Diabaikan untuk reply: dikirim ke pengirim pesan asli.

  • ccstring[]opsional

    Salinan terlihat.

  • bccstring[]opsional

    Salinan tersembunyi.

  • subjectstringopsional

    Subjek.

  • htmlstringopsional

    Isi HTML. Atau text, atau template_id.

  • textstringopsional

    Isi teks biasa, diubah menjadi HTML sederhana.

  • template_idstringopsional

    Isi body (dan subjek) dari template.

  • variablesobjectopsional

    Nilai untuk variabel template, misalnya { "first_name": "Ana" }.

  • followup_after_hoursnumber | nullopsional

    Mengingatkan Anda jika tidak ada yang membalas sekian jam setelah dikirim (hingga 8760). null menghapusnya.

  • attachmentsobject[]opsional

    File untuk dilampirkan: [{ file_name, content, content_type }], content dalam base64. Ditambahkan ke file yang sudah dimiliki draf.

  • compose_uidstringopsional

    File yang sudah diunggah sebelumnya dengan upload_attachment atau Unggah file besar.

  • attachment_idsstring[]opsional

    File unggahan mana yang dipakai. 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.

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_id

    Draf. Gunakan untuk mengedit, membaca, mengirim, atau menghapusnya. Berubah setiap kali disimpan.

  • thread_id

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

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

  • CMDINVALID_ARGS

    Argumen wajib tidak ada atau tidak valid.

  • CMDPAID_PLAN_REQUIRED

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

  • CMDTOO_MANY_RECIPIENTS

    `to` berisi lebih dari 30 alamat.

  • CMDDRAFT_NOT_FOUND

    Draf sudah tidak ada: sudah dikirim, dihapus, atau disimpan lagi (setiap penyimpanan mengembalikan draft_id baru).

  • CMDMISSING_TARGET

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

  • CMDINVALID_RECIPIENT

    Penerima tidak ada atau 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.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.