Menerima Email: Aturan

Buat aturan

Buat filter yang berjalan pada setiap email baru: cocokkan berdasarkan pengirim, domain, penyedia, subjek, isi, lampiran, waktu, dan lainnya, lalu pindahkan, beri label, tandai, tunda, atau balas.

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

Aturan baru ditaruh di akhir daftar. Aturan dijalankan berurutan; stop: true melewati aturan di bawahnya saat cocok.

!

Aturan tidak bisa mengeluarkan email dari Spam, memercayai atau memblokir pengirim, atau membalas otomatis kecuali domain From lolos SPF atau DKIM yang selaras (atau DMARC). Siapa pun bisa menulis From: boss@yourcompany.com; tanpa pemeriksaan ini, email itu akan melewati filter Anda atau memblokir atasan Anda.

Argumen

  • namestringwajib

    Hingga 80 karakter.

  • conditionsobject[]wajib

    [{ field, op, value, header? }]. 1 sampai 20 (termasuk pengecualian).

  • matchstringopsional

    all (default) atau any dari kondisi.

  • exceptobject[]opsional

    Jika salah satunya cocok, aturan tidak dijalankan.

  • actionsobject[]wajib

    [{ type, value? }]. 1 sampai 12. Hanya satu move.

  • stopbooleanopsional

    Jangan jalankan aturan di bawahnya saat aturan ini cocok.

  • enabledbooleanopsional

    Default true.

  • timezonestringopsional

    Nama IANA yang dipakai oleh received_hour, received_weekday, dan next_morning. Default UTC.

  • presetstringopsional

    Tag Anda sendiri untuk aturan yang dibuat dari template.

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "create_rule",
        args: {
          name: "Clients always in Inbox",
          match: "all",
          conditions: [
            {
              field: "from_domain",
              op: "in_list",
              value: "acme.com, globex.com"
            },
            {
              field: "provider",
              op: "is_any_of",
              value: [
                "microsoft_365",
                "google_workspace"
              ]
            }
          ],
          except: [
            {
              field: "subject",
              op: "contains",
              value: "newsletter"
            }
          ],
          actions: [
            {
              type: "keep_inbox"
            },
            {
              type: "label",
              value: "Clients"
            },
            {
              type: "star"
            }
          ],
          stop: false,
          timezone: "Asia/Kuala_Lumpur"
        }
      }
    ]
  },
  { 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": "create_rule",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "id": "Vj0xUlVMRTAx",
        "rule_id": "Vj0xUlVMRTAx",
        "name": "Clients always in Inbox",
        "match": "all",
        "conditions": [
          {
            "field": "from_domain",
            "op": "in_list",
            "value": "acme.com, globex.com"
          },
          {
            "field": "provider",
            "op": "is_any_of",
            "value": [
              "microsoft_365",
              "google_workspace"
            ]
          }
        ],
        "except": [
          {
            "field": "subject",
            "op": "contains",
            "value": "newsletter"
          }
        ],
        "actions": [
          {
            "type": "keep_inbox"
          },
          {
            "type": "label",
            "value": "Clients"
          },
          {
            "type": "star"
          }
        ],
        "stop": false,
        "timezone": "Asia/Kuala_Lumpur",
        "enabled": true,
        "position": 0,
        "hits": 128,
        "last_hit_at": "2026-10-25T09:12:44Z",
        "created_at": "2026-10-01T02:00:00Z",
        "updated_at": "2026-10-20T08:30:00Z"
      }
    }
  ]
}

