Menerima Email: Kirim & kepercayaan

Teruskan

Teruskan pesan ke orang lain. Lampiran asli ikut terkirim, dan email disimpan di percakapan yang sama di Terkirim.

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

Subjek menjadi Fwd: original dan blok Forwarded message berisi email asli ditambahkan di bawah teks Anda. Penerusan tidak menarik percakapan kembali ke Kotak Masuk.

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

  • idstringwajib

    message_uid dari pesan yang akan diteruskan.

  • tostringwajib

    Siapa yang menerima penerusan.

  • to_namestringopsional

    Nama penerima.

  • ccstring[]opsional

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

  • bccstring[]opsional

    Salinan tersembunyi.

  • htmlstringopsional

    Teks Anda di atas email yang diteruskan. Kirim html atau text.

  • textstringopsional

    Versi teks biasa dari catatan Anda.

  • include_attachmentsbooleanopsional

    Kirim lampiran asli. Default true.

  • quote_originalbooleanopsional

    Tambahkan blok Forwarded message. Default true.

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

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "forward",
        args: {
          id: "Vj0xQUJDMTIz",
          to: "finance@acme.com",
          html: "<p>Can you check this invoice?</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": "forward",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "message_uid": "Vj0xQUJDMTIz",
        "thread_id": "thr_9a1c4e72",
        "message_id": "5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90",
        "recipients": 1,
        "queued": true
      }
    }
  ]
}

Field respons

  • message_uid

    Id penerusan di Terkirim.

  • recipients

    Berapa salinan yang masuk antrean (masing-masing 1 kredit).

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.

  • CMDRECIPIENT_UNSUBSCRIBED

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

  • CMDINVALID_ARGS

    Argumen wajib tidak ada atau tidak valid.

  • CMDNOT_FOUND

    Pesan, percakapan, atau folder tidak ada untuk token ini.

  • CMDINVALID_RECIPIENT

    Penerima tidak ada atau bukan email yang valid.

  • CMDATTACHMENTS_TOO_LARGE

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

  • CMDFILE_BLOCKED

    Sebuah file diblokir oleh pemindaian keamanan.

  • CMDNO_CREDITS

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

  • CMDSENDER_NOT_FOUND

    Pengirim di balik token tidak terdaftar.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.