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.
https://g.sendcorex.com/v1command: create_ruleAturan 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
namestringwajibHingga 80 karakter.
conditionsobject[]wajib[{ field, op, value, header? }]. 1 sampai 20 (termasuk pengecualian).matchstringopsionalall(default) atauanydari kondisi.exceptobject[]opsionalJika salah satunya cocok, aturan tidak dijalankan.
actionsobject[]wajib[{ type, value? }]. 1 sampai 12. Hanya satumove.stopbooleanopsionalJangan jalankan aturan di bawahnya saat aturan ini cocok.
enabledbooleanopsionalDefault
true.timezonestringopsionalNama IANA yang dipakai oleh
received_hour,received_weekday, dannext_morning. Default UTC.presetstringopsionalTag 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_toteks: contains, not_contains, is, is_not, starts_with, ends_with, regex, not_regex, in_list, not_in_list, is_empty, not_empty
from_domaindomain: is (juga cocok dengan subdomain), is_not, in_list, not_in_list, contains, not_contains, ends_with, regex, not_regex
to / cc / recipientdaftar alamat (recipient = to + cc). Operator sama seperti teks; cocok jika ada alamat yang cocok
subject / body / subject_or_bodyteks. Isi dibaca hingga 20.000 karakter pertama
attachment_name / attachment_typelist. attachment_type adalah ekstensi: pdf, xlsx…
list_idteks. List-Id dari milis
headerteks, dengan nama header di
header(mis. x-mailer). Hanya diperiksa saat email tibaprovideris_any_of / is_none_of: google_workspace, gmail, microsoft_365, outlook, yahoo, icloud, zoho, proton, amazon_ses, sendgrid, mailgun, other
received_weekdayis_any_of / is_none_of: sun, mon, tue, wed, thu, fri, sat (dalam zona waktu aturan)
received_hourgt, lt, between, not_between.
22-6melewati tengah malamsize_kbgt, 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_meis_true / is_false
Tindakan
movevalue: inbox, archive, spam, trash, promotions, atau custom:<folder-id>. Aturan pertama yang memindahkan yang menang
keep_inboxSelalu Kotak Masuk: tidak pernah Spam, penyaringan (Agents / NotSubscribing), atau Promotions
mark_read / star / importantFlag. Bertambah di seluruh aturan
labelvalue: nama label (1–50 karakter). Label bertambah di seluruh aturan
trust_sender / block_senderMenyimpan pengirim sebagai tepercaya atau diblokir untuk email berikutnya. block_sender juga memindahkan ke Spam
snoozevalue: jam (1 sampai 8760) atau next_morning (pukul 8:00 berikutnya di zona waktu aturan). Hanya untuk email yang tetap di Kotak Masuk
auto_replyvalue: id template. Satu balasan per pengirim setiap 24 jam
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.
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.
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.
- 401
TOKEN_EXPIREDAccess token sudah kedaluwarsa. Panggil Refresh Token lalu ulangi request.
- 401
INVALID_TOKENToken salah format, tidak dikenal, atau dicabut.
- 429
RATE_LIMITEDLebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.
- CMD
INVALID_ARGSArgumen wajib tidak ada atau tidak valid.
- CMD
INVALID_RULEAturan tidak valid. Pesannya menyebutkan kondisi atau tindakan mana dan alasannya.
- CMD
LIMITKotak surat sudah mencapai batas (100 aturan, 200 template, atau 100 label).
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.