Field dan operator

  • from / from_name / reply_to

    teks: contains, not_contains, is, is_not, starts_with, ends_with, regex, not_regex, in_list, not_in_list, is_empty, not_empty

  • from_domain

    domain: is (juga cocok dengan subdomain), is_not, in_list, not_in_list, contains, not_contains, ends_with, regex, not_regex

  • to / cc / recipient

    daftar alamat (recipient = to + cc). Operator sama seperti teks; cocok jika ada alamat yang cocok

  • subject / body / subject_or_body

    teks. Isi dibaca hingga 20.000 karakter pertama

  • attachment_name / attachment_type

    list. attachment_type adalah ekstensi: pdf, xlsx…

  • list_id

    teks. List-Id dari milis

  • header

    teks, dengan nama header di header (mis. x-mailer). Hanya diperiksa saat email tiba

  • provider

    is_any_of / is_none_of: google_workspace, gmail, microsoft_365, outlook, yahoo, icloud, zoho, proton, amazon_ses, sendgrid, mailgun, other

  • received_weekday

    is_any_of / is_none_of: sun, mon, tue, wed, thu, fri, sat (dalam zona waktu aturan)

  • received_hour

    gt, lt, between, not_between. 22-6 melewati tengah malam

  • size_kb

    gt, lt, between, not_between

  • has_attachment, is_mailing_list, is_reply, is_auto_reply, is_calendar_invite, authenticated, trusted_sender, first_time_sender, only_to_me

    is_true / is_false

Tindakan

  • move

    value: inbox, archive, spam, trash, promotions, atau custom:<folder-id>. Aturan pertama yang memindahkan yang menang

  • keep_inbox

    Selalu Kotak Masuk: tidak pernah Spam, penyaringan (Agents / NotSubscribing), atau Promotions

  • mark_read / star / important

    Flag. Bertambah di seluruh aturan

  • label

    value: nama label (1–50 karakter). Label bertambah di seluruh aturan

  • trust_sender / block_sender

    Menyimpan pengirim sebagai tepercaya atau diblokir untuk email berikutnya. block_sender juga memindahkan ke Spam

  • snooze

    value: jam (1 sampai 8760) atau next_morning (pukul 8:00 berikutnya di zona waktu aturan). Hanya untuk email yang tetap di Kotak Masuk

  • auto_reply

    value: id template. Satu balasan per pengirim setiap 24 jam

i

Jika beberapa aturan cocok: move pertama yang menang, label dan flag bertambah, dan block_sender mengesampingkan trust_sender.

Yang tidak bisa ditimpa oleh aturan

!

Aturan tidak bisa mengeluarkan email dari Spam, memercayai atau memblokir pengirim, atau membalas otomatis kecuali domain From lolos SPF atau DKIM yang selaras (atau DMARC). Siapa pun bisa menulis From: boss@yourcompany.com; tanpa pemeriksaan ini, email itu akan melewati filter Anda atau memblokir atasan Anda.

i

Label, dibaca, bintang, dan pemindahan ke Spam atau Sampah selalu berlaku. Laporan phishing, karantina DMARC, pengirim yang Anda blokir secara manual, dan list yang sudah Anda tinggalkan langganannya tetap menahan email di Spam apa pun kata aturannya.

i

provider berasal dari jalur pengiriman yang kami verifikasi: server yang terhubung ke kami (reverse DNS yang dikonfirmasi ke arah forward) dan SPF yang lolos melalui rentang milik penyedia itu sendiri. Record MX tidak pernah dipakai: siapa pun bisa mengarahkan MX ke Google dan mengirim dari servernya sendiri.

Nilai

in_list menerima list yang dipisahkan koma, titik koma, atau baris baru. Dalam daftar alamat, @acme.com cocok dengan siapa pun di domain itu. regex memakai RE2: tanpa lookahead, lookbehind, atau backreference, hingga 300 karakter. Perbandingan teks mengabaikan huruf besar/kecil.

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_ARGS

    Argumen wajib tidak ada atau tidak valid.

  • CMDINVALID_RULE

    Aturan tidak valid. Pesannya menyebutkan kondisi atau tindakan mana dan alasannya.

  • CMDLIMIT

    Kotak surat sudah mencapai batas (100 aturan, 200 template, atau 100 label).

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.