Menerima Email: Kirim & kepercayaan

Balas

Balas di dalam percakapan yang sama. Balasan disimpan di Terkirim dan INBOX, dan subjek menjadi Re: asli.

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

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

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 Anda balas.

  • htmlstringopsional

    Isi HTML. Kirim html atau text.

  • textstringopsional

    Isi teks biasa.

  • reply_allbooleanopsional

    Semua orang di To dan Cc pesan asli dimasukkan ke Cc, kecuali Anda dan orang yang Anda balas.

  • ccstring[]opsional

    Penerima tambahan di salinan.

  • bccstring[]opsional

    Penerima tambahan di salinan tersembunyi.

  • template_idstringopsional

    Isi body dari template.

  • attachmentsobject[]opsional

    File dalam base64, format sama seperti Kirim email.

  • compose_uidstringopsional

    Lampiran yang sudah diunggah sebelumnya dengan upload_attachment.

  • followup_atstringopsional

    Mengingatkan Anda jika tidak ada yang membalas sampai tanggal ini. Tanpa ini, pengingat yang sudah ada di percakapan dihapus (Anda baru saja membalas).

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

  • recipientstringopsional

    Hanya 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_uid

    Id balasan.

  • thread_id

    Percakapan yang sama dengan pesan asli.

  • message_id

    Message-ID sementara, digantikan oleh yang asli dari SMTP tidak lama kemudian.

  • queued

    true = 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' } },
  ]);
}
i

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.

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

    Penerima tidak ada atau bukan email yang valid.

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

  • CMDNO_RECIPIENT

    Percakapan tidak memiliki penerima untuk dibalas.

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

